refatoração dos agents

This commit is contained in:
Luiz Silva 2026-08-10 16:08:03 -03:00
parent 97acfb07df
commit 1177e31e56
104 changed files with 1068 additions and 3995 deletions

79
README
View file

@ -1,4 +1,4 @@
# .agent — Base de Conhecimento dos Agentes Azteca
# Esse projeto é a pasta .agent dos projetos da e-licencie
Repositório central de conhecimento para os agentes de IA do ecossistema Azteca.
Usado como **git submodule** `.agent` nos monorepos.
@ -17,39 +17,32 @@ Usado como **git submodule** `.agent` nos monorepos.
## Estrutura do repositório
```
.memoria-ia/ ← armazenamento de memórias do projeto (mesmo nível do .agent, versionado pelo pai)
.agent/ ← raiz do repositório (submodulo)
├── 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
├── memory/ ← armazenamento de evoluções da IA (versionado pelo submódulo .agent)
│
├── global/ ← herdado por TODOS os agentes
│ ├── rules/ ← regras universais
│ ├── workflows/ ← workflows globais
│ └── skills/ ← skills globais
│
├── agents/ ← definição dos 12 agentes
│ ├── ag-arquiteto/
│ ├── ag-back/
│ ├── ag-front/
│ ├── ag-testes/
│ ├── ag-deploy/
│ ├── ag-documentacao/
│ ├── ag-ux/
│ ├── ag-comercial/
│ ├── ag-agente/
│ ├── ag-refatorar/
│ ├── ag-memoria/
│ └── ag-land/
│
└── adaptadores/ ← conversores por plataforma LLM
├── antigravity/ ← ativo (Antigravity 2.0)
├── claude/ ← preparado (futuro)
└── openai/ ← preparado (futuro)
├── agents/ ← definição dos 11 agentes
│ ├── arquiteto/
│ ├── back/
│ ├── front/
│ ├── testes/
│ ├── deploy/
│ ├── documentacao/
│ ├── ux/
│ ├── comercial/
│ ├── agente/
│ ├── refatorar/
│ └── land/
```
---
@ -58,18 +51,17 @@ Usado como **git submodule** `.agent` nos monorepos.
| 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` | Arquiteto de Agentes | Arquitetura, governança e evolução do ecossistema multiagente |
| `@ag-refatorar` | Refatoração | SOLID, Design Patterns GoF, code smells, refatoração segura |
| `@ag-memoria` | Guardião da Memória | Gestão de conhecimento corporativo, registro e resgate de histórico na Memória Azteca |
| `@ag-land` | Landing Pages & Sites | Criação de sites, landing pages de alta conversão, copywriting B2B/B2G e CTAs |
| `@arquiteto` | Arquiteto | Arquitetura, especificações, ADRs |
| `@back` | Backend | APIs, banco de dados, filas, CRONs |
| `@front` | Frontend | Vue 3, telas, composables, integração API |
| `@testes` | Testes | Testes unitários, integração, roteiros de QA |
| `@deploy` | Deploy | Docker, CI/CD, infraestrutura, ambientes |
| `@documentacao` | Documentação | JSDoc, regras de negócio, guias de usuário |
| `@ux` | UX | Fluxos de uso, usabilidade, mensagens de interface |
| `@comercial` | Comercial | Propostas, marketing, Reels, orçamentos |
| `@agente` | Arquiteto de Agentes | Arquitetura, governança e evolução do ecossistema multiagente |
| `@refatorar` | Refatoração | SOLID, Design Patterns GoF, code smells, refatoração segura |
| `@land` | Landing Pages & Sites | Criação de sites, landing pages de alta conversão, copywriting B2B/B2G e CTAs |
---
@ -85,23 +77,9 @@ 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
```
---
@ -110,7 +88,4 @@ sh .agent/atualizar-agente.sh
| 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.
| `agents/*/agent.json` | JSON Antigravity | ✅ Configuração nativa |