AGENT-IA — Base de Conhecimento dos Agentes Azteca

Repositório central de conhecimento para os agentes de IA do ecossistema Azteca. Usado como git submodule nos módulos do e-licencie e demais projetos.

---

Premissas

1. Multiagente — 10 agentes especializados com escopo e responsabilidades bem definidos
2. Aprendizado contínuo — conhecimento evolui a cada sessão via workflow aprimorar-IA
3. Vendor-neutral — arquitetura em Markdown puro, compatível com qualquer LLM

---

Estrutura do repositório

.agent-ia/                          ← raiz do repositório (submodulo)
├── AGENTS.md                       ← ponto de entrada: como acionar agentes
├── EXTEND.md                       ← como projetos filhos herdam e estendem
├── manifesto.json                  ← inventário de todos os artefatos
├── manifesto-local.template.json   ← template para projetos filhos
├── gerar-manifesto.sh              ← gera manifesto.json via auto-discovery
├── atualizar-agente.sh             ← sincroniza inherited/ nos projetos filhos
├── tools.md                        ← ferramentas CLI recomendadas
├── verificar-linhas.sh             ← governance: limite de 250 linhas
│
├── global/                         ← herdado por TODOS os agentes
│   ├── rules/                      ← 7 regras universais
│   ├── workflows/                  ← 3 workflows globais
│   └── skills/                     ← 7 skills globais
│
├── agents/                         ← definição dos 10 agentes
│   ├── ag-arquiteto/
│   ├── ag-back/
│   ├── ag-front/
│   ├── ag-testes/
│   ├── ag-deploy/
│   ├── ag-documentacao/
│   ├── ag-ux/
│   ├── ag-comercial/
│   ├── ag-agente/
│   └── ag-refatorar/
│
└── adaptadores/                    ← conversores por plataforma LLM
    ├── antigravity/                ← ativo
    ├── claude/                     ← preparado (futuro)
    └── openai/                     ← preparado (futuro)

---

Agentes disponíveis

Handle	Agente	Especialidade
@ag-arquiteto	Arquiteto	Arquitetura, especificações, ADRs
@ag-back	Backend	APIs, banco de dados, filas, CRONs
@ag-front	Frontend	Vue 3, telas, composables, integração API
@ag-testes	Testes	Testes unitários, integração, roteiros de QA
@ag-deploy	Deploy	Docker, CI/CD, infraestrutura, ambientes
@ag-documentacao	Documentação	JSDoc, regras de negócio, guias de usuário
@ag-ux	UX	Fluxos de uso, usabilidade, mensagens de interface
@ag-comercial	Comercial	Propostas, marketing, Reels, orçamentos
@ag-agente	Agente de Agentes	Construção, melhoria e manutenção do ecossistema de agentes
@ag-refatorar	Refatoração	SOLID, Design Patterns GoF, code smells, refatoração segura

---

Usar em um projeto

# Adicionar como submodulo
git submodule add https://git2.idz.one/publico/.agent.git .agent/base

# Inicializar
git submodule update --init --recursive

# Configurar o projeto
cp .agent/base/manifesto-local.template.json .agent/manifesto-local.json
# editar: definir "projeto" e extensões locais

# Sincronizar artefatos
cp .agent/base/atualizar-agente.sh .agent/atualizar-agente.sh
sh .agent/atualizar-agente.sh

Cada projeto mantém sua própria pasta .agent/local/ com extensões específicas. O base em .agent/inherited/ é sincronizado automaticamente e nunca editado.

Veja EXTEND.md para o guia completo de herança e customização.

---

Atualizar o base

sh .agent/atualizar-agente.sh

---

Compatibilidade com múltiplas LLMs

Camada	Formato	Portabilidade
global/ + agents/*/persona.md	Markdown puro	✅ 100% — qualquer LLM
agents/*/agent.json	JSON Antigravity	🔄 Regenerável via adaptador
adaptadores/	Shell scripts	✅ Independente de LLM

Para migrar de LLM: criar adaptador em adaptadores/{nome}/ sem alterar o conhecimento.