O arquivo .planning/config.json é o centro de controle do GSD. Aqui você vai entender cada seção, quando alterar cada toggle e quais presets usar para cada cenário de desenvolvimento.
O config.json é criado em /gsd:new-project e atualizado interativamente via /gsd:settings. Regra central: ausência = habilitado para todos os toggles de workflow.
.planning/config.json — schema completo
{
"mode": "interactive",
"granularity": "standard",
"model_profile": "balanced",
"model_overrides": {},
"planning": {
"commit_docs": true,
"search_gitignored": false
},
"workflow": {
"research": true,
"plan_check": true,
"verifier": true,
"auto_advance": false,
"nyquist_validation": true,
"ui_phase": true,
"ui_safety_gate": true,
"node_repair": true,
"node_repair_budget": 2,
"discuss_mode": "discuss",
"skip_discuss": false,
"text_mode": false,
"use_worktrees": true
},
"hooks": {
"context_warnings": true,
"workflow_guard": false
},
"parallelization": {
"enabled": true,
"plan_level": true,
"task_level": false,
"skip_checkpoints": true,
"max_concurrent_agents": 3,
"min_plans_for_parallel": 2
},
"git": {
"branching_strategy": "none",
"phase_branch_template": "gsd/phase-{phase}-{slug}",
"milestone_branch_template": "gsd/{milestone}-{slug}",
"quick_branch_template": null
},
"gates": {
"confirm_project": true,
"confirm_phases": true,
"confirm_roadmap": true,
"confirm_breakdown": true,
"confirm_plan": true,
"execute_next_plan": true,
"issues_review": true,
"confirm_transition": true
},
"safety": {
"always_confirm_destructive": true,
"always_confirm_external_services": true
},
"security_enforcement": true,
"security_asvs_level": 1,
"security_block_on": "high",
"agent_skills": {}
}| Chave | Opções | Descrição |
|---|---|---|
| mode | interactive | yolo | yolo aprova decisões automaticamente; interactive confirma em cada etapa |
| granularity | coarse | standard | fine | Quantidade de fases: coarse=3-5, standard=5-8, fine=8-12 |
| model_profile | quality | balanced | budget | inherit | Tier de modelo para cada agente |
| project_code | string | Prefixo nos diretórios de fase: "ABC" → ABC-01-setup/ |
| Agente | quality | balanced | budget |
|---|---|---|---|
| gsd-planner | Opus | Opus | Sonnet |
| gsd-executor | Opus | Sonnet | Sonnet |
| gsd-verifier | Sonnet | Sonnet | Haiku |
| gsd-codebase-mapper | Sonnet | Haiku | Haiku |
| gsd-debugger | Opus | Sonnet | Sonnet |
Override por agente (sem mudar o perfil global)
{
"model_profile": "balanced",
"model_overrides": {
"gsd-executor": "opus",
"gsd-planner": "haiku"
}
}Todos os toggles seguem o padrão ausência = habilitado. Se a chave não existir no config, o default é true.
| Toggle | Default | Efeito quando false |
|---|---|---|
| workflow.research | true | Pula pesquisa de domínio antes do planejamento |
| workflow.plan_check | true | Desativa loop de verificação de planos (até 3 iterações) |
| workflow.verifier | true | Desativa verificação pós-execução vs. objetivos da fase |
| workflow.auto_advance | false | Quando true: encadeia discuss→plan→execute sem parar |
| workflow.nyquist_validation | true | Pula mapeamento de cobertura de testes (não recomendado) |
| workflow.node_repair | true | Desativa reparo automático em falhas de verificação |
| workflow.use_worktrees | true | Desativa isolamento por git worktree na execução paralela |
| workflow.skip_discuss | false | Quando true: /gsd:autonomous pula discuss-phase |
| workflow.text_mode | false | Quando true: menus TUI → listas numeradas (sessões remotas /rc) |
| Strategy | Cria branch | Escopo | Melhor para |
|---|---|---|---|
| none | Nunca | — | Desenvolvimento solo, projetos simples |
| phase | execute-phase | 1 fase | Code review por fase, rollback granular |
| milestone | 1º execute-phase | Todas as fases | Release branches, PR por versão |
Exemplo — strategy phase com quick tasks em branch
{
"git": {
"branching_strategy": "phase",
"phase_branch_template": "gsd/phase-{phase}-{slug}",
"quick_branch_template": "gsd/quick-{num}-{slug}"
}
}Prototipagem Rápida
{
"mode": "yolo",
"granularity": "coarse",
"model_profile": "budget",
"workflow": {
"research": false,
"plan_check": false,
"verifier": false
}
}Mínimo de confirmações, menos fases, modelos econômicos
Desenvolvimento Normal
{
"mode": "interactive",
"granularity": "standard",
"model_profile": "balanced"
// todos os defaults
}Configuração padrão gerada pelo /gsd:new-project
Release de Produção
{
"mode": "interactive",
"granularity": "fine",
"model_profile": "quality",
"git": {
"branching_strategy": "phase"
}
}Máxima qualidade, mais fases, branch por fase