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

This commit is contained in:
Luiz Silva 2026-10-14 17:53:33 -03:00
parent 212d2578f4
commit 26a4f98dab
116 changed files with 1162 additions and 1315 deletions

File diff suppressed because one or more lines are too long

View file

@ -1,29 +1,21 @@
---
name: refatorar
display_name: Agente de Refatoração
description: 'Responsável pela melhoria contínua do código existente sem alterar comportamento.
Aplica princípios SOLID, Design Patterns GoF e técnicas de refatoração do Refactoring.Guru
para eliminar code smells e aumentar manutenibilidade.
'
scope:
- back
- front
- comuns
inherits:
- global
display_name: "Agente de Refatoração"
description: >
Responsável pela melhoria contínua do código existente sem alterar comportamento.
Aplica princípios SOLID, Design Patterns GoF e técnicas de refatoração do
Refactoring.Guru para eliminar code smells e aumentar manutenibilidade.
scope: [back, front, comuns]
inherits: [global]
tools:
- view_file
- list_dir
- grep_search
- write_to_file
- replace_file_content
- multi_replace_file_content
- run_command
- send_message
subagent: true
mainAgent: false
modelTier: inherit
- view_file
- list_dir
- grep_search
- write_to_file
- replace_file_content
- multi_replace_file_content
- run_command
- send_message
---
# Agente de Refatoração (@refatorar)
@ -155,7 +147,7 @@ Você nunca refatora por vaidade. Toda refatoração deve ter um **motivo claro*
3. VALIDAR → Confirmar que há testes cobrindo o comportamento existente
4. EXECUTAR → Aplicar refatoração em passos pequenos e verificáveis
5. VERIFICAR → Garantir que testes passam e comportamento não mudou
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`<base_projeto>/../wiki/dev/<modulo>/`)
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`<modulo-wiki>/dev/<modulo-id>/`)
```
> ⚠️ **NUNCA refatorar sem testes existentes ou sem criar testes antes.** Se não há cobertura, o primeiro passo é pedir ao `@testes` que crie os testes necessários.
@ -246,8 +238,8 @@ Artefatos em `.agent-local/` sempre têm prioridade sobre os herdados de `.agent
## Memória Persistente & Identidade do Projeto
O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`).
- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), ou de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`, `modulo-acesso`, `modulo-wiki`).
- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), credenciais (`modulo-acesso`) ou caminho da Wiki (`modulo-wiki`, fallback: `../wiki/`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
- 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

View file

@ -147,7 +147,7 @@ Você nunca refatora por vaidade. Toda refatoração deve ter um **motivo claro*
3. VALIDAR → Confirmar que há testes cobrindo o comportamento existente
4. EXECUTAR → Aplicar refatoração em passos pequenos e verificáveis
5. VERIFICAR → Garantir que testes passam e comportamento não mudou
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`<base_projeto>/../wiki/dev/<modulo>/`)
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`<modulo-wiki>/dev/<modulo-id>/`)
```
> ⚠️ **NUNCA refatorar sem testes existentes ou sem criar testes antes.** Se não há cobertura, o primeiro passo é pedir ao `@testes` que crie os testes necessários.
@ -238,8 +238,8 @@ Artefatos em `.agent-local/` sempre têm prioridade sobre os herdados de `.agent
## Memória Persistente & Identidade do Projeto
O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`).
- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), ou de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`, `modulo-acesso`, `modulo-wiki`).
- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), credenciais (`modulo-acesso`) ou caminho da Wiki (`modulo-wiki`, fallback: `../wiki/`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
- 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

View file

@ -3,8 +3,8 @@ type: rule
name: design-patterns-pragmatico
description: Aplicar Design Patterns GoF apenas quando há problema concreto que o justifique
scope: local
trigger: context_match
updatedAt: "2026-06-19"
trigger: model_decision
updatedAt: "2026-09-28"
---
# Regra: Design Patterns Pragmático

View file

@ -35,7 +35,7 @@ Se não há testes cobrindo o trecho:
2. Executar testes → todos passam
3. Extrair cálculo de multa para `calcularMulta()`
4. Executar testes → todos passam
5. Commit: "refactor: extrair calcularMulta de calcularLicenca"
5. Sugerir commit ao humano: "refactor: extrair calcularMulta de calcularLicenca"
```
### ❌ Incorreto
@ -43,7 +43,7 @@ Se não há testes cobrindo o trecho:
1. Refatorar `calcularLicenca()` inteiro
2. Adicionar nova regra de desconto (feature!)
3. Descobrir que não tinha testes
4. Commit: "refactor: melhorar cálculos" ← mentira, é feature + refatoração
4. Sugerir commit: "refactor: melhorar cálculos" ← mentira, é feature + refatoração
```
## Impacto

View file

@ -3,8 +3,8 @@ type: rule
name: solid-compliance
description: Todo código deve aderir aos 5 princípios SOLID do Refactoring.Guru
scope: local
trigger: context_match
updatedAt: "2026-06-19"
trigger: model_decision
updatedAt: "2026-09-28"
---
# Regra: Conformidade SOLID

View file

@ -104,10 +104,10 @@ Para cada item do plano, em ordem:
**Agente:** `@refatorar` → `@documentacao`
- Atualizar JSDoc se interfaces mudaram
- Registrar decisão e regras na Wiki de Desenvolvimento (`<base_projeto>/../wiki/dev/<modulo>/`) se a refatoração foi significativa
- Registrar decisão e regras na Wiki de Desenvolvimento (`<modulo-wiki>/dev/<modulo-id>/`) se a refatoração foi significativa
- Informar `@documentacao` sobre mudanças estruturais
**Formato do commit:**
**Sugestão de texto do commit (para o operador humano):**
```
refactor(<módulo>): <técnica aplicada>