publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

atualização de agent

Browse source
This commit is contained in:
Luiz Silva 2026-09-05 08:56:56 -03:00
parent f8d8627be2
commit d0e6567652
16 changed files with 260 additions and 100 deletions
Download patch file Download diff file Expand all files Collapse all files

21
skills/documentacao/SKILL
View file

@ -1,8 +1,8 @@
---
name: documentacao
description: Acionar o Agente de Documentação & Memória para documentar o contexto da conversa ou gerar artefatos nos 6 pilares canônicos
description: Acionar o Agente de Documentação & Memória para documentar o contexto da conversa ou gerar artefatos nos 6 pilares canônicos com versionamento automático na Wiki
scope: global
updatedAt: "2026-09-01"
updatedAt: "2026-09-05"
---
# Skill / Workflow: /documentacao
@ -21,6 +21,14 @@ Esta skill aciona o **Agente de Documentação & Memória** para gerar, atualiza
4. **Pilar 4 (Wiki de Desenvolvimento):** Documenta regras de negócio (`{modulo}.regras-negocio.md`), modelos e ADRs em `<base_projeto>/../wiki/dev/<modulo>/` (aplicação VitePress com acesso interno dev).
5. **Pilar 5 (Rota IA):** Assegura que novos schemas e rotas estejam refletidos na rota `/llm.md`.
6. **Pilar 6 (Memória IA):** Registra o relatório completo da sessão em `<base_projeto>/memorias-ia/`.
7. **Sincronização Git da Wiki (Obrigatório e Exclusivo):**
- Se houver arquivos novos ou alterados em `<base_projeto>/../wiki/`:
```bash
git -C <base_projeto>/../wiki add -A
git -C <base_projeto>/../wiki commit -m "docs(<modulo-id>): sincronizar documentação [contexto]"
git -C <base_projeto>/../wiki push
```
- **Trava de Segurança da Aplicação:** Na aplicação (`<base_projeto>`), o agente **NÃO pode mexer no git** (o versionamento do código-fonte da aplicação permanece sob controle humano exclusivo).
---
@ -49,16 +57,18 @@ Esta skill aciona o **Agente de Documentação & Memória** para gerar, atualiza
# Criar ajuda contextual modalX.ajuda.md para modal/tela
/documentacao ajuda <caminho/modalX.vue>
# Documentar domínio na Wiki do Usuário (VitePress)
# Documentar domínio na Wiki do Usuário (VitePress) + commit/push na wiki
/documentacao wiki-usuario <modulo>
# Documentar regras de negócio na Wiki Dev (VitePress)
# Documentar regras de negócio na Wiki Dev (VitePress) + commit/push na wiki
/documentacao regras <caminho/servico.ts>
# Criar um ADR na Wiki Dev
# Criar um ADR na Wiki Dev + commit/push na wiki
/documentacao adr "<Título da Decisão>"
```
*Nota:* Qualquer comando que crie ou modifique arquivos na Wiki (`<base_projeto>/../wiki`) deve finalizar executando `git add`, `git commit` e `git push` dentro de `../wiki`.
---
## 🔒 Regras Inegociáveis
@ -67,3 +77,4 @@ Esta skill aciona o **Agente de Documentação & Memória** para gerar, atualiza
2. **Linguagem acessível no usuário:** Sem termos técnicos de TI na Wiki do Usuário ou em `.ajuda.md`.
3. **JSDoc de Aplicação:** Explicar a utilidade prática no sistema, não apenas repetir tipos.
4. **Polimorfismo:** O `.agent` é genérico; personalizações ficam em `./memorias-ia/` e `<base_projeto>/../wiki/`.
5. **Fronteira Git e Push Obrigatório na Wiki:** Toda atualização em `<base_projeto>/../wiki` DEVE ser commitada e enviada via `git push` exclusivamente dentro do diretório `../wiki`. Na aplicação principal (`<base_projeto>`), a IA nunca mexe no Git (ver `rules/proibido-commit-ia.md`).