Orchestration de la documentation
Lorsque ce skill est invoqué, exécutez le pipeline suivant :
Étape 1 : Audit d'architecture
Lancez l'agent general-purpose avec cette invite :
Auditez le codebase actuel pour détecter les modifications depuis la dernière mise à jour de la documentation. Lisez la documentation machine existante (un registre racine unique
AGENTS.md) et comparez-la avec le projet réel. Produisez un rapport de modifications concis couvrant :
- Bundles, compétences, agents, clés de configuration ou commandes CLI nouveaux ou supprimés
- Exportations d'installateur modifiées ou sémantique de template changée (
installer/lib/*.mjs)- Déclarations de configuration
bundle.yamldésynchronisées avec l'utilisation des espaces réservés- Dérive de sortie rendue :
node installer/cli.mjs doctor --allow-missingpropre (rendu engagé + verrou en synchronisation — re-rendre et engager après les modifications de bundle) ;.gitignorecouvre toujours les rendus délibérément non suivis (workflow de hook d'étiquette, worktrees, docs de vue d'ensemble.waffle/)Produisez UNIQUEMENT le rapport de modifications sous forme de texte structuré. Ne modifiez AUCUN fichier.
Étape 2 : Documentation agent
Prenez le rapport de modifications et lancez l'agent docs-agent avec cette invite :
Voici le rapport de modifications architecturales pour le codebase wafflestack :
{sortie étape 1}
Mettez à jour la documentation machine — un registre racine unique
AGENTS.md— pour refléter l'état actuel du projet. Lisez les fichiers source réels pour vérifier les détails — ne vous fiez pas uniquement au rapport de modifications. Suivez les directives de la compétence docs-agent pour le format et la structure.
Étape 3 : Documentation humaine
Une fois que docs-agent a terminé, lancez l'agent docs-human avec cette invite :
La documentation machine vient d'être mise à jour. Mettez à jour la documentation destinée aux humains —
DECISIONS.md,STATUS.mdetARCHITECTURE.mdà la racine du dépôt — pour correspondre.Lisez la documentation machine mise à jour et le code source réel pour garantir l'exactitude. Suivez les directives de la compétence docs-human pour le format, la structure et ses garde-fous (les documents rédigés par le propriétaire sont signalés, jamais réécrits).
Important
- Chaque étape doit se terminer avant que la suivante ne commence — la sortie de chacune alimente la suivante.
- L'étape 1 est en lecture seule — l'agent d'audit ne fait que rapporter.
- docs-agent et docs-human DOIVENT modifier leurs fichiers de documentation respectifs.