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

<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

Qualidade e utilidades

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

Configuração

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

Ajustes principais

Perfis de modelo

Troca rápida:

/thrunt:set-profile budget

Segurança

Endurecimento embutido

O THRUNT 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 /thrunt:help
• Reinstale com npx thrunt-god@latest

Em Docker/container?

• Defina CLAUDE_CONFIG_DIR antes da instalação:

CLAUDE_CONFIG_DIR=/home/youruser/.claude npx thrunt-god --global

Desinstalar

npx thrunt-god --claude --global --uninstall
npx thrunt-god --opencode --global --uninstall
npx thrunt-god --gemini --global --uninstall
npx thrunt-god --codex --global --uninstall
npx thrunt-god --copilot --global --uninstall
npx thrunt-god --cursor --global --uninstall
npx thrunt-god --antigravity --global --uninstall

Community Ports

OpenCode, Gemini CLI e Codex agora são suportados nativamente via npx thrunt-god.

Star History

Licença

Licença MIT. Veja LICENSE.