From e827ab840d4c3c558e5fa99615658462d4f3e6db Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Thu, 18 Jun 2026 12:05:48 -0300 Subject: [PATCH] docs: atualizar readme com arquitetura multiagente v2 --- readme.md | 108 +++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 83 insertions(+), 25 deletions(-) diff --git a/readme.md b/readme.md index 043ea71..d4f4080 100644 --- a/readme.md +++ b/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 - - \ No newline at end of file +Para migrar de LLM: criar adaptador em `adaptadores/{nome}/` sem alterar o conhecimento. \ No newline at end of file