AGENT SKILL

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.md do 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 repo
  • bash — git clone, powershell rename-project.ps1, dotnet restore
  • glob — detectar stack no repo alvo
  • question — 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

  1. Detectar stack no repo alvo: use glob para os padrões em templates.<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).

  2. Carregar o registry: leia rules/stack-templates.yaml e busque o template da stack detectada.

  3. Verificar boilerplate disponível: se templates.<stack>.boilerplate for null, reporte que não há boilerplate para esta stack e encerre (executor usará scaffold genérico).

  4. 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.

  5. Clonar boilerplate na pasta correta:

    git clone --depth 1 https://github.com/<Org>/<Boilerplate> /tmp/<boilerplate>-tmp
    
  6. 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 question se a derivação não for clara.
  7. 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>\ 
    
  8. Configurar pós-clone:

    • Copiar .env.example para .env
    • Rodar dotnet restore (se .NET)
    • Ajustar connection string do banco para <ProjectName> (em appsettings*.json ou .env)
  9. 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.json no mesmo repo): pergunte via question qual 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 Candela sem 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

victor-souza-dev
victor-souza-dev/RDD-CORE

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".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

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.

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

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".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

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".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

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".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

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".

★ 4