refactor: remover extensões .md de todos os artefatos — v3.0.0
- 55 arquivos .md renomeados para sem extensão - Convenção: artefatos de conhecimento sem extensão, scripts (.sh) e dados (.json) mantêm extensão - Scripts atualizados: gerar-manifesto.sh, atualizar-agente.sh, atualizar-agente.global.sh, gerar-agent-json.sh, verificar-linhas.sh - Documentação reescrita: AGENTS, README, EXTEND para refletir uso como submodule .agent direto - manifesto.json regenerado v3.0.0 - Todas as referências internas entre artefatos atualizadas BREAKING CHANGE: arquivos não possuem mais extensão .md
This commit is contained in:
parent
22023df81e
commit
bf9be375e2
58 changed files with 506 additions and 514 deletions
112
readme.md
112
readme.md
|
|
@ -1,112 +0,0 @@
|
|||
# AGENT-IA — Base de Conhecimento dos Agentes Azteca
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Premissas
|
||||
|
||||
1. **Multiagente** — 10 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
|
||||
|
||||
---
|
||||
|
||||
## 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 10 agentes
|
||||
│ ├── ag-arquiteto/
|
||||
│ ├── ag-back/
|
||||
│ ├── ag-front/
|
||||
│ ├── ag-testes/
|
||||
│ ├── ag-deploy/
|
||||
│ ├── ag-documentacao/
|
||||
│ ├── ag-ux/
|
||||
│ ├── ag-comercial/
|
||||
│ ├── ag-agente/
|
||||
│ └── ag-refatorar/
|
||||
│
|
||||
└── adaptadores/ ← conversores por plataforma LLM
|
||||
├── antigravity/ ← ativo
|
||||
├── claude/ ← preparado (futuro)
|
||||
└── openai/ ← preparado (futuro)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes disponíveis
|
||||
|
||||
| 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 |
|
||||
| `@ag-agente` | Agente de Agentes | Construção, melhoria e manutenção do ecossistema de agentes |
|
||||
| `@ag-refatorar` | Refatoração | SOLID, Design Patterns GoF, code smells, refatoração segura |
|
||||
|
||||
---
|
||||
|
||||
## Usar em um projeto
|
||||
|
||||
```sh
|
||||
# Adicionar como submodulo
|
||||
git submodule add https://git2.idz.one/publico/.agent.git .agent/base
|
||||
|
||||
# Inicializar
|
||||
git submodule update --init --recursive
|
||||
|
||||
# Configurar o projeto
|
||||
cp .agent/base/manifesto-local.template.json .agent/manifesto-local.json
|
||||
# editar: definir "projeto" e extensões locais
|
||||
|
||||
# Sincronizar artefatos
|
||||
cp .agent/base/atualizar-agente.sh .agent/atualizar-agente.sh
|
||||
sh .agent/atualizar-agente.sh
|
||||
```
|
||||
|
||||
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.
|
||||
|
||||
Veja `EXTEND.md` para o guia completo de herança e customização.
|
||||
|
||||
---
|
||||
|
||||
## Atualizar o base
|
||||
|
||||
```sh
|
||||
sh .agent/atualizar-agente.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Compatibilidade com múltiplas LLMs
|
||||
|
||||
| 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 |
|
||||
|
||||
Para migrar de LLM: criar adaptador em `adaptadores/{nome}/` sem alterar o conhecimento.
|
||||
Loading…
Add table
Add a link
Reference in a new issue