publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

otimização do agent para docuemntação

Browse source
This commit is contained in:
Luiz Silva 2026-09-01 16:55:01 -03:00
parent 1a25edc274
commit 890eddc464
60 changed files with 1807 additions and 1435 deletions
Download patch file Download diff file Expand all files Collapse all files

43
README
View file

@ -7,20 +7,40 @@ Usado como **git submodule** `.agent` nos monorepos.
## Premissas
1. **Multiagente** — 12 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
5. **Documentation-Driven** — documentação precede implementação; DOCUMENTACAO/ é a fonte de verdade
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
```
.memoria-ia/ ← armazenamento de memórias do projeto (mesmo nível do .agent, versionado pelo pai)
.agent/ ← raiz do repositório (submodulo)
├── DOCUMENTACAO/ ← hub DDD — documentação precede código
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)
@ -33,7 +53,6 @@ Usado como **git submodule** `.agent` nos monorepos.
├── manifesto.json ← inventário de todos os artefatos
├── manifesto-local.template.json ← template para 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
@ -61,11 +80,11 @@ Usado como **git submodule** `.agent` nos monorepos.
| Handle | Agente | Especialidade |
|--------|--------|--------------|
| `@arquiteto` | Arquiteto | Arquitetura, especificações, ADRs |
| `@back` | Backend | APIs, banco de dados, filas, CRONs |
| `@front` | Frontend | Vue 3, telas, composables, integração API |
| `@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 | JSDoc, regras de negócio, guias de usuário |
| `@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 |