sourcebook

AIエージェントが変更し忘れたファイルをキャッチします。

コード変更のための安全レイヤーです。sourcebookはGitの差分を分析して完全性を検証し、変更されるべきだったのに変更されていないファイルをフラグ立てします。ルールベースの構造検出とAIによるセマンティック分析を組み合わせ、クリーンな差分に対しては誤検知ゼロを実現します。

npx sourcebook init          # sets up Claude Code hooks + generates CLAUDE.md
npx sourcebook check         # check your current diff for missing files
npx sourcebook scan-history  # see what you've been missing

キャッチできること

AIエージェントがハンドラーを変更しました。テストは更新しましたか？関連モジュールは？古い値を参照している設定ファイルは？

sourcebookは、リポジトリの実際の構造と差分を照合します：

• 不足しているテストファイル — ソースファイルは変更されたが、テストファイルが変更されていない

• 関連モジュール — 変更したファイルがインポートしている、またはインポートされているファイル

• 共変更の仲間 — Gitコミットにおいて歴史的に一緒に変更されるファイル

• ハブファイルの影響範囲 — 50以上の依存先を持つファイルに触れた場合

--ai オプション使用時：モジュール間のセマンティックな関係、移行が必要なフィールド名の変更、古いバリデーションロジックなどを検出します。

Related MCP server: N3MO

主要な統計

4つのインターフェース

1. CLI

あらゆる差分に対して実行可能です。セットアップは不要です。

npx sourcebook check              # check staged/unstaged changes
npx sourcebook check --ai         # add AI semantic analysis (requires ANTHROPIC_API_KEY)
npx sourcebook check --quiet      # exit code only (for CI/scripts)
npx sourcebook check --branch main  # compare vs a branch

2. Claude Codeフック

1つのコマンドでプリコミットフックを接続できます。エージェントがファイルを編集すると、sourcebookが差分をチェックし、コミットされる前に不足している箇所をエージェントに通知します。

npx sourcebook init   # generates CLAUDE.md + installs hooks

3. MCPサーバー

公式MCPレジストリで公開されています。エージェントはリポジトリ構造、影響範囲、規約、共変更データをオンデマンドでクエリできます。

npx sourcebook serve

MCPクライアントに追加：

{
  "mcpServers": {
    "sourcebook": {
      "command": "npx",
      "args": ["-y", "sourcebook", "serve", "--dir", "/path/to/your/project"]
    }
  }
}

4. GitHub App (近日公開)

すべてのプルリクエストに対して自動的に完全性チェックを行います。ウェイティングリストに参加してください。

コマンド

仕組み

レイヤーA — ルールベース (LLM不使用、1秒未満)

1. 共変更分析 — Git履歴から一緒に変更されるファイルをマイニングします。auth.ts を変更した際、コミットの88%で session.ts も変更されている場合、sourcebookは session.ts をフラグ立てします。

2. テストファイル検出 — 命名規則と共変更履歴を通じて、ソースファイルとテストファイルをマッピングします。

3. インポートグラフ — 依存関係グラフを構築し、変更したファイルをインポート（またはインポートされている）ファイルも更新が必要かどうかをチェックします。

4. ハブ検出 — ファンイン（依存先）が多いファイルを変更した際にフラグ立てします。これらの変更は影響範囲が広いためです。

レイヤーB — AI駆動 (1実行あたり約$0.012)

差分と依存関係のコンテキストをClaude Sonnetに送信します。レイヤーAでは見えないセマンティックな関係（移行が必要なフィールド名の変更、古いスキーマを前提としたバリデーションロジック、インポートリンクのないモジュール間依存関係）をキャッチします。

AIのすべての提案には依存関係の引用が必要です。幻覚（ハルシネーション）によるファイルパスは除外されます。完全性ゲートにより誤検知ゼロを保証します。差分が実際に完全であれば、レイヤーBは何も出力しません。

設定

# Required for --ai flag only
export ANTHROPIC_API_KEY=sk-ant-...

その他の設定は不要です。sourcebookはリポジトリのGit履歴とファイル構造を直接読み取ります。

言語サポート

研究

雰囲気ではなく、実際のベンチマークに基づいています：

• バリデーション結果を確認 — 手法と精度のデータ

• ベンチマーク: 19タスク、10リポジトリ、4言語 — 管理されたエージェントパフォーマンスのテスト

• なぜ自動生成されたコンテキストがエージェントを悪化させるのか — 私たちのアプローチを形作ったETHチューリッヒの発見

ライセンス

BSL-1.1 — ソース公開、無料で使用可能、ホスト型サービスとしての提供は不可。2030年3月25日にMITライセンスへ移行します。詳細は LICENSE を参照してください。

sourcebook.run · GitHub · npm · @maroond_