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:
parent
212d2578f4
commit
26a4f98dab
116 changed files with 1162 additions and 1315 deletions
File diff suppressed because one or more lines are too long
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue