rdd-pack-scaffold
Onboarding de uma NOVA organização no RDD open core — cria o esqueleto completo do pack dela a partir APENAS do contrato `PACK_SCHEMA.md` (pack.yaml, regra da org, acúmulo vazio, README), faz o primeiro commit no repo do pack, roteia a criação do repo remoto privado (`gh repo create`), o registro no perfil (`packs:`/`pack_repos` — sob confirmação) e a instalação no runtime (cópia de `provides`, `.rdd/sources.yaml`, `.gitignore`). Fluxo interativo com perguntas agrupadas (IMP-043). Use quando o usuário pedir "onboarding de empresa no open core", "criar pack", "scaffold de pack", "nova empresa no rdd" ou "onboarding de pack".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-pack-scaffold
- description
- Onboarding de uma NOVA organização no RDD open core — cria o esqueleto completo do pack dela a partir APENAS do contrato `PACK_SCHEMA.md` (pack.yaml, regra da org, acúmulo vazio, README), faz o primeiro commit no repo do pack, roteia a criação do repo remoto privado (`gh repo create`), o registro no perfil (`packs:`/`pack_repos` — sob confirmação) e a instalação no runtime (cópia de `provides`, `.rdd/sources.yaml`, `.gitignore`). Fluxo interativo com perguntas agrupadas (IMP-043). Use quando o usuário pedir "onboarding de empresa no open core", "criar pack", "scaffold de pack", "nova empresa no rdd" ou "onboarding de pack".
03 SKILL.md 正文
rdd-pack-scaffold — Scaffold de pack de organização
Onboarding de uma nova organização no open core: a partir apenas do
contrato (PACK_SCHEMA.md), cria o esqueleto completo do pack — nada do
template assume uma org específica. Passos de efeito externo (repo remoto,
perfil, instalação no runtime) só acontecem com confirmação explícita.
Lê (upstream)
PACK_SCHEMA.md— contrato dopack.yaml(v1): campos, no-override, lockfile,.gitignoregeradoregistry.yaml+BREAKING-CHANGES.md— versão local do core e faixa compatível (requires-core)rules/client-profile.md—org_githube packs já registrados (packs:/pack_repos)skills/rdd-pack-update/SKILL.mdeskills/rdd-setup/SKILL.md(Passo 6b) — referência de estilo do installer/updater
Gera (downstream)
- Esqueleto do pack em
packs/<id>/(NOVO):pack.yaml(v0.1.0) —provides[]/accumulation[]derivados das respostas- regra da org (default
rules/packs/<id>.md) com seções-guia a preencher accumulation/patterns/README.md,accumulation/metrics/README.md,accumulation/reverses/README.mdREADME.mddo pack
- Primeiro commit no repo do pack (
git init -b main) - Repo remoto privado —
gh repo create <org-github>/<repo> --private+ remote + push (só com confirmação) - Entrada no
rules/client-profile.md—packs: [<id>@<faixa>]+pack_repos(sob confirmação explícita) - Instalação no runtime — cópia dos
provides, pin em.rdd/sources.yaml, seção gerada no.gitignore
Nunca edita
- Paths já existentes do core — no-override vale também na criação
- Packs de outras organizações (
packs/<outro-id>/) accumulation/com conteúdo real — só cria esqueleto vazio com README- Sem confirmação explícita: não cria repo remoto, não atualiza perfil, não faz push
Tools
read/glob/grep: allow — contrato, registry, perfil, packs existentesquestion: allow — perguntas agrupadas (uma chamada por bloco de decisão, IMP-043)bash: ask —git init/commit/push,gh repo create, cópia de arquivosedit/write: apenaspacks/<id>/**(NOVO),.rdd/sources.yaml,.gitignore(seção gerada),rules/client-profile.md(com confirmação)
Modo de erro
- Id de pack já existente (pasta em
packs/ou entrada no perfil) → ABORTA com orientação: o pack existe, userdd-pack-updatepara atualizar/reinstalar. requires-coreincompatível com a versão local do core → aborta apontandoBREAKING-CHANGES.md(o que mudou no major e como migrar).- Sem
ghautenticado → cria o repo local completo e registra pendência do remote (gh repo create+ push) no relatório. - Usuário recusa qualquer confirmação → entrega o esqueleto local mesmo assim e lista as pendências (remote, perfil, instalação).
Workflow
- Coleta (UMA
questionagrupada):- nome da organização/empresa
- id do pack (
lowercase-hyphen) - org GitHub (
<org-github>; default: a do perfil, se houver) - nome do repo (default
<org>.RDD.PACK.<ID-MAIÚSCULO>— valide com o operador) - visibilidade (default
private) - nome da regra (default
rules/packs/<id>.md)
- Valida: unicidade do id (
packs/<id>/livre + ausente do perfil), ausência de colisão da regra com path do core e compat da faixarequires-coreproposta contraregistry.yaml+BREAKING-CHANGES.md. - Cria o esqueleto em
packs/<id>/:pack.yamlv0.1.0:id,name,version: 0.1.0,requires-corederivado da versão local do core,provides: [<regra da org>],accumulation: [accumulation/patterns/, accumulation/metrics/, accumulation/reverses/]<regra da org>com seções-guia a preencher: identidade, infra validada, runbooksaccumulation/{patterns,metrics,reverses}/README.md+README.mddo pack
- Primeiro commit:
git init -b main+ commit inicial no repo do pack (anote o SHA para o pin). - Pergunta — repo remoto: confirmado →
gh repo create <org-github>/<repo> --private+git remote add+git push -u origin main. - Pergunta — perfil: confirmado → adicionar
<id>@<faixa>empacks:e<id>→ URL empack_reposnorules/client-profile.md. - Pergunta — instalar agora: confirmado → valide no-override (nenhum
providescolide com path do core), copie osprovidespara o runtime, grave.rdd/sources.yaml(version/commit/paths — pin do commit inicial) e gere a seção do.gitignore. - Relatório final: o que foi criado (arquivos, commit, remote, instalação) e o que ficou pendente (⚠️).
Casos de borda
- Id com caractere inválido (espaço, maiúscula,
_) → normalize paralowercase-hyphen; recuse se não houver forma inequívoca. - Organização sem org GitHub no perfil → pergunte a org na coleta (não assuma).
- Máquina sem bash/WSL → execute os equivalentes em PowerShell (
Copy-Item,git,gh). - Regra
rules/packs/<id>.mdcolide com arquivo existente no core → aborta (no-override vale também na criação).
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".