npx thrunt-god@latest

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 THRUNT. 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 THRUNT 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.

Primeiros passos

npx thrunt-god@latest

O instalador pede:

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

Verifique com:

• Claude Code / Gemini: /thrunt:help
• OpenCode: /thrunt-help
• Codex: $thrunt-help
• Copilot: /thrunt:help
• Antigravity: /thrunt:help

[!NOTE] A instalação do Codex usa skills (skills/thrunt-*/SKILL.md) em vez de prompts customizados.

Mantendo atualizado

npx thrunt-god@latest

# Claude Code
npx thrunt-god --claude --global
npx thrunt-god --claude --local

# OpenCode
npx thrunt-god --opencode --global

# Gemini CLI
npx thrunt-god --gemini --global

# Codex
npx thrunt-god --codex --global
npx thrunt-god --codex --local

# Copilot
npx thrunt-god --copilot --global
npx thrunt-god --copilot --local

# Cursor
npx thrunt-god --cursor --global
npx thrunt-god --cursor --local

# Antigravity
npx thrunt-god --antigravity --global
npx thrunt-god --antigravity --local

# Todos
npx thrunt-god --all --global

Recomendado: modo sem permissões

claude --dangerously-skip-permissions

[!TIP] Esse é o modo pensado para o THRUNT: aprovar date e git commit 50 vezes mata a produtividade.

Como funciona

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

1. Inicializar projeto

/hunt:new-program

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 huntmap por fases

Cria: MISSION.md, HYPOTHESES.md, HUNTMAP.md, STATE.md, .planning/research/

2. Discutir fase

/hunt:shape-hypothesis 1

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

Cria: {phase_num}-CONTEXT.md

3. Planejar fase

/hunt:plan 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

/hunt:run 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}-FINDINGS.md

5. Verificar trabalho

/hunt:validate-findings 1

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

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

6. Repetir -> Entregar -> Completar

/hunt:shape-hypothesis 2
/hunt:plan 2
/hunt:run 2
/hunt:validate-findings 2
/hunt:publish 2
/thrunt:complete-milestone
/hunt:new-program

Ou deixe o THRUNT decidir:

/thrunt:next

Modo rápido

/thrunt:quick

Para tarefas ad-hoc sem ciclo completo de planejamento.

Por que funciona

Engenharia de contexto

Formato XML de prompt