setup-bootstrap

Infraestrutura de desenvolvimento com IA — harness multi-provider.

Suporta Claude Code e GitHub Copilot. Um comando instala rules, protecoes e workflows adaptados a stack do seu projeto.

Instalacao

npm install -g setup-bootstrap

Ou use direto sem instalar:

npx setup-bootstrap init

Uso rapido

cd meu-projeto

# Interativo — pergunta provider, hosting, etc.
setup-bootstrap init

# Direto — provider especifico
setup-bootstrap init --provider=claude
setup-bootstrap init --provider=copilot
setup-bootstrap init --provider=all       # ambos

# Preview sem escrever nada
setup-bootstrap init --dry-run

Guia: Claude Code

1. Gerar harness

setup-bootstrap init --provider=claude

2. O que e gerado

CLAUDE.md                    # Instrucoes principais do projeto
.claudeignore                # Arquivos que Claude ignora
.claude/
  settings.json              # allow/deny + hooks configurados
  rules/core/                # 5 rules (sempre ativas)
  rules/domain/              # 5+ rules (ativam por glob)
  agents/                    # 4 sub-agents (code-reviewer, db-architect, debugger, doc-analyzer)
  skills/                    # 7 workflows (/spec, /new-feature, /fix-bug, /review, /spec-feature, /setup-project, /health-check)
  hooks/                     # 4 hooks de protecao
docs/specs/_template.md      # Template para specs

3. Protecao em 3 camadas

| Camada | O que faz | |--------|-----------| | Deny list | Bloqueia rm -rf, sudo, push --force, .env, lockfiles, DROP TABLE | | Hooks | Commit sem teste (bloqueia), loops de edicao (10x block), budget de agents (Opus=2x peso) | | Rules | Anti-loop, checkpoints, verificacao de realidade |

4. Primeiros passos apos gerar

# Revisar instrucoes do projeto
cat CLAUDE.md

# Usar skills no Claude Code
/spec "descreva seu projeto"
/new-feature "implementar autenticacao"
/fix-bug "erro 500 no endpoint /api/users"

# Validar integridade
setup-bootstrap health

Guia: GitHub Copilot

1. Gerar harness

setup-bootstrap init --provider=copilot

2. O que e gerado

.copilot/
  skills/                      # 7 skills (slash commands)
    spec/SKILL.md              # /spec — Criar spec tecnica
    spec-feature/SKILL.md      # /spec-feature — Planejar feature
    new-feature/SKILL.md       # /new-feature — Implementar feature
    fix-bug/SKILL.md           # /fix-bug — Investigar e corrigir bug
    review/SKILL.md            # /review — Code review estruturado
    setup-project/SKILL.md     # /setup-project — Configurar ambiente
    health-check/SKILL.md      # /health-check — Diagnostico do projeto
.github/
  copilot-instructions.md      # Todas as rules consolidadas
  workflows/ai-review.yml      # GitHub Action de review automatico
.vscode/
  settings.json                # Configuracao do Copilot no VS Code
docs/specs/_template.md        # Template para specs

3. Como funciona

• Rules consolidadas em copilot-instructions.md — Copilot le automaticamente
• Skills em .copilot/skills/ — slash commands no Copilot Chat
• Protecao via GitHub Actions (CI com lint/typecheck/test em cada PR)

4. Usando as skills

No Copilot Chat, use as skills como slash commands:

/spec "sistema de gestao de pedidos com auth OAuth"
/new-feature "implementar checkout com pagamento PIX"
/fix-bug "erro 500 ao salvar usuario com email duplicado"
/review
/health-check

5. Equivalencia Claude Code ↔ Copilot

| Claude Code | Copilot | O que faz | |-------------|---------|-----------| | /spec | /spec | Cria spec tecnica com 8 secoes obrigatorias | | /spec-feature | /spec-feature | Roadmap de implementacao com impacto por camada | | /new-feature | /new-feature | Implementa em blocos incrementais com validacao | | /fix-bug | /fix-bug | Red test first, investiga causa raiz, valida fix | | /review | /review | Review por dominio (seguranca, perf, qualidade) | | /setup-project | /setup-project | Configura ambiente de dev do zero | | /health-check | /health-check | Diagnostico completo sem modificar nada |

Mesmos nomes, mesmo comportamento — so muda o provider por baixo.

Ambos providers (--provider=all)

Gera tudo — sem conflito (Claude usa .claude/, Copilot usa .copilot/ + .github/).

Util quando o time usa editores diferentes ou quer migrar gradualmente.

Stacks suportadas

| Tier | Stacks | |------|--------| | Primeira classe | Next.js, Hono, Express, Fastify, ASP.NET (Minimal/Controllers) + Prisma/Drizzle/Supabase/EF Core | | Primeira classe | React puro (Vite/CRA) como frontend (standalone ou com backend .NET) | | Best-effort | Python (FastAPI, Flask, Django), Go (Gin, Echo, Chi), Rust (Axum, Actix) |

A deteccao e automatica — le package.json, .csproj, pyproject.toml, go.mod, Cargo.toml.

Referencia de comandos

# Init
setup-bootstrap init                                # interativo
setup-bootstrap init --provider=claude              # Claude Code
setup-bootstrap init --provider=copilot             # GitHub Copilot
setup-bootstrap init --provider=all                 # ambos
setup-bootstrap init --stack=next                   # pula deteccao
setup-bootstrap init --stack=aspnet-controllers     # .NET Controllers
setup-bootstrap init --dry-run                      # preview
setup-bootstrap init --force                        # sobrescreve protegidos
setup-bootstrap init --no-smoke                     # pula smoke test

# Health check
setup-bootstrap health                              # detecta provider instalado
setup-bootstrap health --provider=claude            # valida harness Claude
setup-bootstrap health --provider=copilot           # valida harness Copilot

Valores aceitos

| Flag | Valores | |------|---------| | --provider | claude, copilot, all | | --stack | next, hono, express, fastify, aspnet-minimal, aspnet-controllers, fastapi, flask, django, gin, echo, chi, axum, actix, go, rust |

Valores invalidos geram erro imediato com a lista de opcoes aceitas.

Arquitetura

setup-bootstrap/
├── core/                  # Conhecimento universal (provider-agnostic)
│   ├── rules/core/        # 5 rules sempre ativas
│   ├── rules/domain/      # 7 rules contextuais
│   ├── hooks/             # 4 hooks de protecao (.mjs)
│   └── templates/         # Spec template
│
├── providers/
│   ├── claude/            # Adapter: core -> formato Claude Code
│   │   ├── agents/        # 4 AGENT.md (Claude-specific)
│   │   └── skills/        # 7 SKILL.md (Claude-specific)
│   └── copilot/           # Adapter: core -> formato Copilot
│       ├── workflows/     # GitHub Actions
│       └── vscode/        # VS Code settings
│
├── lib/                   # CLI: detect, generate, merge, smoke, health, validate
├── cli.mjs                # Entry point
└── package.json

Uma fonte de verdade (core/) — quando voce melhora uma rule, ambos os providers recebem. Extensivel: amanha pode ter providers/cursor/.

Requisitos

• Node.js >= 20
• Git inicializado (git init)

Links

• Roadmap

License

MIT