Beads

Beads を共有プロジェクトタスクシステムとして使用してください。ローカルプラン、スクラッチファイル、個人的な記憶は便利ですが、プロジェクト作業の信頼できる情報源ではありません。

最初のステップ

以下を実行します：

bd prime

何も出力されない場合は、リポジトリにアクティブな Beads ワークスペースがあるか確認してください：

bd where

推奨される方法

シェルアクセスが利用できるときは、bd CLI を使用してください。これが最も簡潔で直接的な Beads インターフェースです。

コア CLI ワークフロー

1. 作業を見つけます：

bd ready
bd list --status=open
bd list --status=in_progress

2. 編集前に検査します：

bd show <id>

3. 作業をアトミックに請求します：

bd update <id> --claim

4. 実装が新しいタスクを明らかにする場合、耐久的なフォローアップ作業を作成します：

bd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2

5. 完了した作業をクローズします：

bd close <id> --reason="Completed"

Beads に属するもの

以下のために Beads を使用します：

• 共有プロジェクトタスク
• ブロッカーと依存関係
• 発見されたフォローアップ作業
• スレッドリセット、圧縮、またはハンドオフを経ても存続する必要のある作業
• 別の人またはエージェントが再開できるべきステータス

現在のターンの実行チェックリストにのみエージェントローカルプランニングツールを使用してください。それらを共有プロジェクトステートとして扱わないでください。

ルール

• Beads が利用可能な場合、Markdown TODO ファイルを信頼できる情報源として作成しないでください。
• bd edit を使用しないでください。これはインタラクティブエディターを開きます。代わりに bd update フラグを使用してください。
• bd の出力をプログラムで解析する場合は、--json を優先してください。
• フックがインストールされている場合、bd prime が既に注入されている可能性があります。コンテキストが不足している場合は手動で実行してください。
• 実際の作業が完了していない限り、タスクを自動クローズしたり変更したりしないでください。