HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Boffin – AIコーディングエージェントのためのスタッフエンジニアレイヤー

Show HN: Boffin – Staff-engineer layer for AI coding agents (github.com)

13 pointsby mic_sm3 コメント

要約

Boffinは、AIコーディングエージェントが編集ごとにアーキテクチャ上の制約を遵守できるように、スタッフエンジニアレベルの機能を提供するレイヤーです。これにより、AIによるコード生成の品質と一貫性が向上することが期待されます。

全文翻訳

Boffin (npm: boffinit) は、AIコーディングエージェントのためのスタッフエンジニア制御レイヤーです。編集中の正確なファイルに対するアーキテクチャ上の制約をエージェントに与え、結果を検証させます -- DuckDBケーススタディ: ガイド付きリファクタリングが +17 / -17 行で完了し、2,104件のアサーションがパスしました。

15行の修正を依頼したのに、エージェントが500行の大規模な改修をしてくることがあります。Boffinは、エージェントが触ろうとしているファイルに適用されるアーキテクチャ上の制約を与え、その結果を検証させます。

これは別の AGENTS.md やプロンプトパックではありません。これらのフォーマットは通常、リポジトリ全体に対して1つの静的な指示ブロックを配布しますが、Boffinは現在の編集に関連する制約のみをルーティングします。ParselFire Core によって駆動されています。

npx boffinit cursor

[画像: Boffin, a staff-engineer control layer for AI coding agents, reviewing an AI-generated diff before a load-bearing wall is removed]

Boffinではないもの

  • 静的なリポジトリ全体ルールのファイル(AGENTS.md スタイルの、すべてに適用される1つのブロック)ではありません
  • プロンプトパックやシステムプロンプトのトリックではありません
  • リンターやCIゲートではありません -- 編集の前後に作用します
  • スピードツールではありません -- フレームワークはレビューの安全性です

Boffinができること

  • エージェントの前にある編集に関連する制約を選択します
  • 変更の大きさに比例した検証を要求します
  • 1つのnpmパッケージからCursor、Claude Code、Codex、OpenCode向けに提供されます
  • ParselFire Coreによって駆動される、署名済みのポータブルパックを提供します

違い(正直な比較)

静的ルールファイル (AGENTS.md)Boffin
配布通常、リポジトリ全体に1つの静的ブロック現在の編集にルーティングされる制約
検証フォーマットでは不要要求される、変更に比例する
証拠通常なし数値付きの記録されたケーススタディ

約束ではなく、証拠

公開されているケーススタディは、実際のオープンソースコードに対するこれらのガイド付きリファクタリングを記録しています:

  • DuckDB: +17 / -17; 8つのテストファイルにわたる2,104件のアサーションがパスしました。個別の継続パスと回復パスが維持されました。
  • FastAPI: +16 / -33; 49件のテストがパスしました。公開APIの変更はありませんでした。
  • LangChain: 同期/非同期の境界が維持されました。4件のテストがパスしました。

これらは再現可能なケーススタディであり、制御されたA/Bベンチマークではありません。

インストール

BoffinはNode.js 18以降が必要です。

Cursor

プロジェクトから実行します:

npx boffinit cursor
Claude Code

Claude Code内で以下を実行します:

/plugin marketplace add MicSm/boffin
/plugin install boffin@boffin
Codex

ターミナルから以下を実行します:

codex plugin marketplace add MicSm/boffin
codex plugin add boffin@boffin

Codexはプラグインフックを自動的に信頼しません。Boffinのフックを確認して信頼するまで、/hooks を1度実行してください。それまではプラグインのスキルは機能しますが、セッションごとの自動アクティベーションはオフのままです。

OpenCode

プロジェクトから実行します:

npx boffinit opencode

その後、OpenCodeでプロジェクトを開きます。常時オンのガイダンスは opencode.json -> .boffin/AGENTS.md 経由で提供されます。オンデマンドでは、/boffin、/boffin-review、または boffin / boffin-review スキルを使用します。

インストール詳細、コマンド、トラブルシューティング: OpenCode配信。

仕組みを知りたいですか? ParselFire Coreの仕組み を読んでください。

Boffinがこだわる点

類似したコードが常に同じコードであるとは限りません。Boffinは、エージェントが実際の特殊ケースをマージしたり、同期/非同期の境界を曖昧にしたり、状態をその所有者から移動させたり、焦点を絞ったタスクをコードベースのツアーに変えたりする前に、停止する理由を与えます。

  • 焦点を絞った変更の場合、要求されたスコープを小さく保ち、編集を証明する最も狭いチェックを要求します。
  • オープンエンドなリファクタリングやレビューの場合、まず読み取り専用の監査を要求し、その後、検証された1つの発見を1つずつ進めます。
  • クリーンアップが以前の正しさのルールと競合する場合、正しさが優先されます。

目的はエージェントを臆病にすることではありません。それは、高価な詳細が興味深い午後の問題になる前に、それらを明示することです。

FAQ

BoffinはAGENTS.mdとどう違うのですか?

AGENTS.md は通常、リポジトリ全体に対する1つの静的な指示ファイルです。Boffinは、エージェントが編集しようとしているファイルに関連するアーキテクチャ上の制約のみをルーティングし、変更に比例したチェックを要求します。

制約はどこから来るのですか?

すべてのルールは、このリポジトリの packs/ の下に読み取り可能でバージョン管理されたMarkdownとして提供され、パックはGPG署名されています。インストール時に隠されているものはありません。信頼する前にパックを開いてすべてのルールを読むことができます。編集時にBoffinは、それらのルールのどれが触られているファイルに適用されるかを選択します。ルーティングマップについては、ParselFire Coreの仕組み を参照してください。

なぜ私のコーディングエージェントは小さな修正を巨大な書き直しに変えるのですか?

小さな修正を依頼したのに、エージェントが改修をして戻ってきます。Boffinは、編集前に現在のファイルに対する負荷のかかる制約を注入し、その後検証を強制します。

lite、full、max は何を変えますか?

これらはクリーンアップの野心を調整しますが、正しさは調整しません:

  • lite はクリーンアップの圧力を低く保ち、最小限の有用な変更を優先します。
  • full はバランスの取れたデフォルトです。
  • max は、タスクが正当化する場合に最も強いクリーンアップ圧力を適用します。

プラグインホストでは、/boffin lite、/boffin full、または /boffin max でプロファイルを選択します。off プロファイルはありません。

プロファイルは安全性の下限を変更しますか?

いいえ。すべてのプロファイルは、信頼境界の検証、データ損失防止、セキュリティ、アクセシビリティ要件を含む、同じ早期の正しさステージと拒否ルールを維持します。

生成されたコードの boffin: コメントとは何ですか?

boffin: マークは機械可読の監査トークンです。これにより、コードベース全体でどの不変条件が保持され、どれが拒否されたかをgrep/収集できます。何もどこかに送信されることはありません。ペイロード自体が不変条件です。リポジトリのルートに空の .boffin-trace-off ファイルを作成することで、1行で無効にできます。

Boffinはコマンドサンドボックスまたはセキュリティツールですか?

いいえ。Boffinはプロセスを分離したり、シェルコマンドをフィルタリングしたり、ファイルシステムやネットワークアクセスを制限したりしません。生成されたコードにおけるアーキテクチャ上の決定をガイドします。コマンドサンドボックスやセキュリティコントロールはそれぞれのジョブに使用してください。Boffinは異なるジョブを持っています。

CursorまたはOpenCode統合をアンインストールするにはどうすればよいですか?
npx boffinit cursor uninstall
npx boffinit opencode uninstall

各アンインストーラーは、そのホストの管理ファイルのみを削除します。他のホストがまだインストールされている場合、共有された .boffin/packs および .boffin/VERSION は残ります。無関係なプロジェクトファイルはそのままにされます。

Boffinはテストやコードレビューを置き換えますか?

いいえ。注意すべき契約をエージェントに伝え、外部チェックを要求しますが、リポジトリのテストとレビュープロセスは依然として権威があります。

その他のホスト

ポータブルアダプターは、AGENTS.md、CLAUDE.md、ワークスペースルール、またはリポジトリの指示を読み取るホストをカバーします。技術マップについては、ホスト配信とアダプター を参照してください。

プロジェクト

BoffinはMITライセンスの下で利用可能です。クレジットについてはcreditsを参照してください。

npx boffinit cursor