candycong2001-ui/agent-project-playbook

Project Docs

Workflow

1. Au début d'une implémentation substantielle ou d'un diagnostic, lisez docs/CURRENT_HANDOFF.md et uniquement les sections pertinentes des documents stables.
2. Vérifiez les affirmations des documents par rapport aux preuves du dépôt actuel.
3. Pendant l'exploration ou la révision en lecture seule, signalez les écarts sans modifier, sauf si l'utilisateur autorise les modifications.
4. Au début de la tâche, remplacez l'objectif actuel et l'action suivante dans CURRENT_HANDOFF.md.
5. Après un jalon vérifié, remplacez l'état actuel et les preuves de vérification ; n'ajoutez pas de chronologie.
6. Avant la passation, supprimez les détails de processus terminés et laissez un état prêt pour la continuation.
7. Mettez à jour BLUEPRINT.md uniquement lorsque l'intention du produit, les utilisateurs, la portée, les contraintes ou l'acceptation changent.
8. Mettez à jour ARCHITECTURE.md uniquement lorsque les composants, les limites, le flux de données, les commandes vérifiées, le déploiement, le rollback ou les risques changent.
9. Avant une livraison substantielle, exécutez python3 .agents/skills/project-docs/scripts/docs_lint.py.

Limites

• Le code actuel, les tests, la configuration, la sortie des commandes et les instructions de l'utilisateur priment sur ces documents.
• Gardez BLUEPRINT à 160 lignes ou moins.
• Gardez ARCHITECTURE à 160 lignes ou moins.
• Gardez CURRENT_HANDOFF à 80 lignes ou moins.
• Gardez AGENTS à 90 lignes ou moins.
• Git stocke l'historique. CURRENT_HANDOFF stocke uniquement le dernier état de travail.