guia passo a passoverificação automática + tracker manual

Comece aqui

Acabou de clonar o repositório e nunca trabalhou com este template? Siga este guia. Os passos com verificação automática atualizam sozinhos a cada 5 segundos. Os passos manuais ganham botão "Validar agora" (tenta detectar via comando no servidor) ou "Já tenho instalado" (você marca, fica salvo em .claude/setup-checks.json).

16 de 17 passos verificados automaticamente94%

Fase 1

Ambiente da máquina

Pré-requisitos antes de abrir qualquer terminal no projeto. Use o botão Validar para detectar via comando ou marque manualmente.

1.1

Node.js 20 ou superior

Feito

Detectado v20.20.2

O CoCreate Studio (este dashboard) e o frontend do projeto rodam em Node. Se você está vendo esta página, provavelmente já tem Node instalado (foi assim que `npm run dev` funcionou). O check verifica se a versão é >= 20.

nodejs.org/pt-br/download ↗

via probe· 24.13.1

1.2

PowerShell 7+ (Windows)

Feito

Windows 10/11 vem com PowerShell 5.1 (comando powershell.exe). O PowerShell 7+ é uma instalação separada e responde a 'pwsh'. Os hooks da camada Harness foram configurados pra usar pwsh por padrão.

Você tem 2 opções:

Instalar PowerShell 7+ (recomendado) — botão "Validar agora" abaixo confirma
Editar .claude/settings.json trocando pwsh por powershell — funciona com 5.1 (já instalado por padrão no Windows)

Baixar PowerShell 7+ ↗

via probe· 7.6.2

1.3

Claude Code CLI

Feito

A IA executora deste template. Sem ele, as skills (/iniciar-projeto, /executar-tarefa, etc.) não funcionam.

Dica: se você está usando este template via Claude Code agora mesmo (digitar / no terminal abre as skills), já tem instalado. Clique "Validar agora" para confirmar.

Documentação oficial de instalação ↗

via probe· 2.1.41 (Claude Code)

1.4

VSCode

Feito

Editor recomendado para trabalhar com este template. Você provavelmente já tem se está lendo isso pelo browser na sua máquina.

Baixar VSCode ↗

via probe· 1.123.0

1.5

Git

Feito

Você provavelmente já tem (foi assim que clonou o repositório). Validar agora roda 'git --version' para confirmar.

Baixar Git ↗

via probe· 2.54.0.windows.1

Fase 2

Setup do CoCreate Studio (este painel)

Este dashboard. Se você está lendo isso, parte já está pronta automaticamente.

2.1

CoCreate Studio rodando

Feito

Se você não estivesse rodando o dashboard, esta página nem abriria. Pulou esta etapa automaticamente.

Porta canônica: 3001 · sempre http://localhost:3001. Útil quando você roda vários projetos em paralelo — sempre vem aqui que é o CoCreate Studio deste projeto.

2.2

node_modules instalados (harness-ui)

Feito

Dependências do dashboard instaladas. Tudo pronto.

2.3

Hooks da camada Harness configurados

Feito

Arquivo .claude/settings.json existe. Hooks PostToolUse e Stop configurados. Vão disparar na próxima vez que você abrir o Claude Code neste projeto.

Hooks registram quando uma spec é editada (em .claude/pending-validations.md) e geram lembretes no fim da sessão. Veja na aba Runtime deste dashboard para acompanhar.

Fase 3

Onboarding do projeto no Claude Code

Agora você abre o Claude Code no projeto (não neste app — em outro terminal) e roda 3 skills em sequência.

3.1

Abra o Claude Code no projeto

Feito

No VSCode, abra um terminal integrado (Ctrl+`) na raiz do projeto e digite:

Abrir Claude Code no projetopowershell

claude

Vai aparecer o prompt do Claude Code. Tudo que começa com / é uma skill.

via você

3.2

Rode /iniciar-projeto (GATILHO ZERO)

Feito

Briefing inicial detectado em docs/raw/00-perfil-projeto.md. Onboarding já foi feito.

✓docs/raw/00-perfil-projeto.md

✓docs/macro-processo.md

✓docs/analise-estrategica.md

3.3

Rode /processar-contexto (GATILHO 1)

Feito

2 spec(s) ativa(s) detectada(s) em docs/specs/.

✓docs/specs/spec-000-*.md (constitution)

✓CLAUDE.md sem placeholders {{...}}

3.4

Rode /preparar-missao para começar a trabalhar

A partir daqui, toda sessão começa com /preparar-missao. A skill analisa sua direção, define a missão e recomenda modo Rápido ou Orquestrado.

Comando no Claude Codeclaude-code

/preparar-missao
# ou com uma direção explicita:
/preparar-missao adicionar endpoint de health check no backend

Trace de hoje fica em .claude/traces/YYYY-MM-DD.md. Veja na aba Runtime deste dashboard.

Fase 4

Desenvolvimento do projeto

Com specs aprovadas, configure o ambiente do projeto em si. Detector cobre ~30 frameworks (Python, Node, Go, Rust, Ruby, PHP, Java, .NET, Flutter).

4.1

Configure o .env do projeto

Template .env.example existe na raiz. Copie e preencha com os valores reais.

Copiar e editar (Windows PowerShell)powershell

Copy-Item .env.example .env
notepad .env

NUNCA commite o .env — o template já tem em .gitignore.

4.2

Inicialize o backend

Feito

Backend detectado: Node.js (genérico) (Node) · package.json

4.3

Inicialize o frontend

Feito

Frontend detectado: Next.js (Node) · package.json

deps detectadas:nextreact

Próximos passos

O ciclo continua

Daqui em diante, o template está vivo. Continue usando as skills conforme a necessidade.

Implementar features

/executar-tarefa

Com loop de correção: até 3 tentativas em testes falhados antes de pedir ajuda. Nunca silencia testes.

Coordenar trabalho complexo

/orquestrar

Para missões multi-área (3+ skills). Coordena execução em paralelo sem sobrepor arquivos.

Validar coerência

/analisar-coerencia

Antes de fechar uma missão grande, valida specs vs código. Prioriza pendências registradas pelo hook.

Registrar lições

/licoes-aprendidas

Após erros ou descobertas não-óbvias. Consome TENTATIVAS falhadas do trace automaticamente.

Sempre que quiser ver o estado, abra as abas deste dashboard

Não são comandos do Claude Code. São páginas do CoCreate Studio (este app, rodando emhttp://localhost:3001). Use o menu no topo da página ou clique nos links abaixo.

· Visão geral — pulso (skills, subagents, execuções hoje, pendências)
· Runtime — timeline detalhada do que aconteceu hoje (auto-refresh 5s)
· Specs e ADRs — status de cada spec e ADR
· Skills e Subagents — referência rápida do que cada um faz
· Guia de uso — explicação metodológica do SDD + Harness

Slash commands de verdade (que você digita no terminal do Claude Code) começam com / e são as skills: /iniciar-projeto,/preparar-missao,/executar-tarefa,/orquestrar, etc. Veja a lista completa na aba Skills.