docs: atualizar readme com arquitetura multiagente v2

readme.md

@@ -1,50 +1,108 @@
-pasta .agent é uma estrutura basica que será incoporada aos diferetes modulo dos sistemas e-licencie
+# AGENT-IA — Base de Conhecimento dos Agentes Azteca
 
-Cada modulo terá suas individualidades e os  arquivos .agent desspo projeto serão copidaos para esse modulos 
+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.
 
-Premissao 1: Estrura atualziada com multiagente
+---
 
-Premissao 2: Capacidade de aprendixado ao longo da execução de cada modulo
+## Premissas
 
+1. **Multiagente** — 8 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
 
-## Agents que serão criados
+---
 
+## 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 8 agentes
+│   ├── ag-arquiteto/
+│   ├── ag-back/
+│   ├── ag-front/
+│   ├── ag-testes/
+│   ├── ag-deploy/
+│   ├── ag-documentacao/
+│   ├── ag-ux/
+│   └── ag-comercial/
+│
+└── adaptadores/                    ← conversores por plataforma LLM
+    ├── antigravity/                ← ativo
+    ├── claude/                     ← preparado (futuro)
+    └── openai/                     ← preparado (futuro)
+```
 
-### 01-Arquiteto - @ag-arquiteto
+---
 
-Responsável por compreender o contexto geral do projeto, analisar a problemática, definir a arquitetura do software e propor soluções técnicas alinhadas aos objetivos do produto.
+## Agentes disponíveis
 
-### 02-Back - @ag-back
+| 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 |
 
-Responsável pelo desenvolvimento do backend, implementação da lógica de negócio, regras de negócio, integrações, banco de dados, APIs e serviços internos.
+---
 
-### 03-Front - @ag-front
+## Usar em um projeto
 
-Responsável pelo desenvolvimento da interface do software, implementação das telas, fluxos de uso, integração com APIs e regras necessárias para a experiência do usuário.
+```sh
+# Adicionar como submodulo
+git submodule add git@git2.idz.one:publico/.agent.git .agent/base
 
-### 04-Testes - @ag-testes
+# Inicializar
+git submodule update --init --recursive
 
-Responsável pela elaboração de rotinas, cenários e critérios de testes, tanto para execução por humanos quanto por IAs, garantindo qualidade e confiabilidade do software.
+# Configurar o projeto
+cp .agent/base/manifesto-local.template.json .agent/manifesto-local.json
+# editar: definir "projeto" e extensões locais
 
-### 05-deploy - @ag-deploy
+# Sincronizar artefatos
+cp .agent/base/atualizar-agente.sh .agent/atualizar-agente.sh
+sh .agent/atualizar-agente.sh
+```
 
-Responsável pelo deploy, configuração de ambientes, automação de processos, programação e otimização de containers Docker, além do suporte à infraestrutura da aplicação.
+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.
 
-### 06-Documentação - @ag-documentacao
+Veja `EXTEND.md` para o guia completo de herança e customização.
 
-Responsável pela documentação do software, incluindo materiais de ajuda para usuários, guias de uso, documentação técnica e documentação de código para desenvolvedores.
+---
 
-### 07-UX - @ag-ux
+## Atualizar o base
 
-Responsável pelo design da experiência do usuário, organização das telas, fluxos de navegação, usabilidade e melhoria da interação com o sistema.
+```sh
+sh .agent/atualizar-agente.sh
+```
 
-### 08-Comercial - @ag-comercial
+---
 
-Responsável por apoiar o posicionamento comercial do software, criando conteúdos, argumentos, materiais e orientações para uso pelas equipes de vendas e marketing.
+## Compatibilidade com múltiplas LLMs
 
-### 09-agentes - @ag-agentes
+| 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 |
 
-Responsável por fazer a manutenção e evolução dos agentes do sistema, .global.md para todos os sistemas e .md para modulo específico
-
-  
+Para migrar de LLM: criar adaptador em `adaptadores/{nome}/` sem alterar o conhecimento.