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:
Luiz Silva 2026-06-19 16:04:37 -03:00
parent 22023df81e
commit bf9be375e2
58 changed files with 506 additions and 514 deletions

View file

@ -129,7 +129,7 @@ Sempre que houver processo repetível identificado:
Sempre que um padrão operacional complexo for definido, refinado ou corrigido:
* Criar ou atualizar skill em `.agent/local/skills/<nome-da-skill>/SKILL.md`.
* Criar ou atualizar skill em `.agent/local/skills/<nome-da-skill>/SKILL`.
### Quando atualizar uma skill:
@ -158,13 +158,13 @@ Instruções com código, regras e padrões.
- [ ] Item de verificação
## Referências
- Regras: `.agent/local/rules/xxx.md`
- Workflow: `.agent/local/workflows/xxx.md`
- Regras: `.agent/local/rules/xxx`
- Workflow: `.agent/local/workflows/xxx`
```
### Regras de organização:
- Uma skill por diretório: `.agent/local/skills/<nome>/SKILL.md`
- Uma skill por diretório: `.agent/local/skills/<nome>/SKILL`
- Skills globais são identificadas pelo campo `scope: global` no frontmatter
- Nome do diretório em `kebab-case`
- A skill **não deve duplicar** conteúdo de rules — referencia-as via seção `Referências`
@ -181,7 +181,7 @@ Instruções com código, regras e padrões.
### Skills de projeto (criadas localmente em cada monorepo):
Cada projeto pode criar skills adicionais específicas em `.agent/local/skills/<nome>/SKILL.md`.
Cada projeto pode criar skills adicionais específicas em `.agent/local/skills/<nome>/SKILL`.
Essas skills focam nos padrões e domínios exclusivos daquele projeto.
Exemplos de skills de projeto:
@ -200,7 +200,7 @@ Exemplos de skills de projeto:
Sempre que decisões críticas sobre a arquitetura da aplicação ou o contexto do domínio precisarem ser arquivadas temporária ou permanentemente de maneira descritiva (e não diretamente injetável em código ou regra de lint):
* Registre o novo documento no formato adequado mantendo a pasta limpa em `.agent/memoria/`.
* Exemplo: Manter diário de pendências (`diario-pendencias-modulo-x.md`) ou ADR (`adr-001-migracao-nuxt-4.md`).
* Exemplo: Manter diário de pendências (`diario-pendencias-modulo-x`) ou ADR (`adr-001-migracao-nuxt-4`).
* Atenção! Tudo que puder ser abstraído para formato técnico estrito deve virar **Skill** ou **Rule**. Use a Memória apenas como extensão de base factual.
---

View file

@ -9,7 +9,7 @@ updatedAt: "2026-06-01"
# Workflow: Documentar Regras de Negócio de um Módulo
Use este workflow com `/documentar-regras-negocio.global` para criar ou atualizar o arquivo
`{modulo}.regras-negocio.md` de qualquer módulo TypeScript com lógica de negócio não-trivial.
`{modulo}.regras-negocio` de qualquer módulo TypeScript com lógica de negócio não-trivial.
---
@ -27,7 +27,7 @@ Identificar e anotar:
---
[2] Verificar se já existe um `.regras-negocio.md`
[2] Verificar se já existe um `.regras-negocio`
```bash
ls $(dirname <arquivo>)/*.regras-negocio.md 2>/dev/null
@ -38,9 +38,9 @@ ls $(dirname <arquivo>)/*.regras-negocio.md 2>/dev/null
---
[3] Criar o arquivo `.regras-negocio.md`
[3] Criar o arquivo `.regras-negocio`
Nomenclatura: `{nome-sem-_inicial}.regras-negocio.md` na mesma pasta do módulo.
Nomenclatura: `{nome-sem-_inicial}.regras-negocio` na mesma pasta do módulo.
Preencher com o template da skill `documentar-regras-negocio.global`:
- Contexto
@ -68,19 +68,19 @@ Se já existia e está correto → sem mudança necessária.
Percorrer cada função do módulo:
- JSDoc com lista de regras de negócio → substituir por referência ao `.md`
- JSDoc com lista de regras de negócio → substituir por referência ao ``
- Manter apenas `@param` e `@returns` com informação técnica precisa
- Comentários inline (`//`) explicando lógica pontual são aceitos → manter
---
[6] Verificar consistência — código ↔ `.md`
[6] Verificar consistência — código ↔ ``
Para cada regra listada no `.md`:
Para cada regra listada no ``:
- [ ] Existe `if` correspondente no código
- [ ] A ordem de avaliação bate entre `.md` e código
- [ ] Campos com separador de concatenação batem entre `.md` e código
- [ ] A ordem de avaliação bate entre `` e código
- [ ] Campos com separador de concatenação batem entre `` e código
- [ ] `null` como neutro está implementado corretamente (`!= null`)
- [ ] Queries têm `orderBy` quando a posição dos resultados importa