CLAUDE.md
ulk : un marketplace Claude Code : le plugin ulk, six packs de skills tierces, un méta-plugin ulk-tierces qui les installe tous, et i-have-adhd. Aucun code applicatif, aucun build.
Deux dépôts : GitHub izo/ulk est le dépôt de dev, privé (issues, branches, PR).
rickub izo/ulk (https://rickub.com/izo/ulk) est le dépôt public : il ne porte
que les releases, publiées par scripts/release-rickub.sh à chaque tag ulk-v*
(docs/decisions.md § ADR-015). On ne pousse jamais à la main sur rickub.
Le site : https://ulk.regrets.app (dépôt izo/ulk-website). Il dérive d'ulk —
cartes, decks, outils, crédits, version — et rougit quand ulk bouge : ce qu'on change
ici se voit là-bas après sa resynchronisation. Ne rien y recopier à la main.
Règle zéro — charge cognitive
ulk est conçu pour un cerveau autiste, TDAH et fatigué — un PM senior. Elle
prime sur toute autre règle, et s'applique aussi au travail sur ce dépôt :
une seule voie · l'action d'abord · rien à mémoriser · littéral · interruptible.
Vérifier — une commande
scripts/check.sh
Manifestes (claude plugin validate), tests des mods — ligne d'état, table (claude plugin test), frontmatter de chaque skill, jeu de 78 emplacements,
decks, chemins ${CLAUDE_PLUGIN_ROOT}/… résolus, tailles (SKILL.md ≤ 500 lignes, description
visible du modèle ≤ 400 caractères, ≤ 160 pour une tierce, total d'ulk ≤ 1200). Vert avant chaque push. Aucun hook ;
la seule CI (.github/workflows/release-rickub.yml) publie sur rickub et ne vérifie rien :
check.sh reste le seul oracle.
Essayer le plugin sans l'installer :
claude --plugin-dir plugins/ulk
Arborescence
| Chemin | Quoi |
|---|---|
.claude-plugin/marketplace.json |
le marketplace ulk — liste les plugins |
plugins/ulk/skills/<nom>/SKILL.md |
une carte = une skill ; /ulk:<nom> |
plugins/ulk/skills/<nom>/actions/ |
les fichiers que la carte lit à la demande |
plugins/ulk/ressources/voix.md |
la voix d'ulk — toutes les cartes la lisent |
plugins/ulk/ressources/anciens-noms.md |
noms d'avant la 2.0.0 → noms actuels ; lu par Bruce |
plugins/ulk/ressources/decks.json |
les decks : une sélection de cartes par type de projet |
docs/decks.md |
les decks en Markdown, générés par scripts/decks.py |
scripts/release-rickub.sh |
publie un tag ulk-v* sur rickub : commit-instantané sans .github/, tag, release ; DRY_RUN=1 pour essayer · docs/decisions.md § ADR-015 |
.github/workflows/release-rickub.yml |
lance ce script au push d'un tag ulk-v* ; secret GitHub RICKUB_TOKEN |
docs/decisions.md |
les décisions (ADR) |
docs/mesures/ |
mesures par issue (banc de routage #101, orchestration #122…) |
docs/mesures/issue-118/ |
le Duel : agent seul contre ulk, banc rejouable (python3 duel.py <étiquette>, README.md du dossier) |
docs/audits/ |
rapports d'audit datés (inspection) |
docs/images/cartes.webp |
bannière du README.md : six cartes tirées du site (CC BY-SA 4.0, crédit en fin de README) |
plugins/ulk/ressources/protocoles/ |
protocoles partagés, lus à la demande |
plugins/ulk/ressources/apple/catalogue-macos.md |
composants natifs macOS SwiftUI et AppKit, versions vérifiées ; lu par section par jony, isaac (action 18), woz |
plugins/ulk/skills/outils/, cles/ |
outils manquants · clés API |
plugins/ulk/skills/renovation/scripts/ |
scripts de preuve vendorisés (Apache-2.0, NOTICE.md) ; tests : pipx run pytest -q tests depuis ce dossier, 4 sautés (mermaid absent) · docs/decisions.md § ADR-006 |
skills sans model: (5) |
agent-optimizer, cles, cli-productivity, maquette-video, outils — pas de champ model: |
plugins/tierces-{apple,flutter,design,obsidian,spip,outils}/skills/ |
skills tierces vendorisées en six packs, chacune avec sa licence, plus quelques skills écrites pour ulk (listées dans le THIRD_PARTY_NOTICES.md de chaque pack) · docs/decisions.md § ADR-007 |
plugins/tierces-outils/skills/filo-{flow,page}/ |
filo (#149) : entretien de parcours avant le code, puis une page. Amont en bêta (marco-bertelli/filo) ; commit vendorisé et changements locaux dans THIRD_PARTY_NOTICES.md du pack |
plugins/tierces-apple/ressources/hig/ |
moteur hig.py des skills hig-* et index de la structure des HIG, sans leur texte ; tests : python3 test_hig.py ; index régénéré par scripts/hig_index.py <vault> · docs/decisions.md § ADR-012 |
plugins/ulk-tierces/ |
méta-plugin sans skill : dependencies vers les six packs |
plugins/ulk/ressources/outils/packs-tierces.md |
pack → contenu → signaux ; lu par Bruce (action 38) pour proposer le pack utile |
plugins/i-have-adhd/ |
plugin vendorisé, ruleset ADHD ; vérifié par sha256 dans check.sh |
Écrire ou modifier une carte
Une carte = une skill = un agent. Vocabulaire et raisons : docs/decisions.md § ADR-003.
Nom d'une carte : un service d'une administration occulte (Pesée des Âmes), dit en un mot
pour la commande (pesee) ; les prénoms (bruce, isaac, jony, woz, jake, matias,
peon, tim, happy) ne se renomment pas — § ADR-013.
- Frontmatter :
name(= dossier ; un mot courant sans accent, le service en un mot :pesee,presages—docs/decisions.md§ ADR-013),description(la fonction d'abord,— Carte <carte>.à la fin —— Carte VIII, La Justice.pour un arcane majeur, ≤ 1024 caractères, sans<ni>),
disable-model-invocation: true(la carte passe par Bruce ou/ulk:<nom>; seules
bruce,outils,clesrestent visibles du modèle),modelen alias (opus,
sonnet,haiku), puis la marque :enseigne(commandant,majeurs,batons,
coupes,epees,deniers),rang(I…XXIpour un arcane majeur,as…roi
pour une enseigne, absent pour le Commandant),carte(La Justice,As de Bâton),
cartouche(arcanes majeurs et Commandant :carteen capitales,LA JUSTICE),
epithet(le service :Pesée des Âmes),fonction,emoji. Claude Code ignore ces derniers champs ;check.sh
tient le jeu. - En tête du corps : la ligne En-tête (
VIII · LA JUSTICE — pesee,
As de Bâton — fonderie), la ligne Voix,
la ligne Racine — copier celles d'une carte voisine. Une carte qui déploie, publie ou
supprime ajoute la ligne Geste grave : la commande exacte, confirmée, lancée une fois
(copier celle deexpedition). - Un fichier lu par la carte :
${CLAUDE_PLUGIN_ROOT}/skills/<nom>/actions/…. La
variable n'est remplacée que dansSKILL.md; la ligne Racine dit à Claude ce
qu'elle vaut dans les autres fichiers. - Une nouvelle carte prend un emplacement libre ; une carte retirée en libère un —
mettre à jourLIBRESdansscripts/check.sh, le tableau duREADME.md, et les
decks qui la citent (plugins/ulk/ressources/decks.json, puisscripts/decks.py
pour régénérerdocs/decks.md).
Renommer une carte : ajouter sa ligne àplugins/ulk/ressources/anciens-noms.md,
corriger les renvois dans les packsplugins/tierces-*(et bumper chaque pack touché).
docs/mesures/,docs/audits/,docs/parcours/et les ADR passés gardent l'ancien nom.
Toute carte horsbrucea une ligne dansplugins/ulk/skills/bruce/actions/29-table-routage.md(ou37-table-routage-rare.md)
et figure dans au moins un deck :check.shl'exige. scripts/check.sh, puis bumperversiondansplugins/ulk/.claude-plugin/plugin.json
(check.shéchoue si un plugin change sans bump par rapport àorigin/main). Après le
push, poser le tagulk-v<version>(ex.ulk-v1.0.10) sur un commit demainet le
pousser : cela lance la release sur rickub. Le job échoue s'il manque le secret
RICKUB_TOKEN, si le tag n'est pas surmain, ou si sa version diffère deplugin.json.
Les tags des packs (tierces-*-v*) restent sur GitHub ; un pack bumpé sans bump d'ulk
n'atteint rickub qu'à la release suivante d'ulk.
Issues, branches, commits
Sur ce dépôt : https://github.com/izo/ulk/issues.
-
Linear est abandonné : ne plus ouvrir, alimenter ni consulter de fiche Linear, ni s'en servir
pour le suivi. Le plugin n'en porte plus aucun outil (retiré en #132) ; la synchro
decommuniquepasse par GitHub. -
Branche :
wt/issue-<N>-<sujet>, une par issue, dans son worktree. -
Sujet de commit en français, sans préfixe de type :
<Chantier> #<N> : <ce qui change>
(Refonte #2 : 5 protocoles orphelins supprimés). -
Vers
mainpar PR uniquement, fusionnée en squash : GitHub ajoute(#<PR>)au sujet.
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 |
|