rdd-stack-boilerplate
Template engine para bootstrapping de projetos RDD a partir de boilerplates pré-definidos por stack. Lê o registry `rules/stack-templates.yaml`, clona o boilerplate correspondente, executa o setup pós-clone (rename, env, restore) e prepara o projeto para receber implementação. Invocada por rdd-dev-backend e rdd-dev-frontend ao detectar repo vazio (sem código-fonte, só README) ou no início de um novo projeto via rdd-intake-orchestrator. Evita scaffold genérico (`dotnet new webapi`) — usa um repo curado da organização (`boilerplate_org` do perfil — IMP-105). Use junto com "boilerplate", "template", "bootstrap", "novo projeto", "scaffold", "stack template", "clone boilerplate".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-stack-boilerplate
- description
- Template engine para bootstrapping de projetos RDD a partir de boilerplates pré-definidos por stack. Lê o registry `rules/stack-templates.yaml`, clona o boilerplate correspondente, executa o setup pós-clone (rename, env, restore) e prepara o projeto para receber implementação. Invocada por rdd-dev-backend e rdd-dev-frontend ao detectar repo vazio (sem código-fonte, só README) ou no início de um novo projeto via rdd-intake-orchestrator. Evita scaffold genérico (`dotnet new webapi`) — usa um repo curado da organização (`boilerplate_org` do perfil — IMP-105). Use junto com "boilerplate", "template", "bootstrap", "novo projeto", "scaffold", "stack template", "clone boilerplate".
03 SKILL.md 正文
rdd-stack-boilerplate — Bootstrap de projetos a partir de boilerplates
Escopo
- Entrada: um repositório vazio (só README) + stack detectada (ex.:
.NET) - Saída: repositório populado com o boilerplate da stack + renomeado para o projeto
- Quando carregar: no passo 0 do
rdd-dev-backend/rdd-dev-frontend, ANTES de implementar qualquer task — se o repo for vazio, carregar este stack-boilerplate primeiro - Fallback: sem boilerplate no registry → executor gera scaffold genérico (
dotnet new webapi)
Lê (upstream)
rules/stack-templates.yaml— registry de boilerplates por stack (lazy-loaded via AGENTS.md)AGENTS.mddo repo alvo — convenções específicas do projeto
Gera (downstream)
- O repositório alvo populado com o boilerplate + renomeado + configurado
- Relatório resumido: boilerplate usado, steps executados, pendências pós-setup
Nunca edita
rules/stack-templates.yaml(adicionar stacks manualmente ou via CR)- Boilerplate repos (são lidos como template, nunca modificados)
- Código existente no repo alvo (só escrive em repo vazio)
Tools
read— ler o registry YAML e o AGENTS.md do repobash—git clone,powershell rename-project.ps1,dotnet restoreglob— detectar stack no repo alvoquestion— confirmar stack quando ambígua ou sem boilerplate
Modo de erro
warn — repo já tem código-fonte → pular boilerplate (repo existente, não é bootstrap).
Boilerplate não encontrado ou repo privado sem acesso → orientar fallback a scaffold genérico.
Algoritmo
-
Detectar stack no repo alvo: use
globpara os padrões emtemplates.<stack>.detect. Se mais de uma stack combinar, pergunte (question). Se nenhuma, reporte que a stack não tem boilerplate no registry e encerre (deixando o executor cair no scaffold genérico). -
Carregar o registry: leia
rules/stack-templates.yamle busque o template da stack detectada. -
Verificar boilerplate disponível: se
templates.<stack>.boilerplatefornull, reporte que não há boilerplate para esta stack e encerre (executor usará scaffold genérico). -
Verificar se o repo já tem código: se o repo alvo tiver mais que README.md e arquivos de config mínima (
.gitignore,.env.example,LICENSE), pule — repo não é vazio. -
Clonar boilerplate na pasta correta:
git clone --depth 1 https://github.com/<Org>/<Boilerplate> /tmp/<boilerplate>-tmp -
Renomear para o nome do projeto: execute o script de rename do boilerplate (se existir).
cd /tmp/<boilerplate>-tmp powershell -File rename-project.ps1 <ProjectName>O nome do projeto (
<ProjectName>) é derivado do nome do repo alvo:- Se o repo termina com
-API,-APIé extraído (ex.:Candela-API→Candela) - Caso contrário, usa o nome completo do repo.
- Pergunte via
questionse a derivação não for clara.
- Se o repo termina com
-
Copiar conteúdo para o repo alvo:
# Remove .git do boilerplate Remove-Item -Recurse -Force /tmp/<boilerplate>-tmp/.git # Copia para o repo alvo Copy-Item -Recurse -Force /tmp/<boilerplate>-tmp\* <repo-target>\ -
Configurar pós-clone:
- Copiar
.env.examplepara.env - Rodar
dotnet restore(se .NET) - Ajustar connection string do banco para
<ProjectName>(emappsettings*.jsonou.env)
- Copiar
-
Registrar no relatório: boilerplate usado, rename aplicado, steps executados, quebra de compatibilidade com o playbook (ex.: versão de dependências diferente da documentada), pendências pós-setup (ex.: configurar secrets, subir migrations, ajustar docker-compose ports).
Relatório de saída
═══ rdd-stack-boilerplate — .NET ═══
Boilerplate: <boilerplate_org do perfil>/Boilerplate.NET-API (ex.: Acme-Group/Boilerplate.NET-API)
Rename: <ProjectName> (Candela)
Steps executados:
- git clone --depth 1
- rename-project.ps1 Candela
- Copiado para repo alvo
- .env criado a partir de .env.example
- dotnet restore (OK)
Quebras de compatibilidade:
- (nenhuma — boilerplate atualizado)
Pendências pós-setup:
- Configurar secrets do GitHub
- Ajustar docker-compose ports se necessário
Formato de commit
(Não commita diretamente — o executor (rdd-dev-backend) commita o bootstrap)
Casos de Borda
- Repo já tem código: pular silenciosamente (repo existente, em desenvolvimento). Reporte "pulado — repo não vazio".
- Boilerplate não encontrado: oriente fallback ao scaffold genérico (
dotnet new webapi). Registry não precisa ter entry para toda stack. - rename-project.ps1 falha: reporte erro e pare; o conteúdo bruto do boilerplate fica no diretório, e o operador pode renomear manualmente.
- Multi-stack detectada (ex.:
*.csproj+angular.jsonno mesmo repo): pergunte viaquestionqual stack usar. - Stack sem boilerplate no registry: reporte e encerre; não falhe (o executor faz scaffold genérico).
- Projeto sem nome claro (ex.: repo
Candelasem sufixo): pergunte o nome do projeto para o rename. O nome do projeto .NET (solution name) pode ser diferente do nome do repo.
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".