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

aplimoramento de agent

Browse source
This commit is contained in:
Luiz Silva 2026-09-02 10:23:53 -03:00
parent b361f25955
commit f597436be3
83 changed files with 1312 additions and 574 deletions
Download patch file Download diff file Expand all files Collapse all files

56
README
View file

@ -9,7 +9,7 @@ Usado como **git submodule** `.agent` nos monorepos.
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>/`
3. **Personalização e Identidade Desacopladas** — especificidades e identificação de cada projeto residem em `./memorias-ia/modulo.yml`, `./memorias-ia/`, `<base_projeto>/../wiki/<modulo-id>/` e `<base_projeto>/../wiki/dev/<modulo-id>/`
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
@ -18,19 +18,21 @@ Usado como **git submodule** `.agent` nos monorepos.
## 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`:
O repositório `.agent` fornece a estrutura genérica de inteligência (regras universais, personas, workflows e skills). A **identidade e 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
├── memorias-ia/ ← Personalização & Identidade:
│ ├── modulo.yml ← OBRIGATÓRIO: modulo-id, modulo-caminho, modulo-descricao e modulo-tipo
│ └── sessao-*.md ← Histórico de ações e memórias de IA deste projeto
├── .agent/ ← Polimórfico: Submódulo genérico compartilhado
│ ├── 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)
└── <base_projeto>/../wiki/ ← Aplicação VitePress com a documentação viva
├── <modulo-id>/ ← Personalização: Documentação com ACESSO DOS USUÁRIOS
└── dev/<modulo-id>/ ← Personalização: Documentação técnica ACESSO INTERNO DEV
```
---
@ -39,23 +41,28 @@ O repositório `.agent` fornece a estrutura genérica de inteligência (regras u
```
memorias-ia/ ← armazenamento de memórias das ações da IA (na raiz do projeto pai)
├── modulo.yml ← identificador mandatório do projeto (modulo-id, modulo-caminho, modulo-descricao, modulo-tipo)
.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
│ └── templates/ ← templates padronizados dos 6 pilares
│ ├── modulo.yml.template ← identidade do módulo (memorias-ia/modulo.yml)
│ ├── modulo-dominio.md.template ← domínio e glossário (Wiki Usuário/Dev)
│ ├── regra-negocio.md.template ← regras de negócio (Wiki Dev)
│ ├── adr.md.template ← decisões técnicas (ADRs na Wiki Dev)
│ ├── ajuda-tela.md.template ← ajuda contextual na UI (Pilar 2)
│ ├── contrato-api.md.template ← contratos de endpoints e schemas
│ └── fluxo-usuario.md.template ← fluxos e jornadas de 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
├── validar-setup.sh ← governance: auditoria automática de setup multi-projeto
│
├── global/ ← herdado por TODOS os agentes
│ ├── rules/ ← regras universais
│ ├── rules/ ← regras universais (identidade-modulo, ddd, etc.)
│ ├── workflows/ ← workflows globais
│ └── skills/ ← skills globais
│
@ -93,21 +100,26 @@ memorias-ia/ ← armazenamento de memórias das ações d
---
## Usar em um projeto
## Usar em um novo projeto (Onboarding em 4 passos)
```sh
# Adicionar como submodulo
git submodule add https://git2.idz.one/publico/.agent.git .agent
# Inicializar
# 1. Adicionar o submódulo
git submodule add git@github.com:azteca-sistemas/agent-ia.git .agent
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
# 2. Criar obrigatoriamente a identidade do módulo
mkdir -p memorias-ia
cp .agent/DOCUMENTACAO/templates/modulo.yml.template memorias-ia/modulo.yml
# Preencher: modulo-id, modulo-caminho, modulo-descricao e modulo-tipo
# 3. Auditar a conformidade do setup
bash .agent/validar-setup.sh
# 4. (Opcional) Criar camada de extensões exclusivas deste projeto
mkdir -p .agent-local/rules .agent-local/skills .agent-local/workflows
```
Cada projeto mantém sua própria pasta `.agent/local/` com extensões específicas.
> ℹ️ **Hierarquia de Precedência:** Artefatos em `.agent-local/` sobrescrevem automaticamente os equivalentes do submódulo `.agent/` (`.agent-local/ > .agent/`).
---