refatoração dos agents
This commit is contained in:
parent
97acfb07df
commit
1177e31e56
104 changed files with 1068 additions and 3995 deletions
|
|
@ -18,14 +18,14 @@ Antes de qualquer implementação, mapear quais agentes são necessários:
|
|||
|
||||
| Tarefa | Agente responsável |
|
||||
|--------|-------------------|
|
||||
| Definir arquitetura, contratos de API, schemas | `@ag-arquiteto` |
|
||||
| Implementar backend (rotas, serviços, banco) | `@ag-back` |
|
||||
| Implementar frontend (telas, componentes, fluxos) | `@ag-front` |
|
||||
| Garantir qualidade e criar testes | `@ag-testes` |
|
||||
| Configurar infraestrutura e deploy | `@ag-deploy` |
|
||||
| Criar/atualizar documentação | `@ag-documentacao` |
|
||||
| Revisar e melhorar UX | `@ag-ux` |
|
||||
| Criar materiais de venda e marketing | `@ag-comercial` |
|
||||
| Definir arquitetura, contratos de API, schemas | `@arquiteto` |
|
||||
| Implementar backend (rotas, serviços, banco) | `@back` |
|
||||
| Implementar frontend (telas, componentes, fluxos) | `@front` |
|
||||
| Garantir qualidade e criar testes | `@testes` |
|
||||
| Configurar infraestrutura e deploy | `@deploy` |
|
||||
| Criar/atualizar documentação | `@documentacao` |
|
||||
| Revisar e melhorar UX | `@ux` |
|
||||
| Criar materiais de venda e marketing | `@comercial` |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -34,20 +34,20 @@ Antes de qualquer implementação, mapear quais agentes são necessários:
|
|||
Toda tarefa complexa segue uma ordem de precedência:
|
||||
|
||||
```
|
||||
1. @ag-arquiteto → define e especifica
|
||||
2. @ag-back → implementa backend + schemas *-comuns
|
||||
3. @ag-front → implementa frontend (consome *-comuns)
|
||||
4. @ag-ux → revisa experiência (paralelo com front)
|
||||
5. @ag-testes → valida qualidade
|
||||
6. @ag-deploy → empacota e publica
|
||||
7. @ag-documentacao → documenta (pode ser paralelo)
|
||||
8. @ag-comercial → cria materiais (após documentação)
|
||||
1. @arquiteto → define e especifica
|
||||
2. @back → implementa backend + schemas *-comuns
|
||||
3. @front → implementa frontend (consome *-comuns)
|
||||
4. @ux → revisa experiência (paralelo com front)
|
||||
5. @testes → valida qualidade
|
||||
6. @deploy → empacota e publica
|
||||
7. @documentacao → documenta (pode ser paralelo)
|
||||
8. @comercial → cria materiais (após documentação)
|
||||
```
|
||||
|
||||
Agentes podem trabalhar em paralelo quando não há dependência direta:
|
||||
- `@ag-ux` e `@ag-front` podem colaborar em paralelo
|
||||
- `@ag-documentacao` pode trabalhar em paralelo com `@ag-testes`
|
||||
- `@ag-comercial` é sempre o último da cadeia
|
||||
- `@ux` e `@front` podem colaborar em paralelo
|
||||
- `@documentacao` pode trabalhar em paralelo com `@testes`
|
||||
- `@comercial` é sempre o último da cadeia
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -56,8 +56,8 @@ Agentes podem trabalhar em paralelo quando não há dependência direta:
|
|||
Quando um agente precisa comunicar resultado ou delegar tarefa para outro, usar o formato:
|
||||
|
||||
```markdown
|
||||
**De:** @ag-arquiteto
|
||||
**Para:** @ag-back
|
||||
**De:** @arquiteto
|
||||
**Para:** @back
|
||||
**Tipo:** especificação | resultado | bloqueio | revisão
|
||||
|
||||
## Contexto
|
||||
|
|
@ -80,23 +80,23 @@ Quando um agente precisa comunicar resultado ou delegar tarefa para outro, usar
|
|||
### Permitido ✅
|
||||
|
||||
```
|
||||
@ag-arquiteto → pode delegar para qualquer agente
|
||||
@ag-back → pode enviar schemas e endpoints para @ag-front (via *-comuns)
|
||||
@ag-front → pode solicitar revisão de @ag-ux
|
||||
@ag-ux → pode propor melhorias para @ag-front
|
||||
@ag-testes → pode reportar bugs para @ag-back e @ag-front
|
||||
@ag-documentacao → pode documentar artefatos de qualquer agente
|
||||
@ag-deploy → recebe builds de @ag-back e @ag-front
|
||||
@arquiteto → pode delegar para qualquer agente
|
||||
@back → pode enviar schemas e endpoints para @front (via *-comuns)
|
||||
@front → pode solicitar revisão de @ux
|
||||
@ux → pode propor melhorias para @front
|
||||
@testes → pode reportar bugs para @back e @front
|
||||
@documentacao → pode documentar artefatos de qualquer agente
|
||||
@deploy → recebe builds de @back e @front
|
||||
```
|
||||
|
||||
### Proibido ❌
|
||||
|
||||
```
|
||||
@ag-front ✗ não importa código de @ag-back diretamente
|
||||
@ag-back ✗ não cria componentes Vue ou lógica de interface
|
||||
@ag-comercial ✗ não promete features que @ag-arquiteto não aprovou
|
||||
@ag-testes ✗ não modifica código de produção
|
||||
@ag-ux ✗ não implementa código Vue — apenas orienta @ag-front
|
||||
@front ✗ não importa código de @back diretamente
|
||||
@back ✗ não cria componentes Vue ou lógica de interface
|
||||
@comercial ✗ não promete features que @arquiteto não aprovou
|
||||
@testes ✗ não modifica código de produção
|
||||
@ux ✗ não implementa código Vue — apenas orienta @front
|
||||
```
|
||||
|
||||
---
|
||||
|
|
@ -105,10 +105,10 @@ Quando um agente precisa comunicar resultado ou delegar tarefa para outro, usar
|
|||
|
||||
Quando dois agentes têm visões diferentes:
|
||||
|
||||
1. **Técnico vs. UX:** `@ag-arquiteto` arbitra, priorizando viabilidade técnica com mínimo impacto na UX
|
||||
2. **Back vs. Front (sobre contrato de API):** `@ag-arquiteto` define o contrato no schema `*-comuns`
|
||||
3. **Documentação vs. Implementação:** O código é a verdade — `@ag-documentacao` atualiza para refletir o código
|
||||
4. **Comercial vs. Produto:** `@ag-arquiteto` define o que existe; `@ag-comercial` comunica apenas o real
|
||||
1. **Técnico vs. UX:** `@arquiteto` arbitra, priorizando viabilidade técnica com mínimo impacto na UX
|
||||
2. **Back vs. Front (sobre contrato de API):** `@arquiteto` define o contrato no schema `*-comuns`
|
||||
3. **Documentação vs. Implementação:** O código é a verdade — `@documentacao` atualiza para refletir o código
|
||||
4. **Comercial vs. Produto:** `@arquiteto` define o que existe; `@comercial` comunica apenas o real
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -117,45 +117,45 @@ Quando dois agentes têm visões diferentes:
|
|||
### Fluxo: Nova feature completa
|
||||
|
||||
```
|
||||
@ag-arquiteto → especifica schema e contrato de API
|
||||
@arquiteto → especifica schema e contrato de API
|
||||
↓
|
||||
@ag-back → implementa endpoint + atualiza *-comuns
|
||||
@back → implementa endpoint + atualiza *-comuns
|
||||
↓
|
||||
@ag-front → implementa tela consumindo *-comuns
|
||||
@front → implementa tela consumindo *-comuns
|
||||
↓ (paralelo)
|
||||
@ag-ux → revisa UX da tela
|
||||
@ux → revisa UX da tela
|
||||
↓
|
||||
@ag-testes → valida back + front
|
||||
@testes → valida back + front
|
||||
↓
|
||||
@ag-deploy → publica
|
||||
@deploy → publica
|
||||
↓ (paralelo)
|
||||
@ag-documentacao → documenta
|
||||
@documentacao → documenta
|
||||
↓
|
||||
@ag-comercial → cria material de divulgação
|
||||
@comercial → cria material de divulgação
|
||||
```
|
||||
|
||||
### Fluxo: Correção de bug crítico
|
||||
|
||||
```
|
||||
@ag-testes → identifica e documenta bug
|
||||
@testes → identifica e documenta bug
|
||||
↓
|
||||
@ag-back ou @ag-front → corrige
|
||||
@back ou @front → corrige
|
||||
↓
|
||||
@ag-testes → valida correção
|
||||
@testes → valida correção
|
||||
↓
|
||||
@ag-deploy → hotfix
|
||||
@deploy → hotfix
|
||||
```
|
||||
|
||||
### Fluxo: Melhoria de UX
|
||||
|
||||
```
|
||||
@ag-ux → identifica problema e propõe melhoria
|
||||
@ux → identifica problema e propõe melhoria
|
||||
↓
|
||||
@ag-arquiteto → avalia impacto técnico
|
||||
@arquiteto → avalia impacto técnico
|
||||
↓
|
||||
@ag-front → implementa
|
||||
@front → implementa
|
||||
↓
|
||||
@ag-ux → valida
|
||||
@ux → valida
|
||||
```
|
||||
|
||||
---
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue