| name | arrange |
| description | Use when asked to arrange/classer/ranger les monographies du scriptorium par domaine, (re)définir ou réévaluer la taxonomie de la home GitHub Pages, classer un nouveau thème, ou rééquilibrer les domaines. Maintient tools/taxonomy.json (seule source de vérité), lu par tools/build_site.py. Triggered by /arrange. |
arrange — agencement des monographies par domaine
Seul responsable de tools/taxonomy.json (source de vérité de la taxonomie ; cf.
docs/superpowers/specs/2026-06-12-taxonomy-domains-design.md). build_site.py la lit ;
monograph/frugalmonograph n'y touchent jamais.
Frontière jugement / code : TU juges (classer, diagnostiquer, proposer) ; l'écriture du
fichier + build_site.py sont déterministes. Ne modifie QUE tools/taxonomy.json.
Déroulé
- Lire l'état :
tools/taxonomy.json s'il existe (sinon = premier amorçage : tout est « à classer »).- Thèmes publiés = dossiers ayant un
themes/<slug>/dist/*.html. Exclure le legacy
automatic-prompt-optimization (hors taxonomie, rendu en dernier).
- Pour chaque thème, lire le contexte :
<title> du dist + themes/<slug>/knowledge.json
(champ theme, et au besoin la nature des claims) pour juger son sujet.
- Repérer les nouveaux : thèmes publiés absents de toute liste
themes (ils sortiront du
bucket « À classer » de la home une fois rangés).
- Diagnostiquer (signaux, pas règles dures) :
- domaine sur-peuplé (cohérence interne faible → candidat à scission) ;
- domaine sous-peuplé (1-2 thèmes → fusionner ou nourrir ?) ;
- thème dont le sujet colle mieux à un autre domaine (candidat déplacement) ;
- orphelins (aucun domaine naturel).
- PROPOSER un plan explicite : pour chaque nouveau thème, le domaine cible + 1 phrase de
justification ; pour chaque ajustement (déplacement / fusion / scission / renommage /
réordonnancement), la raison. Présenter à l'utilisateur et attendre sa validation.
Ne rien écrire avant le feu vert.
- Écrire
tools/taxonomy.json (mêmes clés : version, domains[] ordonné avec
id/label/blurb/themes). Conserver l'ordre validé. Un thème = un seul domaine.
- Régénérer + vérifier :
python3 tools/build_site.py (doit sortir 0, sans bucket
« À classer » résiduel pour les thèmes qu'on vient de classer) ; rapporter le résultat.
Garde-fous
tools/build_site.py valide les invariants (slug sans dist, slug en double, domaine vide,
fichier manquant) et échoue bruyamment : si le run de l'étape 6 échoue, corriger
taxonomy.json, ne pas contourner.- Ne JAMAIS classer le legacy
automatic-prompt-optimization dans un domaine.
- Publication : committer/pousser
tools/taxonomy.json re-déploie le site public — laisser le
push au feu vert de l'utilisateur (cf. pages-publication).
