.agent/global/skills/doc/SKILL.md

name	description	scope	updatedAt
doc	Alias rápido para /documentacao - acionar o Agente de Documentação & Memória nos 6 pilares com sugestão de mensagem de commit para o operador humano	global	2026-10-14

Skill: /doc (Alias para /documentacao)

Atalho rápido para o Agente de Documentação & Memória cobrindo os 6 pilares canônicos do Documentation-Driven Development (DDD):

⚡ Modo Padrão Sem Parâmetros: Se executado apenas como /doc, documenta e sincroniza automaticamente todo o contexto e decisões da conversa atual no chat.

• 1. Código-Fonte \rightarrow JSDoc de aplicação prática (rules/jsdoc-padrao.md)
• 2. Ajuda UI \rightarrow modalX.ajuda.md co-localizado com modalX.vue
• 3. Wiki Usuário \rightarrow <base_projeto>/../wiki/<modulo>/ (VitePress com acesso dos usuários)
• 4. Wiki Dev \rightarrow <base_projeto>/../wiki/dev/<modulo>/ (VitePress com acesso interno dev e regras {modulo}.regras-negocio.md)
• 5. Rota IA \rightarrow Rota do backend /llm.md
• 6. Memória IA \rightarrow <base_projeto>/memorias-ia/ (gera sessao-AAAA-MM-DD-slug.md e indexa no arquivo central historico-acoes.md)

---

🧠 Pilar 6: Memória da IA e Histórico de Ações (memorias-ia/)

Ao documentar a sessão (seja via /doc ou /documentacao):

1. Arquivo da Sessão: O agente gera o registro detalhado em <base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md descrevendo contexto, causa raiz, solução técnica, citações no código-fonte e validações.
2. Índice de Ações (historico-acoes.md): O agente registra/atualiza a linha correspondente na tabela de <base_projeto>/memorias-ia/historico-acoes.md:

   | Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte |
   | :--- | :--- | :--- | :--- |
   | **AAAA-MM-DD** | [Descrição da Ação] | [`sessao-AAAA-MM-DD-slug.md`](./sessao-AAAA-MM-DD-slug.md) | `caminho/arquivo.ts`<br>`outro/arquivo.vue` |
   

💬 Sugestão de Mensagem de Commit (Commit Exclusivo por Humano)

Sempre que documentações na aplicação (<base_projeto>) ou na Wiki (<modulo-wiki>, padrão ../wiki) forem criadas ou alteradas:

• O agente NUNCA executa git commit ou git push — o commit deve ser feito exclusivamente pelo operador humano (ver rules/proibido-commit-ia.md).
• Ao concluir, o agente apresenta a sugestão de mensagem de commit pronta para o humano copiar:

  💬 **Sugestão de Commit (Wiki / Aplicação):**
  `docs(<modulo-id>): <descrição sucinta das alterações>`
  

🔒 Fronteira Git: Apenas o submódulo .agent pode receber commit/push de forma automática pela IA. Tanto na aplicação principal (<base_projeto>) quanto na Wiki (<modulo-wiki>), a IA apenas sugere o texto do commit ao operador humano.

---

Para ver a especificação completa, comandos com argumentos e exemplos, consulte skills/documentacao/SKILL.md.