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

@ -1,7 +1,7 @@
#!/bin/sh
# =============================================================================
# gerar-agent-json.sh — Adaptador Antigravity
# Gera o agent.json de cada agente a partir do persona.md
# Gera o agent.json de cada agente a partir do persona
#
# Uso:
# ./gerar-agent-json.sh # gera para todos os agentes
@ -16,7 +16,7 @@ GLOBAL_RULES_DIR="$(cd "$(dirname "$0")/../.." && pwd)/global/rules"
gerar_para_agente() {
AGENTE="$1"
PERSONA="$AGENTS_DIR/$AGENTE/persona.md"
PERSONA="$AGENTS_DIR/$AGENTE/persona"
if [ ! -f "$PERSONA" ]; then
echo "⚠ Persona não encontrada: $PERSONA"
@ -31,22 +31,25 @@ gerar_para_agente() {
DESCRIPTION=$(echo "$FRONTMATTER" | yq '.description' 2>/dev/null || echo "")
TOOLS=$(echo "$FRONTMATTER" | yq '.tools[]' 2>/dev/null | tr '\n' ',' | sed 's/,$//')
# Ler corpo do persona.md (após o segundo ---)
# Ler corpo do persona (após o segundo ---)
BODY=$(awk '/^---$/{c++; next} c>=2' "$PERSONA")
# Ler rules globais
GLOBAL_RULES=""
for rule_file in "$GLOBAL_RULES_DIR"/*.md; do
GLOBAL_RULES="$GLOBAL_RULES\n\n### $(basename "$rule_file" .md)\n$(cat "$rule_file")"
for rule_file in "$GLOBAL_RULES_DIR"/*; do
[ -f "$rule_file" ] || continue
case "$rule_file" in *.sh|*.json) continue ;; esac
GLOBAL_RULES="$GLOBAL_RULES\n\n### $(basename "$rule_file")\n$(cat "$rule_file")"
done
# Ler rules do agente
AGENT_RULES=""
AGENT_RULES_DIR="$AGENTS_DIR/$AGENTE/rules"
if [ -d "$AGENT_RULES_DIR" ]; then
for rule_file in "$AGENT_RULES_DIR"/*.md; do
for rule_file in "$AGENT_RULES_DIR"/*; do
[ -f "$rule_file" ] || continue
AGENT_RULES="$AGENT_RULES\n\n### $(basename "$rule_file" .md)\n$(cat "$rule_file")"
case "$rule_file" in *.sh|*.json) continue ;; esac
AGENT_RULES="$AGENT_RULES\n\n### $(basename "$rule_file")\n$(cat "$rule_file")"
done
fi

View file

@ -2,11 +2,11 @@
> **Status:** 🟡 Preparado — implementação futura
Este diretório conterá o adaptador para gerar configurações nativas do Claude a partir dos arquivos `persona.md` dos agentes.
Este diretório conterá o adaptador para gerar configurações nativas do Claude a partir dos arquivos `persona` dos agentes.
## Como funciona a arquitetura
A camada universal (arquivos `persona.md`, `global/rules/`, `agents/*/rules/`) é escrita em Markdown puro e é **independente de plataforma**. Cada adaptador lê essa camada universal e gera a configuração específica para cada LLM.
A camada universal (arquivos `persona`, `global/rules/`, `agents/*/rules/`) é escrita em Markdown puro e é **independente de plataforma**. Cada adaptador lê essa camada universal e gera a configuração específica para cada LLM.
## Implementação futura
@ -14,9 +14,9 @@ Quando for necessário migrar para Claude:
1. Criar `gerar-claude-config.sh` neste diretório
2. O script deve ler:
- `agents/{nome}/persona.md` → corpo do system prompt
- `global/rules/*.md` → rules herdadas por todos
- `agents/{nome}/rules/*.md` → rules específicas do agente
- `agents/{nome}/persona` → corpo do system prompt
- `global/rules/*` → rules herdadas por todos
- `agents/{nome}/rules/*` → rules específicas do agente
3. Gerar o formato de configuração nativo do Claude (`.claude/` directory ou API system prompt)
4. **Zero alteração** nos arquivos de `global/` ou `agents/`
@ -24,7 +24,7 @@ Quando for necessário migrar para Claude:
```json
{
"system": "...(conteúdo do persona.md + rules concatenadas)...",
"system": "...(conteúdo do persona + rules concatenadas)...",
"tools": [...],
"model": "claude-opus-4-5"
}

View file

@ -2,11 +2,11 @@
> **Status:** 🟡 Preparado — implementação futura
Este diretório conterá o adaptador para gerar configurações nativas do OpenAI (GPT-4, GPT-4o, etc.) a partir dos arquivos `persona.md` dos agentes.
Este diretório conterá o adaptador para gerar configurações nativas do OpenAI (GPT-4, GPT-4o, etc.) a partir dos arquivos `persona` dos agentes.
## Como funciona a arquitetura
A camada universal (arquivos `persona.md`, `global/rules/`, `agents/*/rules/`) é escrita em Markdown puro e é **independente de plataforma**. Cada adaptador lê essa camada universal e gera a configuração específica para cada LLM.
A camada universal (arquivos `persona`, `global/rules/`, `agents/*/rules/`) é escrita em Markdown puro e é **independente de plataforma**. Cada adaptador lê essa camada universal e gera a configuração específica para cada LLM.
## Implementação futura
@ -14,9 +14,9 @@ Quando for necessário migrar para OpenAI:
1. Criar `gerar-openai-config.sh` neste diretório
2. O script deve ler:
- `agents/{nome}/persona.md` → corpo do system prompt
- `global/rules/*.md` → rules herdadas por todos
- `agents/{nome}/rules/*.md` → rules específicas do agente
- `agents/{nome}/persona` → corpo do system prompt
- `global/rules/*` → rules herdadas por todos
- `agents/{nome}/rules/*` → rules específicas do agente
3. Gerar o formato de Assistants API ou Custom GPT do OpenAI
4. **Zero alteração** nos arquivos de `global/` ou `agents/`
@ -25,7 +25,7 @@ Quando for necessário migrar para OpenAI:
```json
{
"name": "ag-back",
"instructions": "...(conteúdo do persona.md + rules concatenadas)...",
"instructions": "...(conteúdo do persona + rules concatenadas)...",
"tools": [{"type": "code_interpreter"}, {"type": "file_search"}],
"model": "gpt-4o"
}