.agent/global/workflows/doc.md

type	name	description	scope	updatedAt
workflow	doc	Alias para /documentacao - acionar o Agente de Documentação & Memória com versionamento automático na Wiki	global	2026-09-05

Workflow: /doc (Alias para /documentacao)

Atalho rápido para o Agente de Documentação & Memória cobrindo os 6 pilares canônicos:

⚡ Sem Parâmetros: Se executado apenas como /doc, documenta 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 índice historico-acoes.md com a tabela Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte)

---

🔄 Versionamento Git Obrigatório da Wiki (<base_projeto>/../wiki)

Sempre que a documentação na Wiki (Pilares 3 e 4) for criada ou atualizada:

• O agente DEVE obrigatoriamente executar commit, push e resolução de conflitos das alterações diretamente na branch master no repositório da Wiki:

  git -C <base_projeto>/../wiki add -A
  git -C <base_projeto>/../wiki commit -m "docs(<modulo-id>): sincronizar documentação"
  git -C <base_projeto>/../wiki pull --rebase origin master # se houver divergência, resolve na master
  git -C <base_projeto>/../wiki push origin master
  

🔒 Fronteira Git e Salvaguarda de Master: Na Wiki, commit, push e resolução de conflitos ocorrem diretamente na branch master. Na aplicação principal (<base_projeto>), a IA pode realizar commits apenas em branches de trabalho, sendo terminantemente proibido comitar na branch master (se estiver em master, deve criar uma nova branch; ver rules/proibido-commit-ia.md).

---

Para ver todas as opções, comandos e sintaxes completas, consulte /documentacao.