izo/ulkpublic Fork
⑂ main
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 main · ulk · 3h ago
README.md

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.