chore(agent): remover permissoes de commit da IA no projeto e wiki (apenas sugerir texto) e manter push automatico exclusivo no .agent

global/workflows/documentacao.md

@@ -1,9 +1,9 @@
 ---
 type: workflow
 name: documentacao
-description: Acionar o Agente de Documentação para documentar o contexto do chat ou executar comandos específicos nos 6 pilares com versionamento automático na Wiki
+description: Acionar o Agente de Documentação para documentar o contexto do chat ou executar comandos específicos nos 6 pilares com sugestão de mensagem de commit para o operador humano
 scope: global
-updatedAt: "2026-09-05"
+updatedAt: "2026-10-14"
 ---
 
 # Workflow: /documentacao (Agente de Documentação & Memória)
@@ -25,16 +25,12 @@ Este workflow aciona o **Agente de Documentação** para gerar, atualizar ou aud
    - **Pilar 4 (Wiki Dev):** Documenta regras técnicas (`{modulo}.regras-negocio.md`) e ADRs em `<base_projeto>/../wiki/dev/<modulo>/`.
    - **Pilar 5 (Rota IA):** Assegura que novos schemas e rotas estejam refletidos na rota `/llm.md`.
    - **Pilar 6 (Memória IA):** Registra o relatório completo da sessão no arquivo dedicado `<base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md` e indexa a alteração no arquivo central `<base_projeto>/memorias-ia/historico-acoes.md` inserindo linha na tabela com as colunas: `Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte`.
-3. **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
-     ```
-   - **Fronteira Inegociável da Aplicação:** Na aplicação principal (`<base_projeto>`), o agente **NÃO pode mexer no git** (o versionamento do código-fonte da aplicação permanece sob controle humano exclusivo).
+3. **Sugestão de Mensagem de Commit (Commit Exclusivo por Humano):**
+   - O agente **NUNCA executa `git commit` ou `git push`** na aplicação principal (`<base_projeto>`) nem na Wiki (`<modulo-wiki>`).
+   - Apresenta ao operador humano a sugestão de mensagem de commit pronta para copiar:
+     `💬 Sugestão de Commit: docs(<modulo-id>): <descrição sucinta das alterações>`
 4. **Entrega de Relatório:**
-   - Apresenta um resumo claro ao operador de tudo o que foi documentado com links diretos para os arquivos gerados e confirmação do push na Wiki.
+   - Apresenta um resumo claro ao operador de tudo o que foi documentado com links diretos para os arquivos gerados e a sugestão do texto de commit.
 
 ---
 
@@ -63,17 +59,17 @@ Este workflow aciona o **Agente de Documentação** para gerar, atualizar ou aud
 # Criar ajuda contextual modalX.ajuda.md para modal/tela
 /documentacao ajuda <caminho/modalX.vue>
 
-# Documentar domínio na Wiki do Usuário (VitePress) + commit/push na wiki
+# Documentar domínio na Wiki do Usuário (VitePress) + sugestão de commit
 /documentacao wiki-usuario <modulo>
 
-# Documentar regras de negócio na Wiki Dev (VitePress) + commit/push na wiki
+# Documentar regras de negócio na Wiki Dev (VitePress) + sugestão de commit
 /documentacao regras <caminho/servico.ts>
 
-# Criar um ADR na Wiki Dev + commit/push na wiki
+# Criar um ADR na Wiki Dev + sugestão de commit
 /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`, `git pull --rebase` (resolvendo conflitos na master se houver) e `git push` diretamente na branch `master` dentro de `../wiki`.
+*Nota:* Qualquer comando que crie ou modifique arquivos na aplicação ou na Wiki (`<base_projeto>/../wiki`) **não deve executar `git commit` nem `git push`**, apresentando ao final apenas a sugestão de mensagem de commit para o operador humano.
 
 ---
 
@@ -83,4 +79,4 @@ Este workflow aciona o **Agente de Documentação** para gerar, atualizar ou aud
 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 Gestão em Master na Wiki:** Toda atualização em `<base_projeto>/../wiki` DEVE ser commitada, sincronizada com resolução de conflitos e enviada via `git push` diretamente na branch `master` de `../wiki`. Na aplicação principal (`<base_projeto>`), a IA pode comitar apenas em branches de trabalho, sendo proibido comitar na `master` (ver `rules/proibido-commit-ia.md`).
+5. **Fronteira Git (Commit Exclusivo por Humano):** É proibido à IA executar `git commit` ou `git push` na aplicação principal (`<base_projeto>`) e na Wiki (`<modulo-wiki>`). A IA deve apenas sugerir o texto do commit (`docs(<modulo-id>): ...`) para o operador humano. Apenas o submódulo `.agent` pode receber commit/push automático (ver `rules/proibido-commit-ia.md`).