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
|
|
@ -30,15 +30,15 @@ Enquanto os outros agentes trabalham **no** produto, você trabalha **no** siste
|
|||
## Escopo de Atuação
|
||||
|
||||
- Repositório AGENT-IA (`global/`, `agents/`, `adaptadores/`)
|
||||
- Personas de agentes (`agents/*/persona.md`)
|
||||
- Personas de agentes (`agents/*/persona`)
|
||||
- Rules, workflows e skills (globais e por agente)
|
||||
- Scripts de governança (`gerar-manifesto.sh`, `atualizar-agente.sh`, `verificar-linhas.sh`)
|
||||
- Adaptadores por plataforma LLM
|
||||
- Manifesto e documentação do ecossistema (`AGENTS.md`, `EXTEND.md`, `readme.md`)
|
||||
- Manifesto e documentação do ecossistema (`AGENTS`, `EXTEND`, `README`)
|
||||
|
||||
## Responsabilidades
|
||||
|
||||
1. **Criar novos agentes** — escrever `persona.md` completo e coerente com os padrões estabelecidos
|
||||
1. **Criar novos agentes** — escrever `persona` completo e coerente com os padrões estabelecidos
|
||||
2. **Melhorar agentes existentes** — revisar e atualizar personas com base em feedbacks e boas práticas
|
||||
3. **Organizar artefatos** — garantir que rules, workflows e skills estejam no lugar certo (global vs agente específico)
|
||||
4. **Eliminar redundâncias** — identificar e remover duplicações entre artefatos
|
||||
|
|
@ -50,7 +50,7 @@ Enquanto os outros agentes trabalham **no** produto, você trabalha **no** siste
|
|||
|
||||
## Padrões obrigatórios que deve conhecer
|
||||
|
||||
### Frontmatter de `persona.md`
|
||||
### Frontmatter de `persona`
|
||||
```yaml
|
||||
---
|
||||
name: ag-nome
|
||||
|
|
@ -121,8 +121,8 @@ Antes de criar, verificar:
|
|||
- [ ] O escopo é claramente diferente dos 8 agentes existentes?
|
||||
- [ ] A persona tem: Identidade, Escopo, Responsabilidades, Restrições, Colaborações, Checklist?
|
||||
- [ ] Está claro com quais agentes ele colabora (recebe de / entrega para)?
|
||||
- [ ] `AGENTS.md` foi atualizado?
|
||||
- [ ] `readme.md` foi atualizado?
|
||||
- [ ] `AGENTS` foi atualizado?
|
||||
- [ ] `README` foi atualizado?
|
||||
- [ ] `manifesto.json` foi regerado?
|
||||
|
||||
## Manutenção periódica
|
||||
|
|
@ -161,9 +161,9 @@ Exemplos de divergência a detectar:
|
|||
**Como verificar:**
|
||||
```sh
|
||||
# Buscar padrões comuns entre personas
|
||||
grep -r "NUNCA" agents/*/persona.md
|
||||
grep -r "NÃO " agents/*/persona.md
|
||||
grep -r "sempre" agents/*/persona.md
|
||||
grep -r "NUNCA" agents/*/persona
|
||||
grep -r "NÃO " agents/*/persona
|
||||
grep -r "sempre" agents/*/persona
|
||||
```
|
||||
Ler os resultados comparando se as restrições e permissões são coerentes entre si.
|
||||
|
||||
|
|
@ -225,7 +225,7 @@ Algumas aparentes sobreposições são **intencionais**:
|
|||
- [ ] Referências cruzadas são válidas?
|
||||
- [ ] Não há duplicações entre global e agente específico?
|
||||
- [ ] `manifesto.json` foi regerado (`sh gerar-manifesto.sh`)?
|
||||
- [ ] `AGENTS.md` e `readme.md` refletem a mudança?
|
||||
- [ ] `AGENTS` e `README` refletem a mudança?
|
||||
- [ ] Mudanças foram commitadas com mensagem descritiva?
|
||||
|
||||
## Checklist de auditoria de consistência (executar após criar/alterar personas)
|
||||
|
|
@ -247,4 +247,4 @@ Todo agente ao revisar código deve garantir que feedbacks importantes não fiqu
|
|||
- [ ] **Backend:** erros internos são traduzidos antes de chegar ao cliente? Stack trace nunca vaza para o frontend?
|
||||
- [ ] **Fila (se aplicável):** há handler configurado para `failed` e `error` nos jobs? Falhas de jobs são registradas com jobId, tentativas e payload relevante?
|
||||
|
||||
> Referência: `global/rules/feedback-visivel.md`
|
||||
> Referência: `global/rules/feedback-visivel`
|
||||
|
|
@ -10,7 +10,7 @@ updatedAt: "2026-06-01"
|
|||
|
||||
Este workflow gera uma descrição comercial de funcionalidades ou do sistema completo, escrita na pasta `./COMERCIAL/`. Cada módulo ou funcionalidade gera um arquivo separado com o padrão `./COMERCIAL/<nome-do-modulo>.md`.
|
||||
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.md`) em toda produção textual deste workflow.
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural`) em toda produção textual deste workflow.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -138,7 +138,7 @@ O arquivo `./COMERCIAL/<nome-do-modulo>.md` deve seguir esta estrutura:
|
|||
|
||||
## Referências
|
||||
|
||||
- Rule: `global/rules/escrita-natural.md` (padrão obrigatório de redação)
|
||||
- Workflow: `agents/ag-comercial/workflows/orcamento.md` (texto para documentos de orçamento e proposta — apresentação + lista de funcionalidades)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing.md` (peças de marketing digital — LinkedIn, Instagram, WhatsApp, E-mail)
|
||||
- Workflow: `global/workflows/otimizar-codigos.md` (para documentação técnica, não comercial)
|
||||
- Rule: `global/rules/escrita-natural` (padrão obrigatório de redação)
|
||||
- Workflow: `agents/ag-comercial/workflows/orcamento` (texto para documentos de orçamento e proposta — apresentação + lista de funcionalidades)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing` (peças de marketing digital — LinkedIn, Instagram, WhatsApp, E-mail)
|
||||
- Workflow: `global/workflows/otimizar-codigos` (para documentação técnica, não comercial)
|
||||
|
|
@ -10,7 +10,7 @@ updatedAt: "2026-06-01"
|
|||
|
||||
Este workflow gera peças de marketing digital prontas para uso em canais como LinkedIn, Instagram, WhatsApp e E-mail. O resultado é salvo na pasta `./COMERCIAL/` junto ao arquivo comercial do módulo correspondente, ou em arquivo separado `./COMERCIAL/<nome-do-modulo>-marketing.md`.
|
||||
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.md`) em toda produção textual deste workflow.
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural`) em toda produção textual deste workflow.
|
||||
|
||||
O agente deve atuar como **especialista em marketing digital voltado para o setor do produto (venda entre empresas)**, aplicando técnicas comprovadas de texto persuasivo e engajamento.
|
||||
|
||||
|
|
@ -205,5 +205,5 @@ O resultado deve ser salvo em `./COMERCIAL/<nome-do-modulo>-marketing.md` ou adi
|
|||
|
||||
## Referências
|
||||
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial.md` (gera os blocos A e B que alimentam o marketing)
|
||||
- Rule: `global/rules/escrita-natural.md` (padrão obrigatório de redação)
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial` (gera os blocos A e B que alimentam o marketing)
|
||||
- Rule: `global/rules/escrita-natural` (padrão obrigatório de redação)
|
||||
|
|
@ -10,7 +10,7 @@ updatedAt: "2026-06-01"
|
|||
|
||||
Este workflow gera textos prontos para **copiar e colar dentro de documentos de orçamento e propostas comerciais**. O resultado é salvo na pasta `./COMERCIAL/` com o sufixo `-orcamento` (ex: `./COMERCIAL/<nome-do-modulo>-orcamento.md`).
|
||||
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.md`) em toda produção textual deste workflow.
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural`) em toda produção textual deste workflow.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -129,6 +129,6 @@ se aplicável, legislação ou norma relevante citada por extenso.]
|
|||
|
||||
## Referências
|
||||
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial.md` (descrição comercial detalhada — Resumo e Detalhamento)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing.md` (peças de marketing digital)
|
||||
- Rule: `global/rules/escrita-natural.md` (padrão obrigatório de redação)
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial` (descrição comercial detalhada — Resumo e Detalhamento)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing` (peças de marketing digital)
|
||||
- Rule: `global/rules/escrita-natural` (padrão obrigatório de redação)
|
||||
|
|
@ -10,7 +10,7 @@ updatedAt: "2026-06-01"
|
|||
|
||||
Este workflow gera **cadeias de roteiros de Reels** (vídeos curtos de 30 a 60 segundos) organizados por tema. Os roteiros são escritos em tom provocativo, informal e direto — prontos para gravar falando para a câmera ou com narração em off. O resultado é salvo em `./COMERCIAL/<nome-do-modulo>-reels.md`.
|
||||
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.md`) em toda produção textual deste workflow.
|
||||
É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural`) em toda produção textual deste workflow.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -199,6 +199,6 @@ O arquivo `./COMERCIAL/<nome-do-modulo>-reels.md` deve seguir esta estrutura:
|
|||
|
||||
## Referências
|
||||
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial.md` (descrição comercial detalhada — base de contexto)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing.md` (peças de marketing por canal)
|
||||
- Rule: `global/rules/escrita-natural.md` (padrão obrigatório de redação)
|
||||
- Workflow: `agents/ag-comercial/workflows/comercial` (descrição comercial detalhada — base de contexto)
|
||||
- Workflow: `agents/ag-comercial/workflows/marketing` (peças de marketing por canal)
|
||||
- Rule: `global/rules/escrita-natural` (padrão obrigatório de redação)
|
||||
|
|
@ -38,8 +38,8 @@ O script sincroniza `.agent/inherited/` com os artefatos do `base/`, sem tocar e
|
|||
Confirmar que a estrutura está íntegra:
|
||||
|
||||
```bash
|
||||
echo "=== Herdados ===" && find .agent/inherited/ -name "*.md" | sort
|
||||
echo "=== Locais ===" && find .agent/local/ -name "*.md" | sort 2>/dev/null || echo "(vazio)"
|
||||
echo "=== Herdados ===" && find .agent/inherited/ -type f | sort
|
||||
echo "=== Locais ===" && find .agent/local/ -type f | sort 2>/dev/null || echo "(vazio)"
|
||||
```
|
||||
|
||||
### 4. Revisar mudanças (quando aplicável)
|
||||
|
|
@ -37,7 +37,7 @@ Você é o agente responsável por tornar o conhecimento do ecossistema Azteca a
|
|||
1. Criar e manter arquivos `.regras-negocio.md` para módulos com lógica complexa
|
||||
2. Escrever JSDoc em funções e serviços compartilhados
|
||||
3. Criar guias de ajuda para usuários finais (módulo de ajuda contextual)
|
||||
4. Manter o `readme.md` e documentação do projeto atualizada
|
||||
4. Manter o `README` e documentação do projeto atualizada
|
||||
5. Documentar APIs internas (contratos de rotas, parâmetros, retornos)
|
||||
|
||||
## Restrições
|
||||
|
|
@ -82,5 +82,5 @@ Sem estes padrões, componentes perdem inferência de tipos, lógica fica inaudi
|
|||
|
||||
## Referências
|
||||
|
||||
- Rule: `global/rules/limite-linhas.md`
|
||||
- Rule: `global/rules/typescript-sem-any.md`
|
||||
- Rule: `global/rules/limite-linhas`
|
||||
- Rule: `global/rules/typescript-sem-any`
|
||||
|
|
@ -185,5 +185,5 @@ Caso contrário, seguir os passos acima para criar a primeira implementação.
|
|||
|
||||
## Referências
|
||||
|
||||
- Workflow: `global/workflows/otimizar-codigos.md`
|
||||
- Skill: `global/skills/documentar-decisao-tecnica/SKILL.md` (para decisões que geram fluxogramas)
|
||||
- Workflow: `global/workflows/otimizar-codigos`
|
||||
- Skill: `global/skills/documentar-decisao-tecnica/SKILL` (para decisões que geram fluxogramas)
|
||||
|
|
@ -196,7 +196,7 @@ Este repositório é consumido como **git submodule** em `.agent/base/` dentro d
|
|||
| Rules globais (herdadas) | `.agent/base/global/rules/` |
|
||||
| Workflows globais (herdados) | `.agent/base/global/workflows/` |
|
||||
| Skills globais (herdadas) | `.agent/base/global/skills/` |
|
||||
| Personas dos agentes | `.agent/base/agents/*/persona.md` |
|
||||
| Personas dos agentes | `.agent/base/agents/*/persona` |
|
||||
| Rules locais do projeto | `.agent/local/rules/` |
|
||||
| Workflows locais do projeto | `.agent/local/workflows/` |
|
||||
| Skills locais do projeto | `.agent/local/skills/` |
|
||||
|
|
@ -67,4 +67,4 @@ Padrões aplicados sem critério geram código mais complexo sem benefício prop
|
|||
|
||||
- Alexander Shvets — "Mergulho nos Padrões de Projeto" (Refactoring.Guru)
|
||||
- GoF — "Design Patterns: Elements of Reusable Object-Oriented Software"
|
||||
- Persona: `agents/ag-refatorar/persona.md`
|
||||
- Persona: `agents/ag-refatorar/persona`
|
||||
|
|
@ -53,4 +53,4 @@ Sem esta regra, refatorações introduzem regressões silenciosas que só são d
|
|||
## Referências
|
||||
|
||||
- Martin Fowler — "Refactoring: Improving the Design of Existing Code"
|
||||
- Persona: `agents/ag-refatorar/persona.md`
|
||||
- Persona: `agents/ag-refatorar/persona`
|
||||
|
|
@ -85,4 +85,4 @@ Código que viola SOLID se torna cada vez mais caro de manter: cada mudança exi
|
|||
|
||||
- Robert C. Martin — "Agile Software Development, Principles, Patterns, and Practices"
|
||||
- Refactoring.Guru — https://refactoring.guru/pt-br/design-patterns
|
||||
- Persona: `agents/ag-refatorar/persona.md`
|
||||
- Persona: `agents/ag-refatorar/persona`
|
||||
|
|
@ -139,7 +139,7 @@ Produzir relatório no formato:
|
|||
|
||||
## Referências
|
||||
|
||||
- Persona: `agents/ag-refatorar/persona.md`
|
||||
- Rule: `agents/ag-refatorar/rules/solid-compliance.md`
|
||||
- Rule: `agents/ag-refatorar/rules/design-patterns-pragmatico.md`
|
||||
- Persona: `agents/ag-refatorar/persona`
|
||||
- Rule: `agents/ag-refatorar/rules/solid-compliance`
|
||||
- Rule: `agents/ag-refatorar/rules/design-patterns-pragmatico`
|
||||
- Refactoring.Guru — https://refactoring.guru/pt-br/refactoring/smells
|
||||
|
|
@ -127,8 +127,8 @@ refactor(<módulo>): <técnica aplicada>
|
|||
|
||||
## Referências
|
||||
|
||||
- Skill: `agents/ag-refatorar/skills/diagnosticar-code-smells/SKILL.md`
|
||||
- Rule: `agents/ag-refatorar/rules/refatoracao-segura.md`
|
||||
- Rule: `agents/ag-refatorar/rules/solid-compliance.md`
|
||||
- Rule: `agents/ag-refatorar/rules/design-patterns-pragmatico.md`
|
||||
- Workflow global: `global/workflows/otimizar-codigos.md`
|
||||
- Skill: `agents/ag-refatorar/skills/diagnosticar-code-smells/SKILL`
|
||||
- Rule: `agents/ag-refatorar/rules/refatoracao-segura`
|
||||
- Rule: `agents/ag-refatorar/rules/solid-compliance`
|
||||
- Rule: `agents/ag-refatorar/rules/design-patterns-pragmatico`
|
||||
- Workflow global: `global/workflows/otimizar-codigos`
|
||||
|
|
@ -82,7 +82,7 @@ Este repositório é consumido como **git submodule** em `.agent/base/` dentro d
|
|||
| Rules globais (herdadas) | `.agent/base/global/rules/` |
|
||||
| Workflows globais (herdados) | `.agent/base/global/workflows/` |
|
||||
| Skills globais (herdadas) | `.agent/base/global/skills/` |
|
||||
| Personas dos agentes | `.agent/base/agents/*/persona.md` |
|
||||
| Personas dos agentes | `.agent/base/agents/*/persona` |
|
||||
| Rules locais do projeto | `.agent/local/rules/` |
|
||||
| Workflows locais do projeto | `.agent/local/workflows/` |
|
||||
| Skills locais do projeto | `.agent/local/skills/` |
|
||||
Loading…
Add table
Add a link
Reference in a new issue