sipyourdrink-ltd/bernstein

Bernstein – AIエージェントのためのガバナンスレイヤー

概要 – Bernsteinは、AIコーディングエージェント（Claude Code、Gemini CLI、OpenAI Agents SDKなど）とそれらが操作するコードベースの間に位置するオープンソースフレームワークです。シンプルなYAMLファイルでポリシー・アズ・コードのワークフローを記述し、隔離されたワークツリー内でエージェントを実行して各ステップを記録し、オフラインで検証可能な暗号署名付きレシートを生成します。要するに、LLMを調整ループに組み込むことなく、AIエージェントの決定論的かつ監査可能なオーケストレーションを実現します。

主な概念

• 決定論的スケジューラー – プランナーはLLMではなく純粋なPythonであるため、同じYAMLプランは常に同じタスクグラフを生成します。
• 事後検証 – ジャーナルがすべてのアクションを記録し、オプションのHMACチェーン監査ログが署名付きレシートを追加します。不一致があれば、どのステップで乖離が発生したかを正確に特定できます。
• デフォルトでの隔離 – 各コーディングタスクは独自のGitワークツリー（または非コード成果物のためのサンドボックスディレクトリ）で実行されます。共有状態はアトミックなタスクバックログに限定されます。
• 幅広いエージェントサポート – 一般的なCLIエージェント向けの50以上の組み込みアダプターに加え、汎用的な --prompt ラッパーを備えており、すべてSaaSを経由せずにローカルで実行可能です。

典型的なワークフロー

1. フェーズ、ロール、依存関係、オプションの条件を定義する bernstein.yaml（または類似ファイル）を作成します。
2. bernstein -g "<goal>" または bernstein workflow run <plan>.yaml を実行します。
3. スケジューラーが適切なエージェントを生成し、それぞれが隔離されたワークスペースで作業します。
4. ノードが完了すると、Bernsteinは宣言された成果物コントラクト（テストの通過、ファイルの存在など）をチェックし、署名付きの系統レシートを記録します。
5. 実行後、bernstein replay latest --verify や bernstein verify receipt … などのコマンドを使用して、実行全体をリプレイ、検証、または監査できます。

重要性

• コンプライアンスと監査可能性 – 組織は、AIが生成した変更が事前に承認されたポリシーに従ってレビュー、テスト、マージされたことを証明できます。
• 再現性 – コーディネーターが決定論的であるため、以前の実行をリプレイして全く同じタスクグラフを得ることができ、デバッグや規制レビューに役立ちます。
• 安全性 – 隔離によりエージェント同士がファイルを干渉することを防ぎ、サンドボックスバックエンドでネットワークやリソースの制限を強制できます。

はじめに

uv tool install bernstein   # or pipx install bernstein
bernstein init               # creates .sdd/ workspace and template files
bernstein doctor            # checks that your chosen CLI agents are installed
bernstein -g "fix the failing test in tests/test_foo.py"

インストールはpip、pipx、Homebrew、Docker、またはオフラインのwheelhouse経由で行えます。

ユーザーインターフェース

• bernstein live – エージェント、ログ、タスクボードを表示するターミナルUI。
• bernstein gui serve – タスクリストと差分プレビューを備えたWebダッシュボード。
• リプレイ、系統検証、ベンチマーク、ローカリゼーションチェックのためのCLIコマンド。

ライセンスとステータス – Apache-2.0、ベータ段階、個人メンテナンス、マイナーリリースの頻繁な更新。プロジェクトは積極的にCIテストされ、CodeQLスキャンを備え、GHCR経由でDockerイメージを提供しています。

---

詳細については、公式ドキュメントを参照してください: https://docs.bernstein.run/