chore(agent): remover permissoes de commit da IA no projeto e wiki (apenas sugerir texto) e manter push automatico exclusivo no .agent
This commit is contained in:
parent
212d2578f4
commit
26a4f98dab
116 changed files with 1162 additions and 1315 deletions
30
README
30
README
|
|
@ -1,15 +1,15 @@
|
|||
# Esse projeto é a pasta .agent dos projetos da e-licencie
|
||||
# Framework Multiagente Polimórfico (.agent) — Ecossistema Azteca
|
||||
|
||||
Repositório central de conhecimento para os agentes de IA do ecossistema Azteca.
|
||||
Usado como **git submodule** `.agent` nos monorepos.
|
||||
Usado como **git submodule** `.agent` nos repositórios e monorepos do ecossistema.
|
||||
|
||||
---
|
||||
|
||||
## Premissas
|
||||
|
||||
1. **Polimórfico & Reutilizável** — o `.agent` é um submódulo genérico compartilhado entre múltiplos projetos do ecossistema
|
||||
1. **Polimórfico & Agnóstico ao Projeto** — o `.agent` é um submódulo genérico compartilhado entre múltiplos projetos do ecossistema, sem acoplamento fixo a nenhum módulo específico
|
||||
2. **Multiagente** — 11 agentes especializados com escopo e responsabilidades bem definidos
|
||||
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>/`
|
||||
3. **Personalização e Identidade Desacopladas via `memorias-ia/modulo.yml`** — toda informação referente ao módulo hospedeiro reside em `./memorias-ia/modulo.yml`, `./memorias-ia/`, `<modulo-wiki>/<modulo-id>/` e `<modulo-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,22 +18,23 @@ 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 **identidade e 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`, tendo `memorias-ia/modulo.yml` como fonte única da verdade:
|
||||
|
||||
```
|
||||
<projeto-pai>/
|
||||
├── memorias-ia/ ← Personalização & Identidade:
|
||||
│ ├── modulo.yml ← OBRIGATÓRIO: modulo-id, modulo-caminho, modulo-descricao e modulo-tipo
|
||||
│ ├── modulo.yml ← OBRIGATÓRIO: modulo-id, modulo-caminho, modulo-descricao, modulo-tipo, modulo-acesso, modulo-wiki
|
||||
│ ├── historico-acoes.md ← Índice central cumulativo de ações da IA
|
||||
│ └── sessao-*.md ← Histórico de ações e memórias de IA deste projeto
|
||||
├── PLANOS/ ← Fila de Planos Técnicos (Tester ➔ Dev):
|
||||
│ ├── pendente/ ← Planos criados por testers aguardando dev (/plano <instrução>)
|
||||
│ └── executado/ ← Planos implementados, testados e arquivados (/plano executar <slug>)
|
||||
│ └── executado/ ← Planos implementados, testados e arquivados (/plano.executar <slug>)
|
||||
├── .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
|
||||
│
|
||||
└── <base_projeto>/../wiki/ ← Aplicação VitePress com a documentação viva
|
||||
└── <modulo-wiki>/ ← Aplicação VitePress com a documentação viva (padrão: ../wiki/)
|
||||
├── <modulo-id>/ ← Personalização: Documentação com ACESSO DOS USUÁRIOS
|
||||
└── dev/<modulo-id>/ ← Personalização: Documentação técnica ACESSO INTERNO DEV
|
||||
```
|
||||
|
|
@ -44,7 +45,8 @@ 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)
|
||||
├── modulo.yml ← identificador mandatório do projeto (modulo-id, modulo-caminho, modulo-descricao, modulo-tipo, modulo-acesso, modulo-wiki)
|
||||
├── historico-acoes.md ← índice central de sessões e citações no código
|
||||
PLANOS/ ← fila de planos técnicos de implementação (Tester ➔ Dev)
|
||||
├── pendente/ ← gerados via /plano pelo tester em reviews
|
||||
└── executado/ ← arquivados após implementação pelo dev
|
||||
|
|
@ -54,6 +56,8 @@ PLANOS/ ← fila de planos técnicos de implementaç
|
|||
│ ├── INDICE ← índice navegável de toda documentação
|
||||
│ └── templates/ ← templates padronizados dos 6 pilares
|
||||
│ ├── modulo.yml.template ← identidade do módulo (memorias-ia/modulo.yml)
|
||||
│ ├── historico-acoes.md.template ← índice central de ações da IA (memorias-ia/historico-acoes.md)
|
||||
│ ├── sessao-memoria.md.template ← relato individual de sessão (memorias-ia/sessao-*.md)
|
||||
│ ├── 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)
|
||||
|
|
@ -67,6 +71,7 @@ PLANOS/ ← fila de planos técnicos de implementaç
|
|||
├── 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
|
||||
├── scripts/ ← utilitários de ciclo de vida, MinIO Paiol e Graphify
|
||||
│
|
||||
├── global/ ← herdado por TODOS os agentes
|
||||
│ ├── rules/ ← regras universais (identidade-modulo, ddd, etc.)
|
||||
|
|
@ -95,8 +100,8 @@ PLANOS/ ← fila de planos técnicos de implementaç
|
|||
|--------|--------|--------------|
|
||||
| `@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 |
|
||||
| `@front` | Frontend | Componentes, telas, composables, ajuda contextual `{componente}.ajuda.md` |
|
||||
| `@testes` | Testes | Testes unitários, integração, roteiros de QA e E2E via `agent-browser` |
|
||||
| `@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 |
|
||||
|
|
@ -117,7 +122,8 @@ git submodule update --init --recursive --remote
|
|||
# 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
|
||||
cp .agent/DOCUMENTACAO/templates/historico-acoes.md.template memorias-ia/historico-acoes.md
|
||||
# Preencher em memorias-ia/modulo.yml: modulo-id, modulo-caminho, modulo-descricao, modulo-tipo, modulo-acesso e modulo-wiki
|
||||
|
||||
# 3. Auditar a conformidade do setup
|
||||
bash .agent/validar-setup.sh
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue