get-shit-done/docs/pt-BR/CONFIGURATION.md

Referência de Configuração do GSD

Configurações do projeto ficam em .planning/config.json.
Esta versão resume os parâmetros principais em Português. Para schema completo, veja inglês.

---

Estrutura base

{
  "mode": "interactive",
  "granularity": "standard",
  "model_profile": "balanced",
  "planning": {
    "commit_docs": true,
    "search_gitignored": false
  },
  "workflow": {
    "research": true,
    "plan_check": true,
    "verifier": true,
    "nyquist_validation": true,
    "ui_phase": true,
    "ui_safety_gate": true,
    "research_before_questions": false,
    "discuss_mode": "standard",
    "skip_discuss": false
  }
}

Configurações principais

Chave	Opções	Padrão	Descrição
mode	interactive, yolo	interactive	yolo autoaprova; interactive confirma cada etapa
granularity	coarse, standard, fine	standard	Granularidade de fases/planos
model_profile	quality, balanced, budget, inherit	balanced	Perfil de modelos por agente

Planning

Chave	Padrão	Descrição
planning.commit_docs	true	Comitar .planning/ no git
planning.search_gitignored	false	Incluir arquivos ignorados em buscas amplas

Workflow toggles

Chave	Padrão	Descrição
workflow.research	true	Pesquisa antes de planejar
workflow.plan_check	true	Loop de verificação de plano
workflow.verifier	true	Verificação pós-execução
workflow.nyquist_validation	true	Camada de validação automatizada por requisito
workflow.ui_phase	true	Contrato de UI para fases frontend
workflow.ui_safety_gate	true	Gate de segurança para registry UI
workflow.research_before_questions	false	Pesquisa antes da discussão
workflow.discuss_mode	standard	Discussão aberta; use assumptions para modo baseado em código
workflow.skip_discuss	false	Pula discuss-phase no modo autônomo

Git branching

Chave	Opções	Padrão	Descrição
git.branching_strategy	none, phase, milestone	none	Estratégia de criação de branches
git.phase_branch_template	string	gsd/phase-{phase}-{slug}	Nome para branch por fase
git.milestone_branch_template	string	gsd/{milestone}-{slug}	Nome para branch de milestone
git.quick_branch_template	string ou null	null	Branch opcional para /gsd-quick

Perfis de modelo

Perfil	Objetivo
quality	Melhor qualidade, maior custo
balanced	Equilíbrio (padrão recomendado)
budget	Menor custo
inherit	Herdar modelo da sessão/runtime

Troca rápida:

/gsd-config --profile budget

Novidades de configuração v1.31--v1.32

Chave	Tipo	Padrão	Descrição
workflow.use_worktrees	boolean	true	Desativa isolamento por git worktree quando false (v1.31)
security_enforcement	boolean	true	Ativa verificação de segurança ancorada em threat model (v1.31)
security_asvs_level	number (1-3)	1	Nível de verificação OWASP ASVS (v1.31)
security_block_on	string	"high"	Severidade mínima para bloquear avanço de fase (v1.31)
response_language	string	(nenhum)	Código de idioma para saída dos agentes (ex: "pt", "ko", "ja") (v1.32)
project_code	string	(nenhum)	Prefixo para diretórios de fase (ex: "ABC" -> ABC-01-setup/) (v1.31)

Variáveis de ambiente adicionais:

Variável	Finalidade
GSD_SKIP_SCHEMA_CHECK	Desativa detecção de schema drift (v1.31)