127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
# AGENTS.md — Ponto de entrada dos agentes Azteca
|
|
|
|
Este arquivo descreve como ativar e colaborar com os agentes especializados do ecossistema Azteca dentro do Antigravity.
|
|
|
|
---
|
|
|
|
## Agentes disponíveis
|
|
|
|
| Agente | Handle | Especialidade |
|
|
|--------|--------|--------------|
|
|
| Arquiteto | `@ag-arquiteto` | Arquitetura, especificações, ADRs |
|
|
| Backend | `@ag-back` | APIs, banco de dados, filas, CRONs |
|
|
| Frontend | `@ag-front` | Vue 3, telas, composables, integração API |
|
|
| Testes | `@ag-testes` | Testes unitários, integração, roteiros de QA |
|
|
| Deploy | `@ag-deploy` | Docker, CI/CD, infraestrutura, ambientes |
|
|
| Documentação | `@ag-documentacao` | JSDoc, regras de negócio, guias de usuário |
|
|
| UX | `@ag-ux` | Fluxos de uso, usabilidade, mensagens de interface |
|
|
| Comercial | `@ag-comercial` | Propostas, marketing, Reels, orçamentos |
|
|
| Agente de Agentes | `@ag-agente` | Construção, melhoria e manutenção do ecossistema de agentes |
|
|
| Refatoração | `@ag-refatorar` | SOLID, Design Patterns GoF, code smells, refatoração segura |
|
|
|
|
---
|
|
|
|
## Como ativar um agente
|
|
|
|
No Antigravity, mencione o agente pelo handle:
|
|
|
|
```
|
|
@ag-back implementa o endpoint POST /usuarios conforme schema zUsuarioCriar
|
|
```
|
|
|
|
```
|
|
@ag-ux revisa o fluxo de cadastro de empreendimento
|
|
```
|
|
|
|
---
|
|
|
|
## Estrutura do `.agent/`
|
|
|
|
```
|
|
.agent/
|
|
├── AGENTS.md ← este arquivo
|
|
├── manifesto.json ← inventário de todos os artefatos
|
|
├── gerar-manifesto.sh ← gera manifesto.json automaticamente
|
|
├── atualizar-agente.sh ← distribui artefatos para os módulos
|
|
├── tools.md ← ferramentas CLI recomendadas
|
|
├── verificar-linhas.sh ← governance: limite de linhas
|
|
│
|
|
├── global/ ← artefatos herdados por TODOS os agentes
|
|
│ ├── rules/ ← 11 rules globais
|
|
│ ├── workflows/ ← 3 workflows globais
|
|
│ └── skills/ ← 7 skills globais (incluindo orquestrar-agentes)
|
|
│
|
|
├── agents/ ← definições dos 10 agentes
|
|
│ ├── ag-arquiteto/
|
|
│ │ └── persona.md ← identidade, escopo, responsabilidades
|
|
│ ├── ag-back/
|
|
│ │ ├── persona.md
|
|
│ │ └── rules/ ← rules específicas do agente
|
|
│ ├── ag-front/
|
|
│ │ ├── persona.md
|
|
│ │ ├── rules/
|
|
│ │ └── workflows/
|
|
│ ├── ag-testes/
|
|
│ ├── ag-deploy/
|
|
│ ├── ag-documentacao/
|
|
│ ├── ag-ux/
|
|
│ ├── ag-comercial/
|
|
│ ├── ag-agente/
|
|
│ └── ag-refatorar/
|
|
│ ├── persona.md
|
|
│ ├── rules/ ← refatoracao-segura, solid-compliance, design-patterns-pragmatico
|
|
│ ├── skills/ ← diagnosticar-code-smells
|
|
│ └── workflows/ ← refatorar-modulo
|
|
│
|
|
└── adaptadores/ ← conversores por plataforma LLM
|
|
├── antigravity/
|
|
│ └── gerar-agent-json.sh ← gera agent.json para o Antigravity
|
|
├── claude/
|
|
│ └── README.md ← instruções para migração futura
|
|
└── openai/
|
|
└── README.md ← instruções para migração futura
|
|
```
|
|
|
|
---
|
|
|
|
## Compatibilidade com outras LLMs
|
|
|
|
A estrutura foi projetada para ser **vendor-neutral**:
|
|
|
|
- `persona.md` + `global/rules/` + `agents/*/rules/` = **Markdown puro**, funciona com qualquer LLM
|
|
- `agent.json` = configuração específica do Antigravity, **gerada automaticamente** pelo script adaptador
|
|
- Para migrar para outra LLM: criar adaptador em `adaptadores/{nome}/` sem alterar o conhecimento
|
|
|
|
---
|
|
|
|
## Orquestração entre agentes
|
|
|
|
Consulte a skill `global/skills/orquestrar-agentes/SKILL.md` para o protocolo completo de colaboração.
|
|
|
|
Sequência padrão para uma nova feature:
|
|
|
|
```
|
|
@ag-arquiteto → @ag-back → @ag-front → @ag-testes → @ag-deploy
|
|
↕ ↕
|
|
@ag-refatorar @ag-ux
|
|
↓
|
|
@ag-documentacao → @ag-comercial
|
|
```
|
|
|
|
> `@ag-refatorar` pode ser acionado em qualquer ponto do fluxo quando código existente precisa ser melhorado antes de evoluir.
|
|
|
|
---
|
|
|
|
## Distribuição para módulos
|
|
|
|
Para copiar os artefatos do `.agent/` para um módulo do e-licencie:
|
|
|
|
```sh
|
|
sh .agent/atualizar-agente.sh
|
|
```
|
|
|
|
Para gerar/atualizar o `manifesto.json` após adicionar novos artefatos:
|
|
|
|
```sh
|
|
sh .agent/gerar-manifesto.sh
|
|
```
|