AI Deck

Boffin ─ AIコーディングエージェントの小さな修正を大改造にしない、編集ファイル単位で設計制約を差し込む制御レイヤー

「15行の修正をお願いしたら、500行の大改装が返ってきた」─AIコーディングエージェントを使っていると、誰もが一度は経験する現象である。Boffinは、この振る舞いを抑えるためのオープンソースの制御レイヤー。エージェントがこれから触るファイルに関係する設計上の制約だけを選んで差し込み、変更の大きさに見合った検証を義務付ける。Claude Code・Cursor・Codex・OpenCodeに対応し、npmパッケージ(boffinit)1本から導入できる。2026年7月に公開され、8月にバージョン1.0系へ到達した。ライセンスはMIT。

主な特徴

  • 編集中のファイルに合わせてルールを選ぶ: リポジトリ全体に効く1枚の指示文をいつも読ませるのではなく、いま編集しようとしているファイルの言語・役割に応じて、必要な制約だけをエージェントの注意に載せる。開発元はこの仕組みを「LLMのアテンション・ルーター」と説明している
  • ParselFire Coreというルーティングエンジン: 制約は「universal(言語非依存)」「Python向け」「C++向け」といった小さなパック群に分割され、索引ファイルが「どの状況でどのルールを読むか」を定義する。スコープ確認 → 契約・不変条件 → 状態 → 所有権とライフサイクル → 共有抽象 → 境界 → 収束と削除、という7段階の順序で評価され、後段の「きれいにする」作業が前段の正しさを崩すことは許されない
  • 変更の大きさに応じた検証を要求: 小さな修正なら、それを証明する最小限のテストやlintだけを走らせる。一方で「リファクタして」のような広い依頼には、まず読み取り専用の監査パスを課し、見つかった指摘を1件ずつ潰させる。小さな修正が全ファイル掃除に化けるのも、広いレビューが最初の1箇所で止まるのも防ぐ設計になっている
  • ルールが読めるMarkdownとして公開されている: すべての制約はリポジトリ内にバージョン管理されたMarkdownとして置かれ、GPG署名されている。導入前に中身を全部読める点は、ブラックボックスのプロンプト集との大きな違いである
  • 主要エージェントに1コマンドで導入: Cursorはnpx boffinit cursor、Claude CodeとCodexはプラグインマーケットプレイス経由、OpenCodeはnpx boffinit opencodeAGENTS.mdやワークスペースルールを読む他のホストにも、ポータブルなアダプタが用意されている
  • lite / full / max の3プロファイル: 「掃除の意欲」だけを調整するもので、正しさの下限(信頼境界の検証、データ損失の防止、セキュリティ、アクセシビリティ)はどのプロファイルでも変わらない

料金

プラン料金主な特徴
オープンソース(MIT)$0全機能を利用可能。npm(boffinit)から導入。有料プランの提供なし

料金は2026年8月時点の情報です。最新の情報は公式リポジトリをご確認ください。

メリット・デメリット

メリット

  • 依頼した範囲を超えた「ついで改修」が減り、差分レビューの負担が軽くなる
  • 適用されるルールが署名済みのMarkdownとして全部読めるため、監査しやすい
  • Claude Code・Cursor・Codex・OpenCodeを1つのパッケージでカバーでき、チーム内でエージェントが分かれていても運用を揃えやすい
  • DuckDB・FastAPI・LangChainといった実在のOSSに適用した事例が、差分行数とテスト件数付きで公開されている
  • MITライセンスの無料ツールで、導入・撤去ともコマンド1本

⚠️ デメリット

  • 制約の適用と検証の要求が増えるぶん、1回のやり取りは重くなる。開発元自身も「速度のためのツールではない」と明言している
  • 言語別パックはPythonとC++が中心で、それ以外の言語は言語非依存のuniversalパックでの対応になる
  • コマンドサンドボックスやセキュリティツールではない。プロセス分離・シェルコマンドの制限・ファイルシステムやネットワークの遮断は行わない
  • テストやコードレビューを置き換えるものではなく、あくまで既存の検証プロセスの手前に立つ層である
  • 公開から日が浅く(2026年7月公開)、事例は再現可能なケーススタディであって統制されたA/Bベンチマークではない
  • Codexではプラグインのフックが自動で信頼されないため、/hooksで一度承認する手順が要る

類似サービスとの比較

比較項目BoffinAGENTS.md / CLAUDE.mdCursor RulesAIコードレビュー系(CodeRabbit等)
主な役割編集前の制約差し込みと編集後の検証要求エージェントへの静的な指示書エディタ単位のルール定義PR提出後のレビューコメント
適用タイミング編集の前後常時(セッション全体)常時またはパターン一致時変更が出来上がった後
ルールの選択編集対象のファイルに応じて動的に選ぶ基本的に全体を毎回読ませるglob等の条件で切り替え該当なし
検証の要求変更の大きさに比例して必須化形式としては要求しない形式としては要求しないレビュー指摘という形で事後
対応ホストClaude Code / Cursor / Codex / OpenCode対応ホストは広いCursor中心GitHub等のホスティング側
料金無料(MIT)無料(自分で書く)Cursorの料金に含まれる無料枠+有料プラン

こんな人におすすめ

  • AIエージェントに小さな修正を頼んだのに、毎回巨大な差分が返ってきて困っている開発者
  • 既存の大規模コードベースにAIエージェントを入れたいが、設計上の約束事を壊されるのが怖いチーム
  • AGENTS.mdCLAUDE.mdを書いてはみたものの、ルールが増えるほど守られなくなる感覚がある人
  • Claude CodeとCursorなど複数のエージェントが混在していて、運用ルールを1本化したいチーム
  • 適用されるルールの中身を自分で読んで確認してから導入したい、監査志向の開発者

まとめ

Boffinは、AIコーディングエージェントの「やりすぎ」を、プロンプトの気合いではなく仕組みで抑えにいくツールである。編集対象のファイルに関係する制約だけを選んで渡し、変更の大きさに見合った検証を求めるという方針は、指示文が長くなるほど守られにくくなるという実感に対する素直な答えになっている。速度を上げるツールではなく、差分を安全に保つためのツールなので、レビュー負担の大きい既存コードベースほど効果が出やすい。無料のオープンソースでコマンド1本から試せるため、まずは手元のプロジェクトで小さな修正を1件頼んでみて、返ってくる差分の大きさを比べてみるとよい。

関連リンク

← ブログ