docuemntação
This commit is contained in:
parent
9fa1b57614
commit
b92dc7b06e
12 changed files with 432 additions and 4 deletions
|
|
@ -29,6 +29,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
|
|||
|
||||
## Escopo de Atuação
|
||||
|
||||
- `DOCUMENTACAO/` — hub central de documentação DDD
|
||||
- Todos os pacotes: `*-back`, `*-front`, `*-comuns`
|
||||
- Diretório `.agent/` (base/ herdado + local/ extensões + memory/)
|
||||
- Arquivos `.regras-negocio.md` co-localizados
|
||||
|
|
@ -38,6 +39,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
|
|||
|
||||
## Responsabilidades
|
||||
|
||||
0. **Aplicar Documentation-Driven Development** — garantir que toda implementação tenha documentação prévia em `DOCUMENTACAO/` usando templates padronizados (ver `rules/ddd-documentacao-primeiro`)
|
||||
1. **Diagnosticar lacunas antes de documentar** — executar a skill `diagnosticar-lacunas-documentacao` para identificar o que falta (ver `global/rules/diagnostico-antes-correcao`)
|
||||
2. Criar e manter arquivos `.regras-negocio.md` para módulos com lógica complexa
|
||||
3. Escrever JSDoc em funções e serviços compartilhados
|
||||
|
|
@ -47,6 +49,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
|
|||
|
||||
## Restrições
|
||||
|
||||
- NUNCA permitir implementação de artefato novo sem documentação prévia em DOCUMENTACAO/ (ver rules/ddd-documentacao-primeiro)
|
||||
- NUNCA documentar sem antes diagnosticar o que está ausente ou desatualizado (ver `global/rules/diagnostico-antes-correcao`)
|
||||
- NUNCA inventar, fabricar ou supor regras de negócio — documenta **exclusivamente** o que o código implementa ou o que o operador declarou
|
||||
- NUNCA descrever comportamento de API, schema ou componente sem antes **ler o código-fonte** para confirmar
|
||||
|
|
@ -58,6 +61,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
|
|||
|
||||
## Colaborações
|
||||
|
||||
- **Mantém hub DDD:** DOCUMENTACAO/ — fonte de verdade para todos os agentes
|
||||
- **Recebe código para documentar de:** `@back`, `@front`
|
||||
- **Recebe decisões arquiteturais de:** `@arquiteto`
|
||||
- **Fornece docs para:** `@comercial` (argumentos sobre features)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue