エージェントのセットアップ

AI コーディングエージェントを bd CLI に接続し、bead の作成・更新・クローズができるようにします。Beadbox がエージェントの作業をリアルタイムで表示します。

前提条件

エージェントをセットアップする前に、以下が必要です:

  • bd CLI がインストール済みで PATH に追加されていること (はじめに)
  • 少なくとも1つの初期化済みワークスペース (プロジェクトディレクトリで bd init)
  • Beadbox が起動中で、そのワークスペースに接続済みであること

エージェントのアイデンティティ

各エージェントには、以下を定義する CLAUDE.md ファイル (または同等のシステムプロンプト) が必要です:

  • エージェントが担当する範囲 (実装、QA、運用)
  • エージェントが担当しない範囲 (他の役割への逸脱を防止)
  • コミュニケーション方法 (bead にコメント、コーディネーターに報告)

エンジニアリングエージェントの最小限のアイデンティティ定義の例:

## Identity
Engineer for MyProject. You implement features, fix bugs,
and write tests. You own implementation quality.

## Boundary with QA
QA validates your work independently. You provide QA with
executable verification steps. If your DONE comment doesn't
let QA verify without reading source code, it's incomplete.

境界セクションにより、エージェントが QA の仕事をするのを防ぎます。明示的な境界がないと、エージェントは自己検証を行い、独立したレビューを省略します。

基本コマンド

エージェントが最もよく使う bd コマンドは以下の通りです:

bead を作成

bd create --title="Fix login bug" --type=bug --priority=2

bead を表示

bd show BEAD-ID

ステータスの更新と作業の取得

bd update BEAD-ID --claim --actor agent-name
bd update BEAD-ID --status in_progress

計画や完了報告を投稿

bd comments add BEAD-ID --author agent-name "PLAN: ..."
bd comments add BEAD-ID --author agent-name "DONE: ..."

bead を一覧表示

bd list --status=open --assignee=agent-name

完了した bead をクローズ

bd close BEAD-ID

すべてのコマンドは --db フラグで特定のワークスペースデータベースを指定できます。エージェントが複数プロジェクトにまたがって作業する場合に便利です。

bd prime コマンド

新しいエージェントに bd CLI を最速で教える方法:

bd prime

このコマンドは AI コーディングアシスタント向けのコンテキストブロックを出力します。コマンドセット、出力形式、一般的なワークフローをカバーしています。エージェントのシステムプロンプトまたはコンテキストウィンドウに貼り付けてください。

ワークスペースディレクトリ内から bd prime を実行すると、ワークスペース固有のコンテキストが含まれます。

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

1つの bead に対する典型的なエージェントワークフロー:

  1. bead を取得
  2. コーディング前に計画をコメント
  3. 変更を実装
  4. テストを実行
  5. 検証手順を含む完了コメントを投稿
  6. プッシュしてステータスを ready_for_qa に更新
# Full workflow example
bd update proj-a1b2 --claim --actor eng1
bd comments add proj-a1b2 --author eng1 "PLAN: 1. Fix auth check 2. Add test"

# ... implement and test ...

bd comments add proj-a1b2 --author eng1 "DONE: Fixed auth. Commit: abc123"
git push
bd update proj-a1b2 --status ready_for_qa

DONE コメントには、ソースコードを読まなくても他のエージェント (または人間) が作業を確認できる検証手順を含めるべきです。

リアルタイムフィードバック

エージェントが bd コマンドを実行すると、Beadbox がデータベースの変更を検知し、2秒以内に UI を更新します。手動リフレッシュは不要です。

つまり、エージェントの作業をリアルタイムで監視できます。bead が open から in_progress に移行する様子を見たり、計画がコメントとして表示されたり、ブロッカーが浮上する瞬間を捉えたりできます。

マルチエージェント構成では、アクティビティダッシュボードがどのエージェントが何に取り組んでいるか、パイプラインのどこに作業が溜まっているか、フリート全体で直近に何が起きたかを表示します。