119 lines
No EOL
5.5 KiB
Text
119 lines
No EOL
5.5 KiB
Text
# 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.
|
|
|
|
---
|
|
|
|
## Premissas
|
|
|
|
1. **Polimórfico & Reutilizável** — o `.agent` é um submódulo genérico compartilhado entre múltiplos projetos do ecossistema
|
|
2. **Multiagente** — 11 agentes especializados com escopo e responsabilidades bem definidos
|
|
3. **Personalização Desacoplada** — especificidades de cada projeto residem em `./memorias-ia/`, `../../wiki/<modulo>/` e `../../wiki/dev/<modulo>/`
|
|
4. **Aprendizado contínuo** — conhecimento evolui a cada sessão via workflow `/aprimora-ia`
|
|
5. **Vendor-neutral** — arquitetura em Markdown puro, compatível com qualquer LLM
|
|
6. **Documentation-Driven (DDD)** — documentação precede implementação nos 6 pilares
|
|
|
|
---
|
|
|
|
## Arquitetura Polimórfica e Locais de Personalização
|
|
|
|
O repositório `.agent` fornece a estrutura genérica de inteligência (regras universais, personas, workflows e skills). A **personalização de cada projeto** é armazenada estritamente fora do submódulo `.agent`:
|
|
|
|
```
|
|
<projeto-pai>/
|
|
├── memorias-ia/ ← Personalização: Memória das ações da IA e sessões deste projeto
|
|
├── .agent/ ← Polimórfico: Submódulo genérico compartilhado entre múltiplos projetos
|
|
│ ├── DOCUMENTACAO/ ← Hub DDD: Manifesto e templates padronizados
|
|
│ ├── global/ ← Rules, workflows e skills globais
|
|
│ └── agents/ ← Personas e configurações dos 11 agentes
|
|
│
|
|
└── ../../wiki/ ← Aplicação VitePress com a documentação viva
|
|
├── <modulo>/ ← Personalização: Documentação com ACESSO DOS USUÁRIOS
|
|
└── dev/<modulo>/ ← Personalização: Documentação técnica com ACESSO INTERNO DEV (regras, ADRs)
|
|
```
|
|
|
|
---
|
|
|
|
## Estrutura do repositório
|
|
|
|
```
|
|
memorias-ia/ ← armazenamento de memórias das ações da IA (na raiz do projeto pai)
|
|
.agent/ ← raiz do repositório de agentes (submódulo)
|
|
├── DOCUMENTACAO/ ← hub DDD — matriz canônica dos 6 pilares
|
|
│ ├── README ← manifesto DDD: princípios e workflow
|
|
│ ├── INDICE ← índice navegável de toda documentação
|
|
│ ├── arquitetura/ ← decisões técnicas (ADRs)
|
|
│ ├── modulos/ ← domínio e glossário por módulo
|
|
│ ├── regras-negocio/ ← regras de negócio documentadas
|
|
│ ├── contratos/ ← contratos de API e schemas
|
|
│ └── fluxos/ ← jornadas do usuário
|
|
├── README ← este arquivo
|
|
├── TOOLS ← ferramentas CLI recomendadas
|
|
├── manifesto.json ← inventário de todos os artefatos
|
|
├── manifesto-local.template.json ← template para projetos filhos
|
|
├── verificar-linhas.sh ← governance: limite de 250 linhas
|
|
│
|
|
├── global/ ← herdado por TODOS os agentes
|
|
│ ├── rules/ ← regras universais
|
|
│ ├── workflows/ ← workflows globais
|
|
│ └── skills/ ← skills globais
|
|
│
|
|
├── agents/ ← definição dos 11 agentes
|
|
│ ├── arquiteto/
|
|
│ ├── back/
|
|
│ ├── front/
|
|
│ ├── testes/
|
|
│ ├── deploy/
|
|
│ ├── documentacao/
|
|
│ ├── ux/
|
|
│ ├── comercial/
|
|
│ ├── agente/
|
|
│ ├── refatorar/
|
|
│ └── land/
|
|
```
|
|
|
|
---
|
|
|
|
## Agentes disponíveis
|
|
|
|
| Handle | Agente | Especialidade |
|
|
|--------|--------|--------------|
|
|
| `@arquiteto` | Arquiteto | Arquitetura, especificações, ADRs |
|
|
| `@back` | Backend | APIs, banco de dados, filas, CRONs, rota `/llm.md` |
|
|
| `@front` | Frontend | Vue 3, telas, composables, ajuda contextual `modalX.ajuda.md` |
|
|
| `@testes` | Testes | Testes unitários, integração, roteiros de QA |
|
|
| `@deploy` | Deploy | Docker, CI/CD, infraestrutura, ambientes |
|
|
| `@documentacao` | Documentação | Guardião dos 6 pilares (código, `.ajuda.md`, wiki usuário, wiki dev, `/llm.md`, `memorias-ia/`) |
|
|
| `@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 |
|
|
|
|
---
|
|
|
|
## 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
|
|
```
|
|
|
|
Cada projeto mantém sua própria pasta `.agent/local/` com extensões específicas.
|
|
|
|
---
|
|
|
|
## Compatibilidade com múltiplas LLMs
|
|
|
|
| Camada | Formato | Portabilidade |
|
|
|--------|---------|---------------|
|
|
| `global/` + `agents/*/persona` | Markdown puro | ✅ 100% — qualquer LLM |
|
|
| `agents/*/agent.json` | JSON Antigravity | ✅ Configuração nativa | |