npx thrunt-god@latest

なぜ作ったのか

私はソロ開発者です。コードは自分で書きません — Claude Codeが書きます。

仕様駆動開発ツールは他にもあります。BMAD、Spekkitなど。しかしどれも必要以上に複雑にしているように見えます（スプリントセレモニー、ストーリーポイント、ステークホルダーとの同期、振り返り、Jiraワークフローなど）。あるいは、何を作ろうとしているのかの全体像を本当には理解していません。私は50人規模のソフトウェア会社ではありません。エンタープライズごっこをしたいわけではありません。ただ、うまく動く素晴らしいものを作りたいクリエイティブな人間です。

だからTHRUNTを作りました。複雑さはシステムの中にあり、ワークフローの中にはありません。裏側では、コンテキストエンジニアリング、XMLプロンプトフォーマッティング、サブエージェントのオーケストレーション、状態管理が動いています。あなたが目にするのは、ただ動くいくつかのコマンドだけです。

このシステムは、Claudeが仕事をし、かつ検証するために必要なすべてを提供します。私はこのワークフローを信頼しています。ちゃんといい仕事をしてくれます。

これがTHRUNTです。エンタープライズごっこは一切なし。Claude Codeを使って一貫してクールなものを作るための、非常に効果的なシステムです。

— TÂCHES

バイブコーディングは評判が悪い。やりたいことを説明し、AIがコードを生成し、スケールすると崩壊する一貫性のないゴミが出来上がる。

THRUNTはそれを解決します。Claude Codeを信頼性の高いものにするコンテキストエンジニアリングレイヤーです。アイデアを説明し、システムに必要なすべてを抽出させ、Claude Codeに仕事をさせましょう。

こんな人のために

やりたいことを説明するだけで正しく構築してほしい人 — 50人のエンジニア組織を運営しているふりをせずに。

はじめに

npx thrunt-god@latest

インストーラーが以下の選択を求めます：

1. ランタイム — Claude Code、OpenCode、Gemini、Codex、Copilot、Cursor、Antigravity、またはすべて（インタラクティブ複数選択 — 1回のインストールセッションで複数のランタイムを選択可能）
2. インストール先 — グローバル（全プロジェクト）またはローカル（現在のプロジェクトのみ）

確認方法：

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

[!NOTE] Codexのインストールでは、カスタムプロンプトではなくスキル（skills/thrunt-*/SKILL.md）を使用します。

最新の状態を保つ

THRUNTは急速に進化しています。定期的にアップデートしてください：

npx thrunt-god@latest

# Claude Code
npx thrunt-god --claude --global   # ~/.claude/ にインストール
npx thrunt-god --claude --local    # ./.claude/ にインストール

# OpenCode（オープンソース、無料モデル）
npx thrunt-god --opencode --global # ~/.config/opencode/ にインストール

# Gemini CLI
npx thrunt-god --gemini --global   # ~/.gemini/ にインストール

# Codex（スキルファースト）
npx thrunt-god --codex --global    # ~/.codex/ にインストール
npx thrunt-god --codex --local     # ./.codex/ にインストール

# Copilot（GitHub Copilot CLI）
npx thrunt-god --copilot --global  # ~/.github/ にインストール
npx thrunt-god --copilot --local   # ./.github/ にインストール

# Cursor CLI
npx thrunt-god --cursor --global      # ~/.cursor/ にインストール
npx thrunt-god --cursor --local       # ./.cursor/ にインストール

# Antigravity（Google、スキルファースト、Geminiベース）
npx thrunt-god --antigravity --global # ~/.gemini/antigravity/ にインストール
npx thrunt-god --antigravity --local  # ./.agent/ にインストール

# 全ランタイム
npx thrunt-god --all --global      # すべてのディレクトリにインストール

git clone https://github.com/thrunt-build/thrunt-god.git
cd thrunt-god
node bin/install.js --claude --local

推奨：パーミッションスキップモード

THRUNTは摩擦のない自動化のために設計されています。Claude Codeを以下のように実行してください：

claude --dangerously-skip-permissions

[!TIP] これがTHRUNTの意図された使い方です — date や git commit を50回も承認するために止まっていては目的が台無しです。

{
  "permissions": {
    "allow": [
      "Bash(date:*)",
      "Bash(echo:*)",
      "Bash(cat:*)",
      "Bash(ls:*)",
      "Bash(mkdir:*)",
      "Bash(wc:*)",
      "Bash(head:*)",
      "Bash(tail:*)",
      "Bash(sort:*)",
      "Bash(grep:*)",
      "Bash(tr:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git status:*)",
      "Bash(git log:*)",
      "Bash(git diff:*)",
      "Bash(git tag:*)"
    ]
  }
}

仕組み

既存のコードがある場合は？ まず /hunt:map-environment を実行してください。並列エージェントが起動し、スタック、アーキテクチャ、規約、懸念点を分析します。その後 /hunt:new-program がコードベースを把握した状態で動作し、質問は追加する内容に焦点を当て、計画時にはパターンが自動的に読み込まれます。

1. プロジェクトの初期化

/hunt:new-program

1つのコマンド、1つのフロー。システムが以下を行います：

1. 質問 — アイデアを完全に理解するまで質問します（目標、制約、技術的な好み、エッジケース）
2. リサーチ — 並列エージェントが起動しドメインを調査します（オプションですが推奨）
3. 要件定義 — v1、v2、スコープ外を抽出します
4. ロードマップ — 要件に紐づくフェーズを作成します

ロードマップを承認します。これでビルドの準備が整いました。

作成されるファイル： MISSION.md、HYPOTHESES.md、HUNTMAP.md、STATE.md、.planning/research/

2. フェーズの議論

/hunt:shape-hypothesis 1

ここで実装の方向性を決めます。

ロードマップには各フェーズにつき1〜2文しかありません。あなたが想像する通りに構築するには十分なコンテキストではありません。このステップでは、リサーチや計画の前にあなたの好みを記録します。

システムがフェーズを分析し、構築内容に基づいてグレーゾーンを特定します：

• ビジュアル機能 → レイアウト、密度、インタラクション、空状態
• API/CLI → レスポンス形式、フラグ、エラーハンドリング、詳細度
• コンテンツシステム → 構造、トーン、深さ、フロー
• 整理タスク → グルーピング基準、命名、重複、例外

選択した各領域について、あなたが満足するまで質問します。出力される CONTEXT.md は、次の2つのステップに直接反映されます：

1. リサーチャーが読む — どんなパターンを調査すべきかを把握（「ユーザーはカードレイアウトを希望」→ カードコンポーネントライブラリを調査）
2. プランナーが読む — どの決定が確定済みかを把握（「無限スクロールに決定」→ スクロール処理を計画に含める）

ここで深く掘り下げるほど、システムはあなたが本当に望むものを構築します。スキップすれば妥当なデフォルトが使われます。活用すればあなたのビジョンが反映されます。

作成されるファイル： {phase_num}-CONTEXT.md

前提モード： 質問よりもコードベース分析を優先したい場合は、/thrunt:settings で workflow.discuss_mode を assumptions に設定してください。システムがコードを読み、何をなぜそうするかを提示し、間違っている部分だけ修正を求めます。詳しくはディスカスモードをご覧ください。

3. フェーズの計画

/hunt:plan 1

システムが以下を行います：

1. リサーチ — CONTEXT.mdの決定事項をもとに、このフェーズの実装方法を調査します
2. 計画 — XML構造で2〜3個のアトミックなタスクプランを作成します
3. 検証 — プランを要件と照合し、合格するまでループします

各プランは新しいコンテキストウィンドウで実行できるほど小さくなっています。品質の劣化も「もっと簡潔にしますね」もありません。

作成されるファイル： {phase_num}-RESEARCH.md、{phase_num}-{N}-PLAN.md

4. フェーズの実行

/hunt:run 1

システムが以下を行います：

1. ウェーブでプランを実行 — 可能な限り並列、依存関係がある場合は逐次
2. プランごとにフレッシュなコンテキスト — 実装に200kトークンをフル活用、蓄積されたゴミはゼロ
3. タスクごとにコミット — 各タスクが独自のアトミックコミットを取得
4. 目標に対して検証 — コードベースがフェーズの約束を果たしているか確認

席を離れて、戻ってきたらクリーンなgit履歴とともに完了した作業が待っています。

ウェーブ実行の仕組み：

プランは依存関係に基づいて「ウェーブ」にグループ化されます。各ウェーブ内のプランは並列実行されます。ウェーブは逐次実行されます。

┌────────────────────────────────────────────────────────────────────┐
│  PHASE EXECUTION                                                   │
├────────────────────────────────────────────────────────────────────┤
│                                                                    │
│  WAVE 1 (parallel)          WAVE 2 (parallel)          WAVE 3      │
│  ┌─────────┐ ┌─────────┐    ┌─────────┐ ┌─────────┐    ┌─────────┐ │
│  │ Plan 01 │ │ Plan 02 │ →  │ Plan 03 │ │ Plan 04 │ →  │ Plan 05 │ │
│  │         │ │         │    │         │ │         │    │         │ │
│  │ User    │ │ Product │    │ Orders  │ │ Cart    │    │ Checkout│ │
│  │ Model   │ │ Model   │    │ API     │ │ API     │    │ UI      │ │
│  └─────────┘ └─────────┘    └─────────┘ └─────────┘    └─────────┘ │
│       │           │              ↑           ↑              ↑      │
│       └───────────┴──────────────┴───────────┘              │      │
│              Dependencies: Plan 03 needs Plan 01            │      │
│                          Plan 04 needs Plan 02              │      │
│                          Plan 05 needs Plans 03 + 04        │      │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

ウェーブが重要な理由：

• 独立したプラン → 同じウェーブ → 並列実行
• 依存するプラン → 後のウェーブ → 依存関係を待つ
• ファイル競合 → 逐次プランまたは同一プラン内

これが「バーティカルスライス」（Plan 01: ユーザー機能をエンドツーエンド）が「ホリゾンタルレイヤー」（Plan 01: 全モデル、Plan 02: 全API）より並列化に適している理由です。

作成されるファイル： {phase_num}-{N}-SUMMARY.md、{phase_num}-FINDINGS.md

5. 作業の検証

/hunt:validate-findings 1

ここで実際に動作するか確認します。

自動検証はコードの存在とテストの合格を確認します。しかし、その機能は期待通りに動作していますか？ここはあなたが実際に使ってみる場です。

システムが以下を行います：

1. テスト可能な成果物を抽出 — 今できるようになっているはずのこと
2. 1つずつ案内 — 「メールでログインできますか？」はい/いいえ、または何が問題かを説明
3. 障害を自動診断 — デバッグエージェントが起動し根本原因を特定
4. 検証済みの修正プランを作成 — 即座に再実行可能

すべてパスすれば次に進みます。何か壊れていれば、手動でデバッグする必要はありません — 作成された修正プランで /hunt:run を再度実行するだけです。

作成されるファイル： {phase_num}-EVIDENCE_REVIEW.md、問題が見つかった場合は修正プラン

6. 繰り返し → シップ → 完了 → 次のマイルストーン

/hunt:shape-hypothesis 2
/hunt:plan 2
/hunt:run 2
/hunt:validate-findings 2
/hunt:publish 2                  # 検証済みの作業からPRを作成
...
/thrunt:complete-milestone
/hunt:new-program

またはTHRUNTに次のステップを自動判定させます：

/thrunt:next                    # 次のステップを自動検出して実行

discuss → plan → execute → verify → publish のループをマイルストーン完了まで繰り返します。

ディスカッション中のインプットを速くしたい場合は、/hunt:shape-hypothesis <n> --batch で1つずつではなく小さなグループにまとめた質問に一括で回答できます。

各フェーズであなたのインプット（discuss）、適切なリサーチ（plan）、クリーンな実行（execute）、人間による検証（verify）が行われます。コンテキストは常にフレッシュ。品質は常に高い。

すべてのフェーズが完了したら、/thrunt:complete-milestone でマイルストーンをアーカイブしリリースをタグ付けします。

次に /hunt:new-program で次のバージョンを開始します — new-program と同じフローですが既存のコードベース向けです。次に構築したいものを説明し、システムがドメインを調査し、要件をスコーピングし、新しいロードマップを作成します。各マイルストーンはクリーンなサイクルです：定義 → 構築 → シップ。

クイックモード

/thrunt:quick

フル計画が不要なアドホックタスク向け。

クイックモードはTHRUNTの保証（アトミックコミット、状態トラッキング）をより速いパスで提供します：

• 同じエージェント — プランナー + エグゼキューター、同じ品質
• オプションステップをスキップ — デフォルトではリサーチ、プランチェッカー、ベリファイアなし
• 別トラッキング — .planning/quick/ に保存、フェーズとは別管理

--discuss フラグ： 計画前にグレーゾーンを洗い出す軽量ディスカッション。

--research フラグ： 計画前にフォーカスされたリサーチャーを起動。実装アプローチ、ライブラリの選択肢、落とし穴を調査します。タスクへのアプローチが不明な場合に使用してください。

--full フラグ： プランチェック（最大2回のイテレーション）と実行後の検証を有効にします。

フラグは組み合わせ可能：--discuss --research --full でディスカッション + リサーチ + プランチェック + 検証が行われます。

/thrunt:quick
> What do you want to do? "Add dark mode toggle to settings"

作成されるファイル： .planning/quick/001-add-dark-mode-toggle/PLAN.md、SUMMARY.md

なぜ効果的なのか

コンテキストエンジニアリング

Claude Codeは必要なコンテキストを与えれば非常に強力です。ほとんどの人はそれをしていません。

THRUNTがそれを代わりに処理します：

サイズ制限はClaudeの品質が劣化するポイントに基づいています。制限内に収まれば、一貫した高品質が得られます。

XMLプロンプトフォーマッティング

すべてのプランはClaude向けに最適化された構造化XMLです：

<task type="auto">
  <name>Create login endpoint</name>
  <files>src/app/api/auth/login/route.ts</files>
  <action>
    <!-- CommonJSの問題があるため、jsonwebtokenではなくjoseをJWTに使用。 -->
    <!-- usersテーブルに対して認証情報を検証。 -->
    <!-- 成功時にhttpOnly cookieを返す。 -->
    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>

正確な指示。推測なし。検証が組み込み済み。

マルチエージェントオーケストレーション

すべてのステージで同じパターンを使用します：薄いオーケストレーターが専門エージェントを起動し、結果を収集し、次のステップにルーティングします。

オーケストレーターは重い処理を行いません。エージェントを起動し、待機し、結果を統合します。

結果： フェーズ全体を実行できます — 深いリサーチ、複数のプランの作成と検証、並列エグゼキューターによる数千行のコード記述、目標に対する自動検証 — そしてメインのコンテキストウィンドウは30〜40%に留まります。処理はフレッシュなサブエージェントコンテキストで行われます。セッションは高速でレスポンシブなままです。

アトミックGitコミット

各タスクは完了直後に独自のコミットを取得します：

abc123f docs(08-02): complete user registration plan
def456g feat(08-02): add email confirmation flow
hij789k feat(08-02): implement password hashing
lmn012o feat(08-02): create registration endpoint

[!NOTE] メリット： git bisectで問題のある正確なタスクを特定可能。各タスクを個別にリバート可能。将来のセッションでClaudeに明確な履歴を提供。AI自動化ワークフローにおけるオブザーバビリティの向上。

すべてのコミットは的確で、追跡可能で、意味があります。

モジュラー設計

• 現在のマイルストーンにフェーズを追加
• フェーズ間に緊急作業を挿入
• マイルストーンを完了して新しく開始
• すべてを再構築せずにプランを調整

ロックインされることはありません。システムが適応します。

コマンド

コアワークフロー

ワークストリーム

マルチプロジェクトワークスペース

UIデザイン

ナビゲーション

ブラウンフィールド

フェーズ管理

セッション

ワークストリーム

コード品質

バックログ & スレッド

ユーティリティ

^{¹ Redditユーザー OracleGreyBeard による貢献}

設定

THRUNTはプロジェクト設定を .planning/config.json に保存します。/hunt:new-program 実行時に設定するか、後から /thrunt:settings で更新できます。完全な設定スキーマ、ワークフロートグル、gitブランチオプション、エージェントごとのモデル内訳については、ユーザーガイドをご覧ください。

コア設定

モデルプロファイル

各エージェントが使用するClaudeモデルを制御します。品質とトークン消費のバランスを取ります。

プロファイルの切り替え：

/thrunt:set-profile budget

非Anthropicプロバイダー（OpenRouter、ローカルモデル）を使用する場合や、現在のランタイムのモデル選択に従う場合（例：OpenCode /model）は inherit を使用してください。

または /thrunt:settings で設定できます。

ワークフローエージェント

プランニング/実行時に追加のエージェントを起動します。品質は向上しますが、トークンと時間が追加されます。

これらのトグルには /thrunt:settings を使用するか、呼び出し時にオーバーライドできます：

• /hunt:plan --skip-research
• /hunt:plan --skip-verify

実行

Gitブランチ

THRUNTが実行中にブランチをどう扱うかを制御します。

戦略：

• none — 現在のブランチにコミット（デフォルトのTHRUNT動作）
• phase — フェーズごとにブランチを作成し、フェーズ完了時にマージ
• milestone — マイルストーン全体で1つのブランチを作成し、完了時にマージ

マイルストーン完了時、THRUNTはスカッシュマージ（推奨）または履歴付きマージを提案します。

セキュリティ

組み込みセキュリティハードニング

THRUNTはv1.27以降、多層防御セキュリティを備えています：

• パストラバーサル防止 — ユーザー提供のすべてのファイルパス（--text-file、--prd）がプロジェクトディレクトリ内に解決されるか検証
• プロンプトインジェクション検出 — 集中型 security.cjs モジュールが計画成果物に入る前にユーザー提供テキストのインジェクションパターンをスキャン
• PreToolUseプロンプトガードフック — thrunt-prompt-guard が .planning/ への書き込みに埋め込まれたインジェクションベクトルをスキャン（アドバイザリー、ブロッキングではない）
• 安全なJSON解析 — 不正な --fields 引数が状態を破損する前にキャッチ
• シェル引数バリデーション — シェル補間前にユーザーテキストをサニタイズ
• CI対応インジェクションスキャナー — prompt-injection-scan.test.cjs が全エージェント/ワークフロー/コマンドファイルの埋め込みインジェクションベクトルをスキャン

[!NOTE] THRUNTはLLMシステムプロンプトとなるマークダウンファイルを生成するため、計画成果物に流入するユーザー制御テキストは潜在的な間接プロンプトインジェクションベクトルとなります。これらの保護は、そのようなベクトルを複数のレイヤーで捕捉するように設計されています。

機密ファイルの保護

THRUNTのコードベースマッピングおよび分析コマンドは、プロジェクトを理解するためにファイルを読み取ります。シークレットを含むファイルを保護するには、Claude Codeの拒否リストに追加してください：

1. Claude Code設定（.claude/settings.json またはグローバル）を開きます
2. 機密ファイルパターンを拒否リストに追加します：

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

これにより、どのコマンドを実行しても、Claudeがこれらのファイルを完全に読み取ることを防ぎます。

[!IMPORTANT] THRUNTにはシークレットのコミットに対する組み込み保護がありますが、多層防御がベストプラクティスです。防御の第一線として、機密ファイルへの読み取りアクセスを拒否してください。

トラブルシューティング

インストール後にコマンドが見つからない？

• ランタイムを再起動してコマンド/スキルを再読み込みしてください
• ~/.claude/commands/thrunt/（グローバル）または ./.claude/commands/thrunt/（ローカル）にファイルが存在するか確認してください
• Codexの場合、~/.codex/skills/thrunt-*/SKILL.md（グローバル）または ./.codex/skills/thrunt-*/SKILL.md（ローカル）にスキルが存在するか確認してください

コマンドが期待通りに動作しない？

• /thrunt:help を実行してインストールを確認してください
• npx thrunt-god を再実行して再インストールしてください

最新バージョンへのアップデート？

npx thrunt-god@latest

Dockerまたはコンテナ化環境を使用している？

チルダパス（~/.claude/...）でファイル読み取りが失敗する場合、インストール前に CLAUDE_CONFIG_DIR を設定してください：

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

これにより、コンテナ内で正しく展開されない可能性がある ~ の代わりに絶対パスが使用されます。

アンインストール

THRUNTを完全に削除するには：

# グローバルインストール
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

# ローカルインストール（現在のプロジェクト）
npx thrunt-god --claude --local --uninstall
npx thrunt-god --opencode --local --uninstall
npx thrunt-god --codex --local --uninstall
npx thrunt-god --copilot --local --uninstall
npx thrunt-god --cursor --local --uninstall
npx thrunt-god --antigravity --local --uninstall

これにより、他の設定を保持しながら、すべてのTHRUNTコマンド、エージェント、フック、設定が削除されます。

コミュニティポート

OpenCode、Gemini CLI、Codexは npx thrunt-god でネイティブサポートされています。

以下のコミュニティポートがマルチランタイムサポートの先駆けとなりました：

スター履歴

ライセンス

MITライセンス。詳細は LICENSE をご覧ください。