msd-core/README.pt-BR.md

⚠️ This is an active fork. See the English README for the full notice about the original repo.

GET SHIT DONE

English · Português · 简体中文 · 日本語

Um sistema leve e poderoso de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificação para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae e Cline.

Resolve context rot — a degradação de qualidade que acontece conforme o Claude enche a janela de contexto.

npx @opengsd/get-shit-done-redux@latest

Funciona em Mac, Windows e Linux.

"Se você sabe claramente o que quer, isso VAI construir para você. Sem enrolação."

"Eu já usei SpecKit, OpenSpec e Taskmaster — este me deu os melhores resultados."

"De longe a adição mais poderosa ao meu Claude Code. Nada superengenheirado. Simplesmente faz o trabalho."

Confiado por engenheiros da Amazon, Google, Shopify e Webflow.

Por que eu criei isso · Como funciona · Comandos · Por que funciona · Guia do usuário

---

Por que eu criei isso

Sou desenvolvedor solo. Eu não escrevo código — o Claude Code escreve.

Existem outras ferramentas de desenvolvimento orientado por especificação. BMAD, Speckit... Mas quase todas parecem mais complexas do que o necessário (cerimônias de sprint, story points, sync com stakeholders, retrospectivas, fluxos Jira) ou não entendem de verdade o panorama do que você está construindo. Eu não sou uma empresa de software com 50 pessoas. Não quero teatro corporativo. Só quero construir coisas boas que funcionem.

Então eu criei o GSD. A complexidade fica no sistema, não no seu fluxo. Por trás: engenharia de contexto, formatação XML de prompts, orquestração de subagentes, gerenciamento de estado. O que você vê: alguns comandos que simplesmente funcionam.

O sistema dá ao Claude tudo que ele precisa para fazer o trabalho e validar o resultado. Eu confio no fluxo. Ele entrega.

— TÂCHES

---

Vibe coding ganhou má fama. Você descreve algo, a IA gera código, e sai um resultado inconsistente que quebra em escala.

O GSD corrige isso. É a camada de engenharia de contexto que torna o Claude Code confiável.

---

Para quem é

Para quem quer descrever o que precisa e receber isso construído do jeito certo — sem fingir que está rodando uma engenharia de 50 pessoas.

Quality gates embutidos capturam problemas reais: detecção de schema drift sinaliza mudanças ORM sem migrations, segurança ancora verificação a modelos de ameaça, e detecção de redução de escopo impede o planner de descartar requisitos silenciosamente.

Destaques v1.39.0

Lista completa nas notas de release v1.39.0.

• Perfil de instalação --minimal — alias --core-only. Instala apenas os 6 skills do loop principal (new-project, discuss-phase, plan-phase, execute-phase, help, update) e nenhum subagente gsd-*. Reduz o overhead do system prompt no cold-start de ~12k para ~700 tokens (≥94% de redução). Útil para LLMs locais com contexto de 32K–128K e APIs cobradas por token.
• /gsd-phase --edit — edita qualquer campo de uma fase existente em ROADMAP.md no lugar, sem alterar o número ou a posição. --force pula o diff de confirmação; referências em depends_on são validadas e o STATE.md é atualizado na escrita.
• Build & test gate pós-merge — o passo 5.6 de execute-phase agora detecta automaticamente o comando de build em workflow.build_command, com fallback para Xcode (.xcodeproj), Makefile, Justfile, Cargo, Go, Python ou npm. Projetos Xcode/iOS rodam xcodebuild build e xcodebuild test automaticamente. Funciona em modo paralelo e serial.
• Modelo de review por runtime — review.models.<cli> permite que cada CLI externa de review (codex, gemini, etc.) escolha seu próprio modelo, independente do perfil de planner/executor.
• Herança de configuração de workstream — quando GSD_WORKSTREAM está definido, o .planning/config.json raiz é carregado primeiro e merge-deep com o config da workstream (workstream vence em conflito). Um null explícito no config da workstream sobrescreve corretamente o valor raiz.
• Workflow manual de canary release — .github/workflows/canary.yml publica builds {base}-canary.{N} de @opengsd/get-shit-done-redux e @opengsd/gsd-sdk na dist-tag @canary a partir de dev, sob demanda via workflow_dispatch.
• Consolidação de skills: 86 → 59 — 4 novos skills agrupados (capture, phase, config, workspace) absorvem 31 micro-skills. 6 skills pais existentes absorvem wrap-up e sub-operações como flags: update --sync/--reapply, sketch --wrap-up, spike --wrap-up, map-codebase --fast/--query, code-review --fix, progress --do/--next. Sem perda funcional.

---

Primeiros passos

npx @opengsd/get-shit-done-redux@latest

O instalador pede:

1. Runtime — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, ou todos
2. Local — Global (todos os projetos) ou local (apenas projeto atual)

Verifique com:

• Claude Code / Gemini / Copilot / Antigravity: /gsd-help
• OpenCode / Kilo / Augment / Trae: /gsd-help
• Codex: $gsd-help
• Cline: GSD instala via .clinerules — verifique se .clinerules existe

Note

Claude Code 2.1.88+ e Codex instalam como skills (skills/gsd-*/SKILL.md). Cline usa .clinerules. O instalador lida com todos os formatos automaticamente.

Tip

Para instalação a partir do código-fonte ou ambientes sem npm, consulte docs/manual-update.md.

Mantendo atualizado

npx @opengsd/get-shit-done-redux@latest

Instalação não interativa (Docker, CI, Scripts)

# Claude Code
npx @opengsd/get-shit-done-redux --claude --global
npx @opengsd/get-shit-done-redux --claude --local

# OpenCode
npx @opengsd/get-shit-done-redux --opencode --global

# Gemini CLI
npx @opengsd/get-shit-done-redux --gemini --global

# Kilo
npx @opengsd/get-shit-done-redux --kilo --global
npx @opengsd/get-shit-done-redux --kilo --local

# Codex
npx @opengsd/get-shit-done-redux --codex --global
npx @opengsd/get-shit-done-redux --codex --local

# Copilot
npx @opengsd/get-shit-done-redux --copilot --global
npx @opengsd/get-shit-done-redux --copilot --local

# Cursor
npx @opengsd/get-shit-done-redux --cursor --global
npx @opengsd/get-shit-done-redux --cursor --local

# Antigravity
npx @opengsd/get-shit-done-redux --antigravity --global
npx @opengsd/get-shit-done-redux --antigravity --local

# Augment
npx @opengsd/get-shit-done-redux --augment --global     # Install to ~/.augment/
npx @opengsd/get-shit-done-redux --augment --local      # Install to ./.augment/

# Trae
npx @opengsd/get-shit-done-redux --trae --global        # Install to ~/.trae/
npx @opengsd/get-shit-done-redux --trae --local         # Install to ./.trae/

# Cline
npx @opengsd/get-shit-done-redux --cline --global       # Install to ~/.cline/
npx @opengsd/get-shit-done-redux --cline --local        # Install to ./.clinerules

# Todos
npx @opengsd/get-shit-done-redux --all --global

Use --global (-g) ou --local (-l) para pular a pergunta de local. Use --claude, --opencode, --gemini, --kilo, --codex, --copilot, --cursor, --windsurf, --antigravity, --augment, --trae, --cline ou --all para pular a pergunta de runtime.

Recomendado: modo sem permissões

claude --dangerously-skip-permissions

Tip

Esse é o modo pensado para o GSD: aprovar date e git commit 50 vezes mata a produtividade.

---

Como funciona

Já tem código? Rode /gsd-map-codebase primeiro para analisar stack, arquitetura, convenções e riscos.

1. Inicializar projeto

/gsd-new-project

O sistema:

1. Pergunta até entender seu objetivo
2. Pesquisa o domínio com agentes em paralelo
3. Extrai requisitos (v1, v2 e fora de escopo)
4. Monta roadmap por fases

Cria: PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, .planning/research/

2. Discutir fase

/gsd-discuss-phase 1

Captura suas preferências de implementação antes do planejamento.

Cria: {phase_num}-CONTEXT.md

3. Planejar fase

/gsd-plan-phase 1

1. Pesquisa abordagens
2. Cria 2-3 planos atômicos em XML
3. Verifica contra os requisitos

Cria: {phase_num}-RESEARCH.md, {phase_num}-{N}-PLAN.md

4. Executar fase

/gsd-execute-phase 1

1. Executa planos em ondas
2. Contexto novo por plano
3. Commit atômico por tarefa
4. Verifica contra objetivos

Cria: {phase_num}-{N}-SUMMARY.md, {phase_num}-VERIFICATION.md

5. Verificar trabalho

/gsd-verify-work 1

Validação manual orientada para confirmar que a feature realmente funciona como esperado.

Cria: {phase_num}-UAT.md e planos de correção se necessário

6. Repetir -> Entregar -> Completar

/gsd-discuss-phase 2
/gsd-plan-phase 2
/gsd-execute-phase 2
/gsd-verify-work 2
/gsd-ship 2
/gsd-complete-milestone
/gsd-new-milestone

Ou deixe o GSD decidir:

/gsd-progress --next

Modo rápido

/gsd-quick

Para tarefas ad-hoc sem ciclo completo de planejamento.

---

Por que funciona

Engenharia de contexto

Arquivo	Papel
PROJECT.md	Visão do projeto
research/	Conhecimento do ecossistema
REQUIREMENTS.md	Escopo v1/v2
ROADMAP.md	Direção e progresso
STATE.md	Memória entre sessões
PLAN.md	Tarefa atômica com XML
SUMMARY.md	O que mudou
todos/	Ideias para depois
threads/	Contexto persistente
seeds/	Ideias para próximos marcos

Formato XML de prompt

<task type="auto">
  <name>Create login endpoint</name>
  <files>src/app/api/auth/login/route.ts</files>
  <action>
    Use jose for JWT (not jsonwebtoken - CommonJS issues).
    Validate credentials against users table.
    Return httpOnly cookie on success.
  </action>
  <verify>curl -X POST localhost:3000/api/auth/login returns 200 + Set-Cookie</verify>
  <done>Valid credentials return cookie, invalid return 401</done>
</task>

Orquestração multiagente

Um orquestrador leve chama agentes especializados para pesquisa, planejamento, execução e verificação.

Commits atômicos

Cada tarefa gera commit próprio, facilitando git bisect, rollback e rastreabilidade.

---

Comandos

Fluxo principal

Comando	O que faz
/gsd-new-project [--auto]	Inicializa projeto completo
/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]	Captura decisões antes do plano (--chain encadeia automaticamente em plan+execute)
/gsd-plan-phase [N] [--auto] [--reviews]	Pesquisa + plano + validação
/gsd-execute-phase <N>	Executa planos em ondas paralelas
/gsd-verify-work [N]	UAT manual
/gsd-ship [N] [--draft]	Cria PR da fase validada
/gsd-progress --next	Avança automaticamente para o próximo passo
/gsd-fast <text>	Tarefas triviais sem planejamento
/gsd-complete-milestone	Fecha o marco e marca release
/gsd-new-milestone [name]	Inicia próximo marco

Qualidade e utilidades

Comando	O que faz
/gsd-review	Peer review com múltiplas IAs
/gsd-pr-branch	Cria branch limpa para PR
/gsd-settings	Configura perfis e agentes
/gsd-config --profile <profile>	Troca perfil (quality/balanced/budget/inherit)
/gsd-quick [--full] [--discuss] [--research]	Execução rápida com garantias do GSD (--full ativa todas as etapas, --validate ativa apenas verificação)
/gsd-health [--repair]	Verifica e repara .planning/

Para a lista completa de comandos e opções, use /gsd-help.

---

Configuração

As configurações do projeto ficam em .planning/config.json. Você pode configurar no /gsd-new-project ou ajustar depois com /gsd-settings.

Ajustes principais

Configuração	Opções	Padrão	Controle
mode	yolo, interactive	interactive	Autoaprovar vs confirmar etapas
granularity	coarse, standard, fine	standard	Granularidade de fases/planos

Perfis de modelo

Perfil	Planejamento	Execução	Verificação
quality	Opus	Opus	Sonnet
balanced	Opus	Sonnet	Sonnet
budget	Sonnet	Sonnet	Haiku
inherit	Inherit	Inherit	Inherit

Troca rápida:

/gsd-config --profile budget

---

Segurança

Endurecimento embutido

O GSD inclui proteções como:

• prevenção de path traversal
• detecção de prompt injection
• validação de argumentos de shell
• parsing seguro de JSON
• scanner de injeção para CI

Protegendo arquivos sensíveis

Adicione padrões sensíveis ao deny list do Claude Code:

{
  "permissions": {
    "deny": [
      "Read(.env)",
      "Read(.env.*)",
      "Read(**/secrets/*)",
      "Read(**/*credential*)",
      "Read(**/*.pem)",
      "Read(**/*.key)"
    ]
  }
}

---

Solução de problemas

Comandos não apareceram após instalar?

• Reinicie o runtime
• Verifique se os arquivos foram instalados no diretório correto

Comandos não funcionam como esperado?

• Rode /gsd-help
• Reinstale com npx @opengsd/get-shit-done-redux@latest

Em Docker/container?

• Defina CLAUDE_CONFIG_DIR antes da instalação:

CLAUDE_CONFIG_DIR=/home/youruser/.claude npx @opengsd/get-shit-done-redux --global

Desinstalar

# Instalações globais
npx @opengsd/get-shit-done-redux --claude --global --uninstall
npx @opengsd/get-shit-done-redux --opencode --global --uninstall
npx @opengsd/get-shit-done-redux --gemini --global --uninstall
npx @opengsd/get-shit-done-redux --kilo --global --uninstall
npx @opengsd/get-shit-done-redux --codex --global --uninstall
npx @opengsd/get-shit-done-redux --copilot --global --uninstall
npx @opengsd/get-shit-done-redux --cursor --global --uninstall
npx @opengsd/get-shit-done-redux --antigravity --global --uninstall
npx @opengsd/get-shit-done-redux --augment --global --uninstall
npx @opengsd/get-shit-done-redux --trae --global --uninstall
npx @opengsd/get-shit-done-redux --cline --global --uninstall

# Instalações locais (projeto atual)
npx @opengsd/get-shit-done-redux --claude --local --uninstall
npx @opengsd/get-shit-done-redux --opencode --local --uninstall
npx @opengsd/get-shit-done-redux --gemini --local --uninstall
npx @opengsd/get-shit-done-redux --kilo --local --uninstall
npx @opengsd/get-shit-done-redux --codex --local --uninstall
npx @opengsd/get-shit-done-redux --copilot --local --uninstall
npx @opengsd/get-shit-done-redux --cursor --local --uninstall
npx @opengsd/get-shit-done-redux --antigravity --local --uninstall
npx @opengsd/get-shit-done-redux --augment --local --uninstall
npx @opengsd/get-shit-done-redux --trae --local --uninstall
npx @opengsd/get-shit-done-redux --cline --local --uninstall

---

Community Ports

OpenCode, Gemini CLI, Kilo e Codex agora são suportados nativamente via npx @opengsd/get-shit-done-redux.

Projeto	Plataforma	Descrição
gsd-opencode	OpenCode	Adaptação original para OpenCode
gsd-gemini (archived)	Gemini CLI	Adaptação original para Gemini por uberfuzzy

---

Star History

---

Licença

Licença MIT. Veja LICENSE.

---

Claude Code é poderoso. O GSD o torna confiável.