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
CLAUDE.md · 122 lines · 8.6 KBmarkdown
Blame HistoryOpen raw

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.

  1. 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, cles restent visibles du modèle), model en alias (opus,
    sonnet, haiku), puis la marque : enseigne (commandant, majeurs, batons,
    coupes, epees, deniers), rang (I…XXI pour un arcane majeur, as…roi
    pour une enseigne, absent pour le Commandant), carte (La Justice, As de Bâton),
    cartouche (arcanes majeurs et Commandant : carte en capitales, LA JUSTICE),
    epithet (le service : Pesée des Âmes), fonction, emoji. Claude Code ignore ces derniers champs ; check.sh
    tient le jeu.
  2. 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 de expedition).
  3. Un fichier lu par la carte : ${CLAUDE_PLUGIN_ROOT}/skills/<nom>/actions/…. La
    variable n'est remplacée que dans SKILL.md ; la ligne Racine dit à Claude ce
    qu'elle vaut dans les autres fichiers.
  4. Une nouvelle carte prend un emplacement libre ; une carte retirée en libère un —
    mettre à jour LIBRES dans scripts/check.sh, le tableau du README.md, et les
    decks qui la citent (plugins/ulk/ressources/decks.json, puis scripts/decks.py
    pour régénérer docs/decks.md).
    Renommer une carte : ajouter sa ligne à plugins/ulk/ressources/anciens-noms.md,
    corriger les renvois dans les packs plugins/tierces-* (et bumper chaque pack touché).
    docs/mesures/, docs/audits/, docs/parcours/ et les ADR passés gardent l'ancien nom.
    Toute carte hors bruce a une ligne dans plugins/ulk/skills/bruce/actions/29-table-routage.md (ou 37-table-routage-rare.md)
    et figure dans au moins un deck : check.sh l'exige.
  5. scripts/check.sh, puis bumper version dans plugins/ulk/.claude-plugin/plugin.json
    (check.sh échoue si un plugin change sans bump par rapport à origin/main). Après le
    push, poser le tag ulk-v<version> (ex. ulk-v1.0.10) sur un commit de main et le
    pousser : cela lance la release sur rickub. Le job échoue s'il manque le secret
    RICKUB_TOKEN, si le tag n'est pas sur main, ou si sa version diffère de plugin.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
    de communique passe 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 main par 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
# 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

```bash
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 :

```bash
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.

1. 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`, `cles` restent visibles du modèle), `model` en alias (`opus`,
   `sonnet`, `haiku`), puis la marque : `enseigne` (`commandant`, `majeurs`, `batons`,
   `coupes`, `epees`, `deniers`), `rang` (`I`…`XXI` pour un arcane majeur, `as`…`roi`
   pour une enseigne, absent pour le Commandant), `carte` (`La Justice`, `As de Bâton`),
   `cartouche` (arcanes majeurs et Commandant : `carte` en capitales, `LA JUSTICE`),
   `epithet` (le service : `Pesée des Âmes`), `fonction`, `emoji`. Claude Code ignore ces derniers champs ; `check.sh`
   tient le jeu.
2. 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 de `expedition`).
3. Un fichier lu par la carte : `${CLAUDE_PLUGIN_ROOT}/skills/<nom>/actions/…`. La
   variable n'est remplacée que dans `SKILL.md` ; la ligne **Racine** dit à Claude ce
   qu'elle vaut dans les autres fichiers.
4. Une nouvelle carte prend un emplacement libre ; une carte retirée en libère un —
   mettre à jour `LIBRES` dans `scripts/check.sh`, le tableau du `README.md`, et les
   decks qui la citent (`plugins/ulk/ressources/decks.json`, puis `scripts/decks.py`
   pour régénérer `docs/decks.md`).
   Renommer une carte : ajouter sa ligne à `plugins/ulk/ressources/anciens-noms.md`,
   corriger les renvois dans les packs `plugins/tierces-*` (et bumper chaque pack touché).
   `docs/mesures/`, `docs/audits/`, `docs/parcours/` et les ADR passés gardent l'ancien nom.
   Toute carte hors `bruce` a une ligne dans `plugins/ulk/skills/bruce/actions/29-table-routage.md` (ou `37-table-routage-rare.md`)
   et figure dans au moins un deck : `check.sh` l'exige.
5. `scripts/check.sh`, puis bumper `version` dans `plugins/ulk/.claude-plugin/plugin.json`
   (`check.sh` échoue si un plugin change sans bump par rapport à `origin/main`). Après le
   push, poser le tag `ulk-v<version>` (ex. `ulk-v1.0.10`) **sur un commit de `main`** et le
   pousser : cela lance la release sur rickub. Le job échoue s'il manque le secret
   `RICKUB_TOKEN`, si le tag n'est pas sur `main`, ou si sa version diffère de `plugin.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
  de `communique` passe 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 `main` par PR uniquement, fusionnée en squash : GitHub ajoute `(#<PR>)` au sujet.