versão 1

AGENTS.md

@@ -0,0 +1,117 @@
+# 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 |
+
+---
+
+## 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/                   ← 7 rules globais
+│   ├── workflows/               ← 3 workflows globais
+│   └── skills/                  ← 7 skills globais (incluindo orquestrar-agentes)
+│
+├── agents/                      ← definições dos 8 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/
+│
+└── 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-ux
+                               ↓
+                    @ag-documentacao → @ag-comercial
+```
+
+---
+
+## 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
+```