# .agent — Base de Conhecimento dos Agentes Azteca

Repositório central de conhecimento para os agentes de IA do ecossistema Azteca.
Usado como **git submodule** `.agent` nos monorepos.

---

## 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
4. **Sem extensões** — artefatos de conhecimento não possuem extensão de arquivo

---

## Estrutura do repositório

```
.agent/                             ← raiz do repositório (submodulo)
├── AGENTS                          ← ponto de entrada: como acionar agentes
├── EXTEND                          ← como projetos filhos herdam e estendem
├── README                          ← este arquivo
├── TOOLS                           ← ferramentas CLI recomendadas
├── 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
├── verificar-linhas.sh             ← governance: limite de 250 linhas
│
├── global/                         ← herdado por TODOS os agentes
│   ├── rules/                      ← 11 regras universais
│   ├── workflows/                  ← 4 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

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

# Inicializar
git submodule update --init --recursive

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

# Sincronizar artefatos
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` para o guia completo de herança e customização.

---

## Atualizar o base

```sh
sh .agent/atualizar-agente.sh
```

---

## Compatibilidade com múltiplas LLMs

| Camada | Formato | Portabilidade |
|--------|---------|---------------|
| `global/` + `agents/*/persona` | 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.