ulk

Un jeu de cartes d'agents pour Claude Code. Chaque carte est un agent (une skill) ;
le Commandant (bruce) oriente, les cartes font. Chaque carte porte le nom d'un
service : pesee (Pesée des Âmes) contrôle le travail, objets-trouves inventorie
les restes d'un dépôt. Un deck rassemble les cartes utiles à un type de projet.
Les cartes ont été renommées en 2.0.0 : donner un ancien nom à Bruce suffit, il retrouve la carte.
Le site : https://ulk.regrets.app — tout le jeu, carte par carte, et ce qu'on en fait :
| Page | Pour |
|---|---|
| ulk.regrets.app/parcours | trouver sa situation et la phrase à écrire à Claude Code |
| ulk.regrets.app/arcanes | les 78 cartes |
| ulk.regrets.app/decks | les decks |
| ulk.regrets.app/installer | installer, pas à pas |
Installer
Dans un terminal :
claude plugin marketplace add https://git.rickub.com/izo/ulk.git
claude plugin install ulk@ulk
Puis redémarrer Claude Code et taper /ulk:bruce.
Option — les skills tierces que des cartes savent utiliser (anti-slop, HIG Apple,
Swift, accessibilité…). Rien à retenir : Bruce repère le type du projet et propose le
pack qui manque, avec la commande exacte. Pour tout installer d'un coup :
claude plugin install ulk-tierces@ulk
Pour choisir, un pack à la fois :
| Pack | Pour |
|---|---|
tierces-apple |
Swift, SwiftUI, HIG, StoreKit, CloudKit, WidgetKit, parcours utilisateur exploratoire, nettoyage disque Mac |
tierces-flutter |
Flutter, Dart, sécurité mobile |
tierces-design |
anti-slop, UX, web design, RAWeb, RAAM, SEO |
tierces-obsidian |
Obsidian, Canvas, defuddle |
tierces-spip |
SPIP, migration vers Astro |
tierces-outils |
handoff, merge, ponytail, token-efficient, diagrammes, filo (parcours avant le code) |
claude plugin install tierces-apple@ulk
Une skill tierce s'appelle /<pack>:<skill> (/tierces-apple:hig-ask) ; tape /hig dans le menu pour la filtrer.
Option — sortie ADHD-friendly (action d'abord, étapes numérotées ; copie vendorisée
d'ayghri/i-have-adhd, MIT) :
claude plugin install i-have-adhd@ulk
Mettre à jour : claude plugin update ulk@ulk. Depuis la 2.0.0 les cartes ont un nouveau
nom ; l'ancien, donné à Bruce, mène à la carte (table : plugins/ulk/ressources/anciens-noms.md). Retirer : claude plugin uninstall ulk@ulk.
Si tu avais ulk-tierces en 1.x : claude plugin update ulk-tierces@ulk, puis relance
claude plugin install ulk-tierces@ulk jusqu'à ce que « + 1 dependency » n'apparaisse
plus (un pack par passage, six au plus). Une installation neuve tire les six d'un coup.
In English
ulk is a deck of agent cards for Claude Code. Each card is an agent (a skill).
The Commander (bruce) reads your project and tells you which card to play next.
A deck groups the cards that fit a kind of project. Website: https://ulk.regrets.app.
-
Install, in a terminal:
claude plugin marketplace add https://git.rickub.com/izo/ulk.git claude plugin install ulk@ulk -
Restart Claude Code, then type
/ulk:bruce. You don't need to remember any card name.
Cards answer in French. Optional plugins: ulk-tierces (third-party skills in six packs — Bruce suggests the one your project needs — each
under its own license) and i-have-adhd (ADHD-friendly output). License: MIT.
Hooks
Le plugin ulk pose trois hooks : session-persist garde un instantané de la session et suggest-compact mesure le contexte, tous deux sous ~/.claude/state/ ; worktree-guard signale les sessions concurrentes et n'écrit que dans .ulk/ du dépôt (auto-ignoré) — rien d'autre n'est écrit dans tes projets.
Trace de fin de session (désactivée par défaut) : /ulk:journal activer <chemin du vault> fait écrire par session-persist une note par session dans <vault>/ulk/sessions/<projet>/, lue par un agent comme Hermes. /ulk:journal y ajoute le résumé rédigé ; /ulk:journal couper l'éteint. Décision : docs/decisions.md § ADR-002.
Se servir du jeu
/ulk:bruce— toujours le premier geste. Bruce lit l'état du projet et donne
la carte suivante. Aucun nom de carte à retenir.- Une carte s'appelle aussi directement :
/ulk:<nom>. Demandée en clair
(« vérifie cette issue »), elle passe par Bruce, qui appellepesee: les cartes
sont cachées au modèle, seule la description de Bruce lui est envoyée. - Il manque un outil ou une skill :
/ulk:outils <nom>donne la commande. - Il faut une clé API :
/ulk:cles <nom>— 1Password (op), ou trousseau macOS. - Trop de skills installées :
/ulk:ecritures skillsles mesure (lancements réels sur
60 jours) et les trie avec toi, une question à la fois. - Une séance a marché : « fais-en une skill » —
/tierces-outils:skill-manager newla tire
de la session ;learn <nom>lui ajoute une ligne après une correction. - Une fonctionnalité à concevoir :
/tierces-outils:filo-flow— un entretien, une
question à la fois, avant le code ; le parcours décidé est dessiné, puis enregistré
dansproduct/flows/<nom>.md./tierces-outils:filo-pagele redessine.
Le jeu
78 emplacements, sur le modèle du Tarot de Marseille : le Commandant, 21 arcanes
majeurs, 4 enseignes de 14 rangs. Chaque enseigne porte un verbe du cycle de
développement. Le nom de la carte (As de Bâton) est l'en-tête de chaque sortie.
Les 78 emplacements sont occupés ; une carte retirée
laisserait un emplacement libre, montré, pas caché. Chaque carte, avec son
illustration : https://ulk.regrets.app/arcanes/.
Chaque carte est un service d'une administration occulte : un service connu de tous,
plus une matière magique. La commande est ce service en un mot courant, sans accent.
Les prénoms (bruce, isaac, jony, woz, jake, matias, peon, tim, happy)
ne suivent pas cette règle. Décision : docs/decisions.md § ADR-013.
Le Commandant et les arcanes majeurs
| Carte | Commande | Service | Fonction |
|---|---|---|---|
| Commandant | /ulk:bruce |
— | point d'entrée et routage |
| I · Le Bateleur | /ulk:presages |
Bureau des Présages | diagnostic d'état du projet |
| II · La Papesse | /ulk:archives |
Archives des Mémoires | mémoire de projet dans Obsidian |
| III · L'Impératrice | /ulk:cap |
Bureau du Cap | direction produit et feuille de route |
| IIII · L'Empereur | /ulk:fondations |
Bureau des Fondations | choix de stack et architecture |
| V · Le Pape | /ulk:grimoire |
Greffe des Grimoires | spec, todo et documentation projet |
| VI · L'Amoureux | /ulk:magasin |
Magasin des Pièces | choix d'une bibliothèque UI |
| VII · Le Chariot | /ulk:chaine |
Chaîne de Montage | enchaînement d'agents en une passe |
| VIII · La Justice | /ulk:pesee |
Pesée des Âmes | contrôleur du SDLC ulk |
| VIIII · L'Hermite | /ulk:songes |
Bureau des Songes | génération de backlog en autonomie |
| X · La Roue de Fortune | /ulk:pointeuse |
Pointeuse des Rites | conversion d'un agent en routine planifiée |
| XI · La Force | /ulk:tribunal |
Tribunal | revue adversariale à plusieurs voix |
| XII · Le Pendu | /ulk:objection |
Bureau des Objections | contradiction et due diligence |
| XIII · Arcane XIII | /ulk:objets-trouves |
Objets trouvés | inventaire des restes d'un dépôt |
| XIIII · Tempérance | /ulk:distillerie |
Distillerie | mesure et réduction de la complexité |
| XV · Le Diable | /ulk:scelles |
Bureau des Scellés | audit de sécurité applicative |
| XVI · La Maison Dieu | /ulk:depannage |
Dépannage des Sortilèges | correction d'erreurs et d'échecs CI |
| XVII · L'Étoile | /ulk:nuancier |
Bureau du Nuancier | revue du design system |
| XVIII · La Lune | /ulk:nuit |
Équipe de Nuit | exécution autonome d'une tâche longue |
| XVIIII · Le Soleil | /ulk:atelier |
Atelier du Grand Œuvre | exécutant du SDLC ulk |
| XX · Le Jugement | /ulk:inspection |
Inspection générale | audit technique, dix axes |
| XXI · Le Monde | /ulk:visa |
Visa de Sortie | release complète de bout en bout |
Bâtons — construire
| Carte | Commande | Service | Fonction |
|---|---|---|---|
| As de Bâton | /ulk:fonderie |
Fonderie des Formes | création d'un design system |
| Deux de Bâton | /ulk:imprimerie |
Imprimerie | interfaces web éditoriales |
| Trois de Bâton | /ulk:facades |
Inspection des Façades | audit du frontend et des parcours |
| Quatre de Bâton | /ulk:reflets |
Bureau des Reflets | audit visuel d'une page en ligne |
| Cinq de Bâton | /ulk:happy |
— | conception d'API et backend |
| Six de Bâton | /ulk:tim |
— | monétisation d'une application mobile ou web |
| Sept de Bâton | /ulk:vitrine |
Vitrine | optimisation de la fiche boutique |
| Huit de Bâton | /ulk:rampe |
Rampe de Lancement | lancement d'une application mobile |
| Neuf de Bâton | /ulk:woz |
— | audit SwiftUI contre la guidance Apple |
| Dix de Bâton | /ulk:projection |
Cabine de Projection | vidéo de démo d'un produit |
| Valet de Bâton | /ulk:moule |
Atelier de Moulage | maquette convertie en composants |
| Cavalier de Bâton | /ulk:chantier-android |
Chantier Android | starter kit Android, Kotlin ou Flutter |
| Reine de Bâton | /ulk:jony |
— | design system macOS et iOS |
| Roi de Bâton | /ulk:isaac |
— | starter kit Swift et SwiftUI |
Coupes — accueillir
| Carte | Commande | Service | Fonction |
|---|---|---|---|
| As de Coupe | /ulk:guichet |
Guichet des Identités | vérification du contexte de travail |
| Deux de Coupe | /ulk:reliure |
Atelier de Reliure | réparation de la documentation |
| Trois de Coupe | /ulk:compteurs |
Relevé des Compteurs | détection des capacités du projet |
| Quatre de Coupe | /ulk:dechiffrage |
Bureau du Déchiffrage | documentation reconstituée d'un code existant |
| Cinq de Coupe | /ulk:calque |
Bureau des Calques | design system extrait d'une maquette |
| Six de Coupe | /ulk:matias |
— | design system Android en Material 3 |
| Sept de Coupe | /ulk:navette |
— | synchronisation avec Notion |
| Huit de Coupe | /ulk:communique |
Communiqués | communication des changements produit |
| Neuf de Coupe | /ulk:passerelle |
Passerelle des Maquettes | suivi des fichiers Claude Design |
| Dix de Coupe | /ulk:ecritures |
Vérification des Écritures | audit du contexte écrit |
| Valet de Coupe | /ulk:standard |
Standard des Doléances | tri et réponse aux tickets |
| Cavalier de Coupe | /ulk:migration-spip |
Migration SPIP | migration de contenu SPIP vers Astro |
| Reine de Coupe | /ulk:ecluse |
Écluse du Contexte | hygiène du contexte de session |
| Roi de Coupe | /ulk:peon |
— | clôture de séance et commit |
Épées — trancher
| Carte | Commande | Service | Fonction |
|---|---|---|---|
| As d'Épée | /ulk:cadastre |
Cadastre | cartographie d'un projet par stack |
| Deux d'Épée | /ulk:deminage |
Déminage | détection des valeurs en dur |
| Trois d'Épée | /ulk:transplantation |
Transplantations | extraction et transplantation de modules |
| Quatre d'Épée | /ulk:humeurs |
Bureau des Humeurs | audit des dynamiques humaines du code |
| Cinq d'Épée | /ulk:ages |
Bureau des Âges | expérience comparée par génération |
| Six d'Épée | /ulk:formules |
Bureau des Formules | microcopy et parcours utilisateur |
| Sept d'Épée | /ulk:recidives |
Registre des Récidives | détection des échecs récurrents |
| Huit d'Épée | /ulk:conforme |
Copie conforme | tests de non-régression visuelle |
| Neuf d'Épée | /ulk:sondages |
Bureau des Sondages | analyse de données d'enquête |
| Dix d'Épée | /ulk:lutherie |
Lutherie | conseil sur projets music-tech |
| Valet d'Épée | /ulk:essai |
Banc d'Essai | tests unitaires et couverture |
| Cavalier d'Épée | /ulk:traversee |
Épreuve de la Traversée | tests de bout en bout |
| Reine d'Épée | /ulk:acces |
Accès pour Tous | audit d'accessibilité WCAG |
| Roi d'Épée | /ulk:contre-visite |
Contre-Visite | revue de code notée à deux |
Deniers — livrer
| Carte | Commande | Service | Fonction |
|---|---|---|---|
| As de Denier | /ulk:tresor |
Trésorerie | coûts d'hébergement et de tokens |
| Deux de Denier | /ulk:chantier-web |
Chantier Web | starter kit web, Astro, Next ou Nuxt |
| Trois de Denier | /ulk:annonces |
Bureau des Annonces | référencement du site, SEO et GEO |
| Quatre de Denier | /ulk:renovation |
Rénovation | modernisation d'un code hérité, de l'état des lieux à la preuve |
| Cinq de Denier | /ulk:resiliation |
Service des Résiliations | audit des skills installées |
| Six de Denier | /ulk:radiation |
Guichet des Radiations | retrait confirmé de skills, une à la fois |
| Sept de Denier | /ulk:constat |
Constat | état des lieux avant livraison |
| Huit de Denier | /ulk:jake |
— | audit Android contre la guidance Google |
| Neuf de Denier | /ulk:automates |
Salle des Automates | parcours joués sur appareil Android |
| Dix de Denier | /ulk:journal |
Journal de Bord | trace de session vers le vault |
| Valet de Denier | /ulk:conduits |
Entretien des Conduits | réparation automatique de la CI |
| Cavalier de Denier | /ulk:convoyeur |
Convoyeur | boucle de l'issue à la PR |
| Reine de Denier | /ulk:machines |
Salle des Machines | administration d'un serveur |
| Roi de Denier | /ulk:expedition |
Expéditions | déploiement chez l'hébergeur du projet |
Les decks
Un deck = les cartes utiles à un type de projet, dans l'ordre où elles servent.
Le Commandant ouvre chaque deck. Source : plugins/ulk/ressources/decks.json
(lue aussi par le site : https://ulk.regrets.app/decks/). Le détail, avec le rôle de chaque carte :
docs/decks.md.
| Deck | Pour | Cartes |
|---|---|---|
socle — Socle |
tout projet : le cycle issue → code → contrôle → commit | bruce, presages, guichet, ecluse, grimoire, atelier, pesee, depannage, peon |
nouveau-projet — Nouveau projet |
un dépôt vide ou une idée à cadrer | bruce, cap, objection, fondations, grimoire, songes, atelier, pesee |
reprise-code-existant — Reprise d'un code existant |
un dépôt hérité, mal connu ou sans documentation | bruce, renovation, inspection, cadastre, dechiffrage, essai, objets-trouves, transplantation, distillerie, humeurs, deminage |
site-web — Site web |
un site ou une application web (Astro, Next, Nuxt…) | bruce, fondations, happy, chantier-web, magasin, imprimerie, nuancier, moule, facades, acces, essai, traversee, conforme, reflets, tim, annonces, constat, expedition |
api-backend — API et backend |
un service, une API, un serveur | bruce, fondations, happy, essai, scelles, deminage, expedition, machines, tresor |
app-apple — App iOS et macOS |
une application Swift et SwiftUI (pack tierces-apple : HIG, parcours exploratoire promeneuse) |
bruce, happy, isaac, jony, woz, acces, tim, vitrine, rampe |
app-android — App Android |
une application Kotlin ou Flutter | bruce, happy, matias, chantier-android, jake, automates, acces, tim, vitrine, rampe |
design-system — Design system |
créer, extraire ou tenir un design system | bruce, calque, fonderie, moule, passerelle, nuancier, acces, conforme |
release — Release |
livrer une version en production | bruce, constat, tribunal, contre-visite, conduits, visa, communique |
autonomie — Autonomie |
laisser tourner des agents sans surveillance | bruce, songes, convoyeur, nuit, chaine, pointeuse, recidives, journal |
produit — Produit et contenu |
le travail de PM : cadrer, écrire, écouter les utilisateurs | bruce, cap, objection, sondages, formules, ages, standard, communique, navette, archives |
migration-spip-astro — Migration SPIP vers Astro |
un site SPIP à passer sous Astro | bruce, cadastre, migration-spip, imprimerie, conforme, expedition |
poste-de-travail — Poste de travail |
le poste du développeur : outils manquants, secrets, CLI macOS | bruce, outils, cles, cli-productivity |
contexte-agents — Contexte et agents |
tenir propre ce que les agents lisent : CLAUDE.md, docs, instructions, mémoire | bruce, compteurs, ecritures, reliure, agent-optimizer, recidives, ecluse |
maquette-claude-design — Maquette Claude Design |
un export Claude Design à lire, coder ou filmer | bruce, maquette-inventaire, passerelle, maquette-video, projection |
music-tech — Music-tech |
une plateforme musicale : Laravel, IA, API musicales | bruce, cap, lutherie, cadastre |
Pourquoi ce format
- Un plugin Claude Code, rien d'autre : pas de binaire, pas d'installateur. Claude
Code installe, met à jour et retire. - Le jeu de cartes est la voix de marque, le framework est le fond. Carte,
deck, arcane, enseigne, service habillent ; la fonction est toujours écrite à côté, et le contenu de
chaque sortie est littéral (plugins/ulk/ressources/voix.md,docs/decisions.md
§ ADR-003, § ADR-013). - Conçu pour un cerveau autiste, TDAH et fatigué : une seule voie, l'action
d'abord, rien à mémoriser, littéral, interruptible.
Mesure
docs/mesures/issue-118/ : le Duel. Le même cahier des charges, construit par l'agent
seul et par ulk ; coût, durée, recette et jugement à l'aveugle. Banc rejouable
(python3 duel.py <étiquette>), mode d'emploi dans le README.md du dossier. Seules les pages de
synthèse de chaque passage sont versionnées (duel.html, telemetrie.json) ;
les fichiers bruts restent sur la machine qui a joué le banc.
Licence
MIT (LICENSE). Les skills de plugins/tierces-*/ gardent chacune la licence
de leur auteur (THIRD_PARTY_NOTICES.md et le fichier LICENSE de chaque skill).
L'image en tête de ce fichier reprend six cartes du site. Les illustrations
viennent du Tarocchino Arlecchino d'Yve Lepkowski (Stolen Thyme,
https://stolen-thyme.com/downloads/), sous licence
CC BY-SA 4.0. Modifications :
recadrées, tirées en trois encres façon risographie, posées sur papier crème et
assemblées en bannière. L'image reste sous CC BY-SA 4.0.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 |
|