rdd-registry-render
Gera as views do ARCHITECTURE.md (diagramas Mermaid, tabelas de agentes/skills/domínios) e as tabelas de subagents dos primary agents a partir do manifesto canônico registry.yaml. Lê o YAML, monta os grafos de delegação e substitui os blocos delimitados por <!-- BEGIN_REGISTRY --> / <!-- END_REGISTRY --> nos arquivos alvo. Idempotente: mesma entrada produz exatamente a mesma saída. Use quando o usuário pedir "renderizar registry", "regenerar architecture", "sincronizar views do registry", "atualizar diagramas do RDD", ou quando o @rdd-workflow-builder finalizar uma criação de componente.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-registry-render
- description
- Gera as views do ARCHITECTURE.md (diagramas Mermaid, tabelas de agentes/skills/domínios) e as tabelas de subagents dos primary agents a partir do manifesto canônico registry.yaml. Lê o YAML, monta os grafos de delegação e substitui os blocos delimitados por <!-- BEGIN_REGISTRY --> / <!-- END_REGISTRY --> nos arquivos alvo. Idempotente: mesma entrada produz exatamente a mesma saída. Use quando o usuário pedir "renderizar registry", "regenerar architecture", "sincronizar views do registry", "atualizar diagramas do RDD", ou quando o @rdd-workflow-builder finalizar uma criação de componente.
03 SKILL.md 正文
rdd-registry-render — Renderizador de Views do Registry RDD
Lê registry.yaml e regenera as seções estruturais do ARCHITECTURE.md
e as tabelas de subagents de agents/rdd-req.md, agents/rdd-doc.md,
agents/rdd-dev.md e agents/rdd-devops.md dentro dos marcadores
<!-- BEGIN_REGISTRY --> / <!-- END_REGISTRY -->.
Lê (upstream)
<config-root>/registry.yaml— manifesto canônico (essencial)<config-root>/ARCHITECTURE.md— arquivo alvo (para localizar marcadores)<config-root>/agents/rdd-req.md— arquivo alvo (para localizar marcadores)<config-root>/agents/rdd-doc.md— arquivo alvo (para localizar marcadores)<config-root>/agents/rdd-dev.md— arquivo alvo (para localizar marcadores)<config-root>/agents/rdd-devops.md— arquivo alvo (para localizar marcadores)
Gera (downstream)
- Substitui blocos em
<config-root>/ARCHITECTURE.md:- Diagrama de camadas (Mermaid flowchart BT) §1
- Diagrama de interações (Mermaid flowchart LR) §2
- Tabela de primary agents §3
- Tabela de subagents §4
- Tabela de skills por domínio §5
- Taxonomia de domínios §6
- Substitui blocos em
<config-root>/agents/rdd-req.md,rdd-doc.md,rdd-dev.mderdd-devops.md:- Tabela de subagents
Nunca edita
- Seções narrativas fora dos marcadores
<!-- BEGIN_REGISTRY --> / <!-- END_REGISTRY --> - Skills, agents, ou qualquer outro arquivo de configuração
- Artefatos de módulo RDD
Tools
read(ler registry.yaml, ARCHITECTURE.md, rdd-req.md, rdd-doc.md, rdd-dev.md)edit(substituir blocos delimitados)question(confirmar dry-run ou aplicar)
Modo de erro
interativo — mostra diff entre o bloco atual e o gerado antes de aplicar.
Se registry.yaml não existir, aborta com instrução de criá-lo primeiro.
Se os marcadores não forem encontrados nos arquivos alvo, aborta e orienta.
Casos de Borda
- registry.yaml unparseável (YAML inválido): ABORTA sem tocar nenhuma view — reporte a linha/erro de parse e oriente corrigir o manifesto primeiro; views desatualizadas são preferíveis a views corrompidas.
- Marcadores
BEGIN_REGISTRY/END_REGISTRYausentes em arquivo alvo: aborta e orienta — nunca crie blocos por conta própria; se apenas um alvo estiver sem marcadores, aborte o lote inteiro e reporte quais arquivos estão irregulares. - Id duplicado dentro da mesma coleção (
subagentsouskills): aborta e reporta — o render não decide qual entrada prevalece. Duplo registro ENTRE coleções (mesmo id emsubagentseskills— ex.: rdd-next) é padrão legítimo e não é erro. - Colisão de ID de nó no Mermaid (dois nós com o mesmo
S<N>): o segundoS<N>sobrescreve o label do primeiro e o diagrama renderiza errado (IMP-129). O render NUNCA emite ID repetido: os IDs são regenerados da lista completa em uma passada determinística (regra da View A); ao detectar colisão com a view anterior, renumere nós, arestas e class na mesma passada e reporte a correção. - Conteúdo manual fora dos blocos: seções narrativas fora dos marcadores (incl. edições manuais dentro do ARCHITECTURE.md) são preservadas — o render substitui SOMENTE o conteúdo entre
BEGIN_REGISTRY/END_REGISTRY. - Registry desatualizado vs. disco (skill/agent em disco sem registro): renderiza o que existe e reporta os órfãos (
registry:agentes_em_disco_registrados/registry:skills_em_disco_registradas) — registrar componente novo é trabalho dordd-workflow-builder, não deste render. - Referência pendente (delegates/invokes aponta para id inexistente): reporte como dangling e aborta o gate (
registry:referencias_resolvem) — não silencie a referência quebrada. - Duplo registro na camada de skills (§1): skills também registradas como subagents (
rdd-next,rdd-progress,rdd-cr-propagation-guard,rdd-tasks-pending) NÃO recebem nó próprio na camada L5 do diagrama — contam no label<N> skillse são representadas pelo subagent correspondente (L4). Toda outra skill registrada ganha nó. - Self-invokes (legado de duplo registro):
invokesauto-referente renderiza—na coluna "Invoca skills" da §4 e NÃO gera aresta — jamais emita aresta vazia (X -->sem destino). - Numeração da §5: numere as sub-tabelas
### 5.<N>sequencialmente conforme a ordem de exibição no documento (5.1, 5.2, …) — nunca reaproveite a ordem interna do registry. - Encoding: escreva sempre UTF-8 sem BOM (IMP-097); NUNCA produza mojibake (
ÔÇ—,→,─,§). Mojibake pré-existente dentro do bloco é saneado na mesma passada (precedente IMP-105).
Workflow
Passo 1 — Ler registry.yaml
Leia o arquivo registry.yaml. Identifique:
primary_agents— cada um comid,delegates,invokes_directsubagents— cada um comid,owner,available_to,registered_by(legado),invokesskills— cada um comid,domain,descriptiondomains— cada um comorchestrator,skills
Construa internamente os grafos:
primary → subagents(viadelegates)subagent → skills(viainvokes)domain → skills(via agrupamento)
Passo 2 — Gerar views
Gere cada view no formato especificado abaixo, usando os dados do registry.
View A — Diagrama de camadas (Mermaid flowchart BT)
flowchart BT
subgraph L5["5. Skills (<N> skills)"]
direction TB
S1["rdd-xxx (Domain)"]
S2["rdd-yyy (Domain)"]
end
subgraph L4["4. Subagents (<N>)"]
direction TB
SA1["@rdd-xxx<br/>desc curta"]
end
subgraph L3["3. Primary Agents"]
REQ["rdd-req.md"]
DOC["rdd-doc.md"]
DEV["rdd-dev.md"]
OPS["rdd-devops.md"]
end
REQ --> SA1
DOC --> SA2
SA1 --> S1 & S2
Atribuição de IDs de nós de skills (S<N>) — regra determinística anti-colisão (IMP-129):
- Monte a lista completa de nós ANTES de atribuir qualquer ID: todas as skills registradas exceto as de duplo registro (caso de borda acima), ordenadas pela ordem das chaves
domains:no registry.yaml e, dentro de cada domínio, pela ordem da listaskills:do domínio. - Atribua
S1..SNsequencialmente sobre essa lista em UMA única passada — IDs estritamente únicos. - NUNCA derive ID da view anterior ("próximo ID livre" contra snapshot stale) — a numeração é SEMPRE regenerada da lista completa: mesma árvore, mesma saída (idempotência).
- Antes de aplicar, valide: (a) contagem de nós = N; (b) nenhum
S<N>repetido; (c) as arestas e a linhaclass ... skillreferenciam exatamente os IDs da lista final — sem duplicar nem omitir.
View B — Diagrama de interações (Mermaid flowchart LR)
flowchart LR
User((Usuário))
subgraph Primary["1. Primary Agents"]
REQ["rdd-req.md"]
DOC["rdd-doc.md"]
DEV["rdd-dev.md"]
OPS["rdd-devops.md"]
end
subgraph Subagents["2. Subagents"]
NEXT["@rdd-next"]
end
subgraph Skills["3. Skills"]
S1["rdd-xxx"]
end
subgraph External["4. Sistemas"]
FS["Filesystem do projeto"]
GITHUB["GitHub Issues/PRs"]
end
User --> REQ & DOC
REQ --> SA1
DOC --> SA2
SA1 --> S1
S1 -.->|"escreve"| FS
View C — Tabela de Primary Agents
| Primary | Descrição | Delega para | Invoca diretamente |
|---------|-----------|-------------|--------------------|
| `rdd-req` | ... | subagents list | skills list |
| `rdd-doc` | ... | subagents list | skills list |
| `rdd-dev` | ... | subagents list | skills list |
| `rdd-devops` | ... | subagents list | skills list |
View D — Tabela de Subagents
| Subagent | Descrição | Invoca skills | Owner | Disponível para |
|----------|-----------|---------------|-------|----------------|
| `@rdd-xxx` | ... | skills | `rdd-yyy` | `rdd-yyy`, `rdd-zzz` |
View E — Tabela de Skills por Domínio
Gerar uma sub-tabela para cada domínio, com header ### <N>.<M> <Domain>.
| Skill | Descrição | Acessada via |
|-------|-----------|--------------|
| `rdd-xxx` | ... | `@rdd-orchestrator` |
View F — Taxonomia de Domínios
| Domínio | Orquestrador padrão | Skills |
|---------|---------------------|--------|
| intake | `@rdd-intake-orchestrator` | project-intake, init, legacy |
View G — Tabela de subagents dos primary agents (rdd-req.md, rdd-doc.md, rdd-dev.md, rdd-devops.md)
| Subagent | Quando invocar |
|----------|----------------|
| `@rdd-xxx` | descrição curta |
Passo 3 — Dry-run
Leia os arquivos alvo e localize os blocos <!-- BEGIN_REGISTRY --> / <!-- END_REGISTRY -->.
Compare o bloco atual com o bloco gerado. Exiba o diff via question.
Pergunte: "Aplicar alterações? (sim/não/detalhar)"
Passo 4 — Aplicar
Para cada arquivo alvo (incluindo agents/rdd-devops.md):
- Localize
<!-- BEGIN_REGISTRY -->...<!-- END_REGISTRY --> - Substitua o conteúdo interno pelos blocos gerados
- Informe quais seções foram alteradas
Passo 5 — Confirmar
Exiba resumo:
- ARCHITECTURE.md: <N> seções atualizadas
- rdd-req.md / rdd-doc.md / rdd-dev.md / rdd-devops.md: tabelas de subagents atualizadas
- Diff total: <N> linhas alteradas
Formato de commit
ops(registry): render views from registry.yaml
04 同仓库更多 Skills
rdd-wiki-lint
Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".
rdd-vps-troubleshoot
Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.
rdd-vps-setup
Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".
rdd-validate
Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".
rdd-ui-spec
Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
rdd-ui-capture
Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".