candycong2001-ui/agent-project-playbook

Project Docs

Fluxo de Trabalho

1. No início de uma implementação ou diagnóstico substancial, leia docs/CURRENT_HANDOFF.md e apenas as seções relevantes dos documentos estáveis.
2. Verifique as alegações dos documentos contra as evidências atuais do repositório.
3. Durante exploração ou revisão somente leitura, reporte desvios sem editar, a menos que o usuário autorize alterações.
4. No início da tarefa, substitua o objetivo atual e a próxima ação em CURRENT_HANDOFF.md.
5. Após um marco verificado, substitua o estado atual e as evidências de verificação; não adicione uma linha do tempo.
6. Antes da passagem (handoff), remova detalhes de processos concluídos e deixe um estado pronto para continuação.
7. Atualize BLUEPRINT.md apenas quando a intenção do produto, usuários, escopo, restrições ou critérios de aceitação mudarem.
8. Atualize ARCHITECTURE.md apenas quando componentes, limites, fluxo de dados, comandos verificados, implantação, reversão ou riscos mudarem.
9. Antes de uma entrega substancial, execute python3 .agents/skills/project-docs/scripts/docs_lint.py.

Limites

• O código atual, testes, configuração, saída de comando e instruções do usuário têm precedência sobre estes documentos.
• Mantenha BLUEPRINT em ou abaixo de 160 linhas.
• Mantenha ARCHITECTURE em ou abaixo de 160 linhas.
• Mantenha CURRENT_HANDOFF em ou abaixo de 80 linhas.
• Mantenha AGENTS em ou abaixo de 90 linhas.
• O Git armazena o histórico. CURRENT_HANDOFF armazena apenas o estado de trabalho mais recente.