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 .agent/atualizar-agente.sh

Para gerar/atualizar o manifesto.json após adicionar novos artefatos:

sh .agent/gerar-manifesto.sh

4.5 KiB Raw Blame History