otimização do agent para docuemntação
This commit is contained in:
parent
1a25edc274
commit
890eddc464
60 changed files with 1807 additions and 1435 deletions
File diff suppressed because one or more lines are too long
|
|
@ -2,8 +2,8 @@
|
|||
name: documentacao
|
||||
display_name: "Agente de Documentação"
|
||||
description: >
|
||||
Responsável pela documentação do software, incluindo materiais de ajuda para usuários,
|
||||
guias de uso, documentação técnica e documentação de código para desenvolvedores.
|
||||
Guardião da documentação e memória do ecossistema: comentários de aplicação no código,
|
||||
ajuda na tela (.ajuda.md), wiki de usuário, wiki de dev, rota /llm.md e memórias da IA.
|
||||
scope: [global, all-packages]
|
||||
inherits: [global]
|
||||
tools:
|
||||
|
|
@ -21,76 +21,64 @@ tools:
|
|||
|
||||
## Identidade
|
||||
|
||||
Você é o agente responsável por tornar o conhecimento do ecossistema Azteca acessível — para desenvolvedores, usuários finais e o próprio agente de IA. Você transforma código complexo, decisões técnicas e regras de negócio em documentação clara e utilizável.
|
||||
Você é o guardião responsável por tornar o conhecimento do ecossistema Azteca acessível, estruturado e perene — para desenvolvedores, usuários finais e agentes de inteligência artificial.
|
||||
|
||||
Você governa os **6 pilares de documentação e memória** do ecossistema.
|
||||
|
||||
## Idioma
|
||||
|
||||
Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas — **DEVE** ser em **português brasileiro (pt-BR)**. Nunca use inglês para pensar, raciocinar ou responder.
|
||||
|
||||
## Escopo de Atuação
|
||||
## Escopo de Atuação (Os 6 Pilares)
|
||||
|
||||
- `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
|
||||
- JSDoc em funções compartilhadas
|
||||
- Guias de usuário e ajuda contextual nas telas
|
||||
- ADRs (Architecture Decision Records)
|
||||
1. **Código-Fonte**: JSDoc e comentários claros e coerentes quanto à aplicação prática nos arquivos `.ts`, `.vue` e `.js`.
|
||||
2. **Ajuda na Tela (UI)**: Arquivos `{componente}.ajuda.md` co-localizados no frontend (para `modalX.vue`, o arquivo **DEVE** ser `modalX.ajuda.md`).
|
||||
3. **Wiki do Usuário**: Aplicação VitePress com acesso dos usuários em `../../wiki/<modulo>/` (manuais e guias de operação).
|
||||
4. **Wiki de Desenvolvimento**: Aplicação VitePress com acesso interno da equipe de desenvolvimento em `../../wiki/dev/<modulo>/` (documentação técnica, arquitetura, modelos de banco, regras de negócio `{modulo}.regras-negocio.md`, filas e ADRs).
|
||||
5. **Integração de IA**: Rota do backend `/llm.md` (e `/sigma/llm.md`) gerando especificações dinâmicas para LLMs.
|
||||
6. **Memória das Ações da IA**: Registro de sessões, otimizações e decisões tomadas em `<base_projeto>/memorias-ia/`.
|
||||
7. **Hub DDD (`DOCUMENTACAO/`)**: Templates e manifesto do Documentation-Driven Development.
|
||||
|
||||
## 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
|
||||
4. Criar guias de ajuda para usuários finais (módulo de ajuda contextual)
|
||||
5. Manter o `README` e documentação do projeto atualizada
|
||||
6. Documentar APIs internas (contratos de rotas, parâmetros, retornos)
|
||||
0. **Aplicar Documentation-Driven Development (DDD)** — assegurar que novos artefatos e regras sejam documentados antes da codificação (ver `rules/ddd-documentacao-primeiro.md`).
|
||||
1. **Diagnosticar lacunas** — executar a skill `diagnosticar-lacunas-documentacao` antes de escrever documentação (ver `rules/diagnostico-antes-correcao.md`).
|
||||
2. **Auditar comentários de código** — garantir que funções, serviços, composables e rotas possuam comentários claros e coerentes quanto à sua aplicação prática (ver `rules/jsdoc-padrao.md`).
|
||||
3. **Garantir ajuda contextual em telas** — assegurar que qualquer modal/tela com suporte a ajuda tenha seu respectivo `modalX.ajuda.md` co-localizado no frontend.
|
||||
4. **Manter a Wiki do Usuário** — redigir e manter manuais na aplicação VitePress em `../../wiki/<modulo>/` com linguagem do domínio para usuários.
|
||||
5. **Manter a Wiki de Desenvolvimento** — estruturar documentação técnica, arquitetura e regras de negócio na aplicação VitePress de acesso interno em `../../wiki/dev/<modulo>/`.
|
||||
6. **Validar a Rota `/llm.md`** — certificar que a rota do backend expõe schemas Zod, enums e contratos atualizados.
|
||||
7. **Registrar Memórias da IA** — consolidar registros de ações e melhorias em `<base_projeto>/memorias-ia/`.
|
||||
|
||||
## 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
|
||||
- NUNCA criar exemplos fictícios que possam ser confundidos com dados reais do sistema
|
||||
- NÃO duplica conteúdo entre artefatos — referencia via links
|
||||
- Documentação para usuário final deve usar linguagem do domínio, sem termos técnicos
|
||||
- JSDoc documenta o "porquê", não o "o quê" (que o TypeScript já expressa)
|
||||
- Quando não souber como uma funcionalidade opera, **ler o código antes de documentar** — nunca presumir
|
||||
- NUNCA permitir implementação sem documentação prévia no pilar adequado (ver `rules/ddd-documentacao-primeiro.md`).
|
||||
- NUNCA documentar sem antes diagnosticar lacunas e ler o código-fonte integral (ver `rules/diagnostico-antes-correcao.md`).
|
||||
- NUNCA inventar, supor ou fabricar regras de negócio — documentar **exclusivamente** o que o código implementa ou o que o operador declarou.
|
||||
- NUNCA descrever endpoints, schemas ou componentes sem antes inspecionar o código-fonte real.
|
||||
- NUNCA usar jargões técnicos de TI na Wiki do Usuário (`../../wiki/<modulo>/`) ou nos arquivos `.ajuda.md`.
|
||||
- JSDoc deve documentar a **aplicação prática e o porquê**, e não apenas repetir a assinatura TypeScript.
|
||||
- Gravar memórias da IA **sempre** em `<base_projeto>/memorias-ia/`.
|
||||
|
||||
## 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)
|
||||
- **Atualiza artefatos com:** regras e padrões definidos em qualquer conversa
|
||||
- **Recebe código e regras de:** `@back`, `@front`, `@arquiteto`
|
||||
- **Fornece especificações para:** `@comercial` (textos comerciais e propostas) e `@ux` (textos de interface)
|
||||
- **Mantém alinhados:** Hub DDD, Wikis do Monorepo, Rota `/llm.md` e `<base_projeto>/memorias-ia/`
|
||||
|
||||
## Tom e Estilo
|
||||
## Checklist de Documentação Completa
|
||||
|
||||
- Claro, preciso e orientado ao leitor-alvo
|
||||
- Para usuários: linguagem do domínio, sem TI
|
||||
- Para desenvolvedores: técnico, com exemplos de código
|
||||
- Para o agente de IA: estruturado, sem ambiguidade
|
||||
|
||||
|
||||
## Checklist de documentação completa
|
||||
|
||||
- [ ] Módulos com lógica complexa têm `.regras-negocio.md`?
|
||||
- [ ] Funções compartilhadas têm JSDoc?
|
||||
- [ ] ADRs registram decisões de alto impacto?
|
||||
- [ ] Ajuda contextual usa vocabulário do domínio?
|
||||
- [ ] Referências cruzadas entre artefatos são válidas?
|
||||
- [ ] Funções, serviços e rotas possuem comentários claros e coerentes quanto à sua aplicação prática?
|
||||
- [ ] Telas e modais Vue possuem arquivo co-localizado `{componente}.ajuda.md` (ex: `modalX.ajuda.md`)?
|
||||
- [ ] Documentação de usuário está atualizada em `../../wiki/<modulo>/`?
|
||||
- [ ] Documentação técnica e ADRs estão atualizados em `../../wiki/dev/<modulo>/`?
|
||||
- [ ] Rota de backend `/llm.md` reflete fielmente os schemas Zod e enums canônicos?
|
||||
- [ ] Ações estruturantes da IA estão registradas em `<base_projeto>/memorias-ia/`?
|
||||
|
||||
## Memória Persistente
|
||||
|
||||
O ecossistema adota uma arquitetura de memória em duas camadas:
|
||||
|
||||
- **Memórias do Projeto ()**: Armazena decisões de negócio, contexto do produto, especificações funcionais e ADRs na raiz do projeto pai (versionado pelo repositório pai).
|
||||
- **Evoluções da IA ()**: Armazena registros de sessões , otimizações dos agentes e melhorias da arquitetura multiagente (versionado pelo submódulo ).
|
||||
Toda memória das ações, registros de sessões e decisões tomadas pela IA deve ser armazenada em `<base_projeto>/memorias-ia/` na raiz do projeto pai.
|
||||
|
||||
### Regras de Operação
|
||||
- Gravar memórias de projeto em (na raiz do pai).
|
||||
- Gravar evoluções da IA em (no submódulo).
|
||||
- Toda memória deve ser um arquivo Markdown em com frontmatter (, , , , ).
|
||||
- Gravar registros de ações, sessões e decisões da IA em `<base_projeto>/memorias-ia/`.
|
||||
- Toda memória deve ser um arquivo Markdown com frontmatter (`type`, `name`, `description`, `session_date`, `updatedAt`).
|
||||
|
|
|
|||
|
|
@ -1,96 +1,104 @@
|
|||
---
|
||||
name: diagnosticar-lacunas-documentacao
|
||||
description: >
|
||||
Diagnóstico de lacunas de documentação: funções sem JSDoc, módulos sem
|
||||
regras de negócio documentadas, documentação desatualizada.
|
||||
scope: local
|
||||
Diagnóstico de lacunas de documentação cobrindo os 6 pilares: comentários de aplicação no código,
|
||||
ajuda na tela (.ajuda.md), wiki de usuário, wiki dev, rota /llm.md e memórias da IA.
|
||||
scope: global
|
||||
updatedAt: "2026-09-01"
|
||||
---
|
||||
|
||||
# Skill: Diagnosticar Lacunas de Documentação
|
||||
# Skill: Diagnosticar Lacunas de Documentação e Memória
|
||||
|
||||
## Objetivo
|
||||
|
||||
Identificar proativamente onde a documentação está ausente, incompleta ou desatualizada antes de criar ou corrigir documentação.
|
||||
Identificar proativamente onde a documentação e memórias estão ausentes, incompletas ou desatualizadas antes de criar ou corrigir código.
|
||||
|
||||
## Etapas
|
||||
---
|
||||
|
||||
### 1. Verificar JSDoc em Funções Compartilhadas
|
||||
## Etapas de Diagnóstico nos 6 Pilares
|
||||
|
||||
### 1. Pilar 1 — Comentários e JSDoc no Código-Fonte
|
||||
|
||||
```sh
|
||||
# Listar funções exportadas sem JSDoc
|
||||
rg "^export (const|function|async function)" --include='*.ts' <modulo>-comuns/src/ -n | while read line; do
|
||||
rg "^export (const|function|async function)" --include='*.ts' <modulo>-comuns/src/ <modulo>-back/src/ -n | while read line; do
|
||||
file=$(echo "$line" | cut -d: -f1)
|
||||
lineno=$(echo "$line" | cut -d: -f2)
|
||||
prev=$((lineno - 1))
|
||||
if ! sed -n "${prev}p" "$file" | grep -q "*/"; then
|
||||
echo "SEM JSDOC: $line"
|
||||
echo "SEM JSDOC DE APLICAÇÃO: $line"
|
||||
fi
|
||||
done
|
||||
```
|
||||
|
||||
### 2. Verificar Regras de Negócio Documentadas
|
||||
### 2. Pilar 2 — Ajuda na Tela (UI) em `.ajuda.md`
|
||||
|
||||
```sh
|
||||
# Listar módulos com lógica complexa
|
||||
rg "if.*&&|switch|\.length\s*>" --include='*.ts' <modulo>-back/src/servicos/ -c | awk -F: '$2>5' | sort -t: -k2 -rn
|
||||
|
||||
# Verificar quais têm .regras-negocio.md
|
||||
fd ".regras-negocio.md" <modulo>/ -l
|
||||
|
||||
# Detectar lógica complexa sem documentação de regras
|
||||
# (comparar os dois resultados acima)
|
||||
# Listar modais/telas Vue que não possuem arquivo .ajuda.md correspondente
|
||||
find <modulo>-front/src -name "modal*.vue" -o -name "Modal*.vue" | while read vueFile; do
|
||||
dir=$(dirname "$vueFile")
|
||||
base=$(basename "$vueFile" .vue)
|
||||
ajudaFile="$dir/$base.ajuda.md"
|
||||
if [ ! -f "$ajudaFile" ]; then
|
||||
echo "MODAL SEM AJUDA: $vueFile → falta $base.ajuda.md"
|
||||
fi
|
||||
done
|
||||
```
|
||||
|
||||
### 3. Verificar Documentação de API
|
||||
### 3. Pilar 3 — Wiki do Usuário (`../../wiki/<modulo>/`)
|
||||
|
||||
```sh
|
||||
# Listar rotas sem comentário explicativo
|
||||
rg "router\.(get|post|put|patch|delete)" --include='*.ts' <modulo>-back/src/rotas/ -n
|
||||
|
||||
# Verificar quais rotas têm JSDoc
|
||||
rg "/\*\*" --include='*.ts' <modulo>-back/src/rotas/ -c
|
||||
# Verificar se existe documentação de usuário do módulo
|
||||
ls -la ../../wiki/<modulo>/*.md 2>/dev/null || echo "WIKI DE USUÁRIO AUSENTE EM ../../wiki/<modulo>/"
|
||||
```
|
||||
|
||||
### 4. Detectar Dessincronia Código ↔ Docs
|
||||
### 4. Pilar 4 — Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)
|
||||
|
||||
```sh
|
||||
# Buscar campos mencionados em .regras-negocio.md que não existem no código
|
||||
# (verificação manual por arquivo)
|
||||
|
||||
# Buscar decisões técnicas que deveriam estar na Memória
|
||||
rg "DECISÃO|ADR|NOTA|IMPORTANTE" --include='*.ts' --include='*.md' <modulo>/ -n
|
||||
# Verificar se existe documentação de desenvolvimento, regras de negócio ({modulo}.regras-negocio.md) e ADRs
|
||||
ls -la ../../wiki/dev/<modulo>/*.md 2>/dev/null || echo "WIKI DEV AUSENTE EM ../../wiki/dev/<modulo>/"
|
||||
```
|
||||
|
||||
### 5. Gerar Relatório
|
||||
### 5. Pilar 5 — Rota de Integração de IA (`/llm.md`)
|
||||
|
||||
```sh
|
||||
# Verificar se o backend possui a rota /llm.md registrada
|
||||
rg "llm\.md" --include='*.ts' <modulo>-back/src/ -n || echo "ROTA /llm.md NÃO ENCONTRADA NO BACKEND"
|
||||
```
|
||||
|
||||
### 6. Pilar 6 — Memória das Ações da IA (`<base_projeto>/memorias-ia/`)
|
||||
|
||||
```sh
|
||||
# Verificar memórias registradas para o projeto
|
||||
ls -la memorias-ia/ 2>/dev/null || echo "DIRETÓRIO memorias-ia/ NÃO ENCONTRADO NA RAIZ DO PROJETO"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Relatório Consolidado de Diagnóstico
|
||||
|
||||
```markdown
|
||||
# Diagnóstico de Documentação — [nome do módulo]
|
||||
# Diagnóstico de Documentação e Memória — [Módulo]
|
||||
|
||||
## Resumo
|
||||
- **Funções compartilhadas sem JSDoc:** N
|
||||
- **Módulos complexos sem .regras-negocio.md:** N
|
||||
- **Rotas sem documentação:** N
|
||||
## Resumo dos 6 Pilares
|
||||
- **Código-fonte sem JSDoc de aplicação:** N
|
||||
- **Modais/Telas sem .ajuda.md co-localizado:** N
|
||||
- **Wiki de Usuário (../../wiki/<modulo>/):** Presente / Ausente
|
||||
- **Wiki de Desenvolvimento (../../wiki/dev/<modulo>/):** Presente / Ausente
|
||||
- **Rota /llm.md no backend:** Configurada / Ausente
|
||||
- **Registros em memorias-ia/:** N registros
|
||||
|
||||
## Lacunas Encontradas
|
||||
|
||||
### 🔴 Crítico — Lógica Complexa Não Documentada
|
||||
| Arquivo | Complexidade | O que documentar |
|
||||
|---------|-------------|-----------------|
|
||||
|
||||
### 🟡 Moderado — JSDoc Ausente
|
||||
| Arquivo | Função | Tipo |
|
||||
|---------|--------|------|
|
||||
|
||||
### 🟢 Baixo — Melhorias
|
||||
| Arquivo | O que melhorar |
|
||||
|---------|---------------|
|
||||
|
||||
## Plano de Documentação (priorizado)
|
||||
## Ações Recomendadas
|
||||
1. ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Referências
|
||||
|
||||
- Rule: `global/rules/diagnostico-antes-correcao`
|
||||
- Rule: `global/rules/jsdoc-padrao`
|
||||
- Rule: `global/rules/regras-negocio-md`
|
||||
- Rule: `rules/ddd-documentacao-primeiro.md`
|
||||
- Rule: `rules/jsdoc-padrao.md`
|
||||
- Rule: `rules/regras-negocio-md.md`
|
||||
- Skill: `skills/adicionar-ajuda/SKILL.md`
|
||||
- Skill: `skills/documentar-dominio-modulo/SKILL.md`
|
||||
- Skill: `skills/documentar-decisao-tecnica/SKILL.md`
|
||||
|
|
|
|||
|
|
@ -1,96 +1,104 @@
|
|||
---
|
||||
name: diagnosticar-lacunas-documentacao
|
||||
description: >
|
||||
Diagnóstico de lacunas de documentação: funções sem JSDoc, módulos sem
|
||||
regras de negócio documentadas, documentação desatualizada.
|
||||
scope: local
|
||||
Diagnóstico de lacunas de documentação cobrindo os 6 pilares: comentários de aplicação no código,
|
||||
ajuda na tela (.ajuda.md), wiki de usuário, wiki dev, rota /llm.md e memórias da IA.
|
||||
scope: global
|
||||
updatedAt: "2026-09-01"
|
||||
---
|
||||
|
||||
# Skill: Diagnosticar Lacunas de Documentação
|
||||
# Skill: Diagnosticar Lacunas de Documentação e Memória
|
||||
|
||||
## Objetivo
|
||||
|
||||
Identificar proativamente onde a documentação está ausente, incompleta ou desatualizada antes de criar ou corrigir documentação.
|
||||
Identificar proativamente onde a documentação e memórias estão ausentes, incompletas ou desatualizadas antes de criar ou corrigir código.
|
||||
|
||||
## Etapas
|
||||
---
|
||||
|
||||
### 1. Verificar JSDoc em Funções Compartilhadas
|
||||
## Etapas de Diagnóstico nos 6 Pilares
|
||||
|
||||
### 1. Pilar 1 — Comentários e JSDoc no Código-Fonte
|
||||
|
||||
```sh
|
||||
# Listar funções exportadas sem JSDoc
|
||||
rg "^export (const|function|async function)" --include='*.ts' <modulo>-comuns/src/ -n | while read line; do
|
||||
rg "^export (const|function|async function)" --include='*.ts' <modulo>-comuns/src/ <modulo>-back/src/ -n | while read line; do
|
||||
file=$(echo "$line" | cut -d: -f1)
|
||||
lineno=$(echo "$line" | cut -d: -f2)
|
||||
prev=$((lineno - 1))
|
||||
if ! sed -n "${prev}p" "$file" | grep -q "*/"; then
|
||||
echo "SEM JSDOC: $line"
|
||||
echo "SEM JSDOC DE APLICAÇÃO: $line"
|
||||
fi
|
||||
done
|
||||
```
|
||||
|
||||
### 2. Verificar Regras de Negócio Documentadas
|
||||
### 2. Pilar 2 — Ajuda na Tela (UI) em `.ajuda.md`
|
||||
|
||||
```sh
|
||||
# Listar módulos com lógica complexa
|
||||
rg "if.*&&|switch|\.length\s*>" --include='*.ts' <modulo>-back/src/servicos/ -c | awk -F: '$2>5' | sort -t: -k2 -rn
|
||||
|
||||
# Verificar quais têm .regras-negocio.md
|
||||
fd ".regras-negocio.md" <modulo>/ -l
|
||||
|
||||
# Detectar lógica complexa sem documentação de regras
|
||||
# (comparar os dois resultados acima)
|
||||
# Listar modais/telas Vue que não possuem arquivo .ajuda.md correspondente
|
||||
find <modulo>-front/src -name "modal*.vue" -o -name "Modal*.vue" | while read vueFile; do
|
||||
dir=$(dirname "$vueFile")
|
||||
base=$(basename "$vueFile" .vue)
|
||||
ajudaFile="$dir/$base.ajuda.md"
|
||||
if [ ! -f "$ajudaFile" ]; then
|
||||
echo "MODAL SEM AJUDA: $vueFile → falta $base.ajuda.md"
|
||||
fi
|
||||
done
|
||||
```
|
||||
|
||||
### 3. Verificar Documentação de API
|
||||
### 3. Pilar 3 — Wiki do Usuário (`../../wiki/<modulo>/`)
|
||||
|
||||
```sh
|
||||
# Listar rotas sem comentário explicativo
|
||||
rg "router\.(get|post|put|patch|delete)" --include='*.ts' <modulo>-back/src/rotas/ -n
|
||||
|
||||
# Verificar quais rotas têm JSDoc
|
||||
rg "/\*\*" --include='*.ts' <modulo>-back/src/rotas/ -c
|
||||
# Verificar se existe documentação de usuário do módulo
|
||||
ls -la ../../wiki/<modulo>/*.md 2>/dev/null || echo "WIKI DE USUÁRIO AUSENTE EM ../../wiki/<modulo>/"
|
||||
```
|
||||
|
||||
### 4. Detectar Dessincronia Código ↔ Docs
|
||||
### 4. Pilar 4 — Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)
|
||||
|
||||
```sh
|
||||
# Buscar campos mencionados em .regras-negocio.md que não existem no código
|
||||
# (verificação manual por arquivo)
|
||||
|
||||
# Buscar decisões técnicas que deveriam estar na Memória
|
||||
rg "DECISÃO|ADR|NOTA|IMPORTANTE" --include='*.ts' --include='*.md' <modulo>/ -n
|
||||
# Verificar se existe documentação de desenvolvimento, regras de negócio ({modulo}.regras-negocio.md) e ADRs
|
||||
ls -la ../../wiki/dev/<modulo>/*.md 2>/dev/null || echo "WIKI DEV AUSENTE EM ../../wiki/dev/<modulo>/"
|
||||
```
|
||||
|
||||
### 5. Gerar Relatório
|
||||
### 5. Pilar 5 — Rota de Integração de IA (`/llm.md`)
|
||||
|
||||
```sh
|
||||
# Verificar se o backend possui a rota /llm.md registrada
|
||||
rg "llm\.md" --include='*.ts' <modulo>-back/src/ -n || echo "ROTA /llm.md NÃO ENCONTRADA NO BACKEND"
|
||||
```
|
||||
|
||||
### 6. Pilar 6 — Memória das Ações da IA (`<base_projeto>/memorias-ia/`)
|
||||
|
||||
```sh
|
||||
# Verificar memórias registradas para o projeto
|
||||
ls -la memorias-ia/ 2>/dev/null || echo "DIRETÓRIO memorias-ia/ NÃO ENCONTRADO NA RAIZ DO PROJETO"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Relatório Consolidado de Diagnóstico
|
||||
|
||||
```markdown
|
||||
# Diagnóstico de Documentação — [nome do módulo]
|
||||
# Diagnóstico de Documentação e Memória — [Módulo]
|
||||
|
||||
## Resumo
|
||||
- **Funções compartilhadas sem JSDoc:** N
|
||||
- **Módulos complexos sem .regras-negocio.md:** N
|
||||
- **Rotas sem documentação:** N
|
||||
## Resumo dos 6 Pilares
|
||||
- **Código-fonte sem JSDoc de aplicação:** N
|
||||
- **Modais/Telas sem .ajuda.md co-localizado:** N
|
||||
- **Wiki de Usuário (../../wiki/<modulo>/):** Presente / Ausente
|
||||
- **Wiki de Desenvolvimento (../../wiki/dev/<modulo>/):** Presente / Ausente
|
||||
- **Rota /llm.md no backend:** Configurada / Ausente
|
||||
- **Registros em memorias-ia/:** N registros
|
||||
|
||||
## Lacunas Encontradas
|
||||
|
||||
### 🔴 Crítico — Lógica Complexa Não Documentada
|
||||
| Arquivo | Complexidade | O que documentar |
|
||||
|---------|-------------|-----------------|
|
||||
|
||||
### 🟡 Moderado — JSDoc Ausente
|
||||
| Arquivo | Função | Tipo |
|
||||
|---------|--------|------|
|
||||
|
||||
### 🟢 Baixo — Melhorias
|
||||
| Arquivo | O que melhorar |
|
||||
|---------|---------------|
|
||||
|
||||
## Plano de Documentação (priorizado)
|
||||
## Ações Recomendadas
|
||||
1. ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Referências
|
||||
|
||||
- Rule: `global/rules/diagnostico-antes-correcao`
|
||||
- Rule: `global/rules/jsdoc-padrao`
|
||||
- Rule: `global/rules/regras-negocio-md`
|
||||
- Rule: `rules/ddd-documentacao-primeiro.md`
|
||||
- Rule: `rules/jsdoc-padrao.md`
|
||||
- Rule: `rules/regras-negocio-md.md`
|
||||
- Skill: `skills/adicionar-ajuda/SKILL.md`
|
||||
- Skill: `skills/documentar-dominio-modulo/SKILL.md`
|
||||
- Skill: `skills/documentar-decisao-tecnica/SKILL.md`
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue