Use /gsd:new-project para inicializar um projeto completo com artefatos de planejamento, pesquisa de domínio e roadmap.
O /gsd:new-project é o ponto de entrada de todo projeto GSD. Ele inicia um processo interativo de coleta de contexto, pesquisa de domínio com agentes paralelos e geração de artefatos de planejamento.
CLAUDE CODE
/gsd:new-project
# Modo automático a partir de um PRD existente
/gsd:new-project --auto @prd.md
# Para código existente, mapeie primeiro
/gsd:map-codebase
/gsd:new-project.planning/
Após o /gsd:new-project, o diretório .planning/ conterá os seguintes artefatos:
PROJECT.md
Visão geral do projeto: objetivo, stack, stakeholders, definição de done. É a âncora de contexto lida no início de cada sessão.
REQUIREMENTS.md
Requisitos funcionais e não-funcionais categorizados por versão (v1 obrigatório, v2 futuro) com IDs rastreáveis (REQ-001, REQ-002...).
ROADMAP.md
Fases do projeto com objetivo, arquivos afetados, dependências e critérios de sucesso. Cada fase mapeia para requisitos específicos.
STATE.md
Memória entre sessões: fase atual, últimas decisões tomadas, contexto importante para continuar o trabalho em uma nova sessão.
config.json
Configurações do projeto: modo, granularidade, perfil de modelo, toggles de workflow. Editável via /gsd:settings.
research/
Diretório com pesquisa de domínio: STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md — gerados pelos agentes pesquisadores em paralelo.
Por padrão, .planning/ é commitado junto com o código. Isso permite colaboração e rastreabilidade. Se preferir manter privado, adicione ao .gitignore e configure planning.commit_docs: false no config.json.
Após o /gsd:new-project, o fluxo padrão é iterar pelas fases do roadmap com os comandos discuss → plan → execute → verify.
FLUXO COMPLETO
# 1. Inicializar
/gsd:new-project
# 2. Para cada fase do roadmap:
/gsd:discuss-phase 1 # Captura decisões de implementação
/gsd:plan-phase 1 # Pesquisa + planos atômicos
/gsd:execute-phase 1 # Executa em ondas paralelas
/gsd:verify-work 1 # UAT manual
# 3. Avançar
/gsd:discuss-phase 2
/gsd:plan-phase 2
...
# OU deixar o GSD decidir automaticamente:
/gsd:nextSe já tem código no projeto, mapeie antes de inicializar:
/gsd:map-codebase4 agentes analisam stack, arquitetura, qualidade e preocupações. O resultado vai para .planning/codebase/ e é usado automaticamente pelo new-project.
/gsd:next para avançar automaticamente/gsd:settingsSe o /gsd:new-project falha com "PROJECT.md already exists", o projeto já foi inicializado. Use /gsd:progress para ver o estado atual.