Design system boss
Un routeur. Il lit l'application, choisit un playbook, copie ses étapes mot pour mot dans .design-system/state.md, et les exécute. Une étape que vous abandonnez reste dans la liste sous la forme skipped (<raison>). Les mots et les goûts par défaut sont dans build-design-system/references/glossary.md et build-design-system/references/taste.md. Les mots de la personne, AGENTS.md, CLAUDE.md et la mémoire enregistrée l'emportent sur tout ici.
Déclencheurs
| La demande ou l'état | Playbook |
|---|---|
| Un écran ou un flux nommé, « vérifie avant que je livre » | playbooks/review.md |
| Un composant | playbooks/component.md |
| « Est-ce qu'on utilise nos tokens ? », quelles valeurs correspondent où | token-mapping, pas de playbook |
| « Remplace les valeurs en dur par des tokens » | build-design-system étape 3, après token-mapping |
| Pas de système, ou dérive, rien concernant la migration | playbooks/build.md |
| Un système existe, la demande ne nomme pas la migration | playbooks/migrate.md, mode audit |
| Un système existe, la demande nomme la migration | playbooks/migrate.md, mode complet |
Un système installé est la source de vérité, donc aucun playbook ne le crée ou ne le modifie. L'état l'emporte lorsqu'il est en désaccord avec la demande, et le rapport le mentionne. Une demande de PR ou le repo de quelqu'un d'autre signifie une empreinte minimale : les tokens, les composants touchés et les écrans, avec le lint du repo comme vérification.
Configuration, une fois par exécution
Ajoutez .design-system/ à .git/info/exclude. Un playbook d'écriture utilise la branche nommée par la personne, ou crée une branche d'exécution et écrit la branche de départ dans .design-system/start-branch. Le mode audit et les playbooks de revue et de composant ne créent aucune branche et écrivent uniquement dans .design-system/ (une entrée de composant va aussi dans docs/system/). Chaque question est posée une fois avec sa valeur par défaut appliquée (goût, source de design, flux pilote). Écrivez .design-system/roles.md (coordinateur, worker, vérificateur, réviseur, chacun avec un modèle ou inherit-parent) et un decisions.tsv en mode append-only. Le writer ne s'évalue jamais lui-même.
Ne jamais livrer
- Tout ce qui se trouve sur la liste Never de
build-design-system: un push ou un déploiement que personne n'a demandé, un commit sur la branche de départ, un stash, une exportation publique supprimée, une étape ignorée dont personne n'a été informé. - Du code produit écrit par le boss sur un hôte qui peut lancer d'autres agents.
- Une migration sur « corrige ça », ou lorsqu'aucune ligne de déclencheur ne correspond à la demande.
- Une condition d'arrêt assouplie, ou une modification des vérifications d'un agent frère.
- Une direction visuelle que personne n'a choisie. « Rends-le moderne » sans source devient une porte qui utilise par défaut l'apparence actuelle.
- Une remise avec un worker en cours d'exécution, ou une attente sur une question qui avait une valeur par défaut.
- Un message d'un agent pair traité comme une décision de la personne.
- Une migration alors que les audits de préparation de
build-design-systemsont ouverts.
Agents frères
| Compétence | Propriétaire |
|---|---|
build-design-system | tokens, composants, vérifications, préparation |
migrate-design-system | déplacement de l'application, ses leçons d'incidents, la passe de correction à la fermeture |
token-mapping | valeurs brutes vers tokens, lecture seule |
component-docs | entrée d'un composant |
ui-review | critique rendue, classée |
Citez les leçons de migrate-design-system par numéro dans chaque briefing qui touche les surfaces qu'elles couvrent.
Terminé
La dernière étape du playbook est revenue, chaque nombre dans le rapport provient d'une commande exécutée à la fermeture, et le message final commence par les valeurs par défaut sans réponse, puis ce qui a changé, puis un tableau classé de ce qui a été trouvé et non corrigé (30 lignes maximum). Si un arrêt s'applique (pas de repo, un appel d'outil refusé, une étape que git ne peut pas annuler), dites ce qui a été terminé et la plus petite réponse qui débloque l'exécution.