Documentação Viva do Projeto
Use NOC Living Docs como memória executável do projeto. Roteie por noc_docs/, leia apenas os documentos afetados, atualize os documentos vivos quando o código ou intenção mudar, e então verifique com a CLI.
Gatilho
Use este skill para:
- inicializar ou migrar
noc_docs/ - discutir um requisito e então alterar código
- novas funcionalidades, correções de bugs, refatorações, mudanças de API/dados/segurança/implantação
- verificar se alterações de código precisam de atualizações na documentação
- consultar ou auditar a documentação viva do projeto
Não use para perguntas gerais que não envolvam memória do projeto, comportamento do código, requisitos, guardrails, testes ou documentação NOC.
Execução
- Identifique o recurso/domínio afetado a partir da solicitação, caminhos alterados e
noc_docs/.living-docs/feature-map.json. - Execute um plano de trabalho quando o código puder mudar:
python scripts/noc.py work /caminho/para/projeto --feature <recurso> --intent "<requisito acordado>"
Use --path <caminho/código> quando caminhos forem mais claros que nomes de recursos.
- Leia os menores documentos relevantes:
agent-guide.md,requirements.md,status.md,guardrails.md,test-record.md, mais os guardrails de domínio quando presentes. - Escreva a intenção nova/alterada confirmada em
requirements.md; coloque discussões incertas emnotes.md. - Altere o código.
- Atualize
status.md,test-record.md,change-record.mdeguardrails.mdquando comportamento, verificação, mudanças importantes ou restrições forem alterados. - Execute
python scripts/noc.py index <projeto>após alterações em documentos, recursos ou mapeamento. - Execute
python scripts/noc.py check <projeto> --staged --warn-onlyantes do commit quando Git estiver disponível.
Para regras detalhadas do fluxo de trabalho, leia references/workflow.md.
Não Prossiga
Pare e pergunte ao usuário antes de editar código quando:
- a solicitação conflitar com
guardrails.mdou guardrails de domínio - a intenção do produto conflitar com
requirements.mde a direção pretendida não estiver clara - o recurso/domínio afetado não puder ser identificado e a alteração não for obviamente global
- documentos necessários estiverem faltando e a tarefa depender de requisitos ou restrições desconhecidos
- o usuário pedir para reescrever silenciosamente os requisitos para corresponder ao código atual
- a alteração envolver segurança, permissões, cobrança, perda de dados, migrações ou contratos públicos de API e o comportamento solicitado for ambíguo
Definição de Pronto
Uma tarefa usando este skill só está concluída quando:
- os documentos afetados foram identificados através do mapa de recursos, caminhos ou nome explícito do recurso
- os documentos necessários foram lidos ou a falta deles foi apontada
- as alterações de código e de documentação estão alinhadas
requirements.mdfoi alterado apenas para mudanças intencionais de comportamentostatus.mdreflete o comportamento atual após as alterações de códigotest-record.mdregistra a verificação ou explica por que a verificação não foi executadachange-record.mdregistra alterações importantes de implementação- índices/verificações foram executados quando disponíveis, ou ignorados com justificativa
Formato da Resposta Final
Termine com:
NOC Living Docs:
- documentos verificados:
- documentos atualizados:
- documentos intencionalmente inalterados:
- comandos executados:
- testes executados:
- riscos remanescentes:
Mantenha as listas curtas. Use nenhum quando uma categoria não se aplicar.
Referências
references/workflow.md: seleção de modo, regras de fallback, tratamento de conflitos, loop de trabalhoreferences/feature-doc-template.md: o que cada documento de recurso deve conterreferences/domain-mode-guide.md: quando e como usar o modo de domínioreferences/codex-prompts.md: prompts de usuário recomendados para fluxos de plano/meta/código do Codex