AI Workbench
EN
Voltar ao Início

Setup Wizard

Configure Claude Code, Codex, OpenCode, Zed e VS Code em um único projeto. O wizard lê seu código, detecta a stack e gera toda a estrutura automaticamente.

Pré-requisitos

Obrigatórios

  • • Node.js 18+ — para o wizard e MCPs via npx
  • • Claude Code — orquestrador principal
  • • Codex CLI — review, delegação e subagents (npm i -g @openai/codex)
  • • Git — o wizard usa worktrees para isolamento

Opcionais

  • • OpenCode — executor open-source alternativo
  • • Zed / VS Code — editores alternativos

Passo a Passo

1

Clone o repositório

git clone https://github.com/jdonini/ai-workbench.git
cd ai-workbench
2

Execute o wizard

claude ./templates/setup-wizard.md

O wizard faz 12 perguntas sobre seu projeto (stack, tipo, estado, time, workflow, etc.) e detecta automaticamente o que consegue.

3

Estrutura gerada

projeto/
├── CLAUDE.md                          ← Instruções para Claude Code
├── AGENTS.md                          ← Instruções para Codex / OpenCode
├── .mcp.json                          ← MCP servers configurados
│
├── .claude/
│   ├── settings.json                  ← Permissões, effort, hooks
│   ├── .last-setup.json               ← Estado do wizard
│   ├── hooks/
│   │   ├── session-start.sh
│   │   └── pre-compact.sh
│   ├── rules/
│   │   ├── universal.md
│   │   ├── project-context.md
│   │   ├── decisions.md
│   │   ├── glossary.md
│   │   └── {stack}.md
│   ├── commands/
│   │   ├── start-feature.md
│   │   ├── debug-issue.md
│   │   └── review-code.md
│   ├── skills/
│   │   ├── feature-start-detector/
│   │   ├── multi-stack-detector/
│   │   ├── dependency-guard/
│   │   └── auto-dream/
│   └── agents/
│       ├── code-reviewer.md
│       ├── language-guide-{stack}.md
│       └── error-detective.md
│
├── .codex/
│   ├── config.toml                    ← Modelo, sandbox, approval
│   ├── hooks.json                     ← Hooks do ciclo de vida
│   ├── commands/
│   │   ├── start-feature.md
│   │   ├── debug-issue.md
│   │   └── review-code.md
│   ├── rules/ → link para .claude/rules/
│   └── agents/
│       ├── explorer.toml
│       ├── reviewer.toml
│       └── {stack}-worker.toml
│
├── .agents/
│   └── skills/                        ← Skills (padrão open agent skills)
│       ├── feature-start-detector/
│       ├── multi-stack-detector/
│       ├── dependency-guard/
│       ├── code-reviewer/
│       └── error-detective/
│
├── .opencode/
│   ├── rules/ → link para .claude/rules/
│   └── commands/
│       ├── start-feature.md
│       ├── debug-issue.md
│       └── review-code.md
│
└── .claude.local/                     ← Overrides pessoais (gitignored)

Plugin Obrigatório

Na Fase 0, o wizard instala o superpowers via /plugin marketplace. Ele implementa o fluxo Spec-Driven Development:

superpowers

Workflow SDD
1

Brainstorming

Alinhamento de ideias e escopo antes de codar. Explora intenções, requisitos e design.

2

Planning with Files

Plano granular em arquivos (task_plan.md, findings.md, progress.md). Tarefas independentes com critérios de verificação.

3

Test-Driven Development

Red → Green → Refactor. Escreva o teste primeiro, depois o código mínimo para passar.

4

Systematic Debugging

Hipótese → investigação → fix cirúrgico. Não refatore durante debugging.

5

Verification Before Completion

Evidência antes de afirmar. Rode testes e lint antes de declarar sucesso.

6

Receiving Code Review

Rigor técnico ao receber feedback. Verifique antes de implementar sugestões.

7

Finishing a Development Branch

Merge, PR ou cleanup. Commits limpos, branch pronta para review.

MCP Servers

O wizard configura os MCP servers via .mcp.json. Cada servidor conecta automaticamente ao abrir o projeto.

mem0

Memória semântica persistente. Entidades, decisões e preferências são armazenadas e recuperadas automaticamente.

Requer MEM0_API_KEY

napkin

Runbook cumulativo por projeto. Aprende com cada interação e organiza por categorias priorizadas em .claude/napkin.md.

context7

Documentação de bibliotecas e frameworks em tempo real. Busca contexto atualizado para qualquer API.

sequential-thinking

Raciocínio passo a passo para problemas complexos. Ajuda o modelo a pensar de forma estruturada.

postman

Integração com coleções Postman para testar e documentar APIs diretamente do contexto de desenvolvimento.

postgresql

Acesso ao banco de dados para queries, exploração de schema e debugging direto do contexto.

Configuração .mcp.json

{
  "mcpServers": {
    "mem0": {
      "command": "uvx",
      "args": ["mem0-mcp-server"],
      "env": {
        "MEM0_API_KEY": "$MEM0_API_KEY",
        "MEM0_DEFAULT_USER_ID": "$MEM0_DEFAULT_USER_ID"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "env": { "CONTEXT7_API_KEY": "$CONTEXT7_API_KEY" }
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "postman": {
      "command": "npx",
      "args": ["-y", "@postman/postman-mcp-server"],
      "env": { "POSTMAN_API_KEY": "$POSTMAN_API_KEY" }
    },
    "postgresql": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://..."]
    }
  }
}

Próximo Passo

Agora que você configurou o ambiente, conheça o workflow padrão de desenvolvimento.

Ver Workflow