izo/ulkpublic Fork
⑂ ulk-v2.0.2
Commits
⬇ Clone ▾
git clone https://git.rickub.com/izo/ulk.git
git clone ssh://git@rickub.com/izo/ulk.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Download ZIP
ulk 2.0.2 16b1e25 · on ulk-v2.0.2 · ulk · 3h ago
README.md · 283 lines · 18.1 KBmarkdown
Blame HistoryOpen raw

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.

  1. Install, in a terminal:

    claude plugin marketplace add https://git.rickub.com/izo/ulk.git
    claude plugin install ulk@ulk
    
  2. 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

  1. /ulk:bruce — toujours le premier geste. Bruce lit l'état du projet et donne
    la carte suivante. Aucun nom de carte à retenir.
  2. Une carte s'appelle aussi directement : /ulk:<nom>. Demandée en clair
    (« vérifie cette issue »), elle passe par Bruce, qui appelle pesee : les cartes
    sont cachées au modèle, seule la description de Bruce lui est envoyée.
  3. Il manque un outil ou une skill : /ulk:outils <nom> donne la commande.
  4. Il faut une clé API : /ulk:cles <nom> — 1Password (op), ou trousseau macOS.
  5. Trop de skills installées : /ulk:ecritures skills les mesure (lancements réels sur
    60 jours) et les trie avec toi, une question à la fois.
  6. Une séance a marché : « fais-en une skill » — /tierces-outils:skill-manager new la tire
    de la session ; learn <nom> lui ajoute une ligne après une correction.
  7. Une fonctionnalité à concevoir : /tierces-outils:filo-flow — un entretien, une
    question à la fois, avant le code ; le parcours décidé est dessiné, puis enregistré
    dans product/flows/<nom>.md. /tierces-outils:filo-page le 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
# ulk

![Six cartes du jeu ulk : le Commandant, VIII La Justice, et les as des quatre enseignes](docs/images/cartes.webp)

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](https://ulk.regrets.app/parcours/) | trouver sa situation et la phrase à écrire à Claude Code |
| [ulk.regrets.app/arcanes](https://ulk.regrets.app/arcanes/) | les 78 cartes |
| [ulk.regrets.app/decks](https://ulk.regrets.app/decks/) | les decks |
| [ulk.regrets.app/installer](https://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>.

1. Install, in a terminal:

   ```
   claude plugin marketplace add https://git.rickub.com/izo/ulk.git
   claude plugin install ulk@ulk
   ```

2. 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

1. **`/ulk:bruce`** — toujours le premier geste. Bruce lit l'état du projet et donne
   la carte suivante. Aucun nom de carte à retenir.
2. Une carte s'appelle aussi directement : `/ulk:<nom>`. Demandée en clair
   (« vérifie cette issue »), elle passe par Bruce, qui appelle `pesee` : les cartes
   sont cachées au modèle, seule la description de Bruce lui est envoyée.
3. Il manque un outil ou une skill : `/ulk:outils <nom>` donne la commande.
4. Il faut une clé API : `/ulk:cles <nom>` — 1Password (`op`), ou trousseau macOS.
5. Trop de skills installées : `/ulk:ecritures skills` les mesure (lancements réels sur
   60 jours) et les trie avec toi, une question à la fois.
6. Une séance a marché : « fais-en une skill » — `/tierces-outils:skill-manager new` la tire
   de la session ; `learn <nom>` lui ajoute une ligne après une correction.
7. Une fonctionnalité à concevoir : `/tierces-outils:filo-flow` — un entretien, une
   question à la fois, avant le code ; le parcours décidé est dessiné, puis enregistré
   dans `product/flows/<nom>.md`. `/tierces-outils:filo-page` le 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](https://creativecommons.org/licenses/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.