beads-workflow

Beads ワークフロー

Beads は、エージェントのワークフロー向けに設計された AI ネイティブなイシュートラッカーです。イシューはリポジトリ内に置かれ、git 経由で同期されるため、Web UI は不要です。

基本コマンド

コマンド	説明
bd create "Title" -t feature -p 2	イシューを作成します（タイプ、優先度）
bd list --status open	オープン中のイシューを一覧表示します
bd show <id>	イシューの詳細を表示します
bd update <id> --status in_progress	ステータスまたは担当者を更新します
bd close <id> --reason "..."	理由を指定してクローズします
bd ready --sort hybrid	ブロックされていないイシューを探します
bd dep add <blocking> <blocked> --type blocks	依存関係を追加します
bd dep tree <id>	依存関係ツリーを表示します
bd dep rm <blocking> <blocked>	依存関係を削除します
bd sync	git のリモートと同期します
bd flush	JSONL に強制的にフラッシュします

ワークフローパターン

セッションの開始

1. 対応可能な作業を確認する：bd ready --sort hybrid
2. イシューを引き受ける：bd update <id> --status in_progress
3. 依存関係を確認する：bd dep tree <id>
4. 実装を開始する

実装中

1. サブタスクを追跡する：bd create "Sub-task" --parent <id>
2. ブロッカーを追加する：bd dep add <new-blocker> <id> --type blocks
3. 進捗を更新する：bd comment <id> "Progress update"

作業の完了

1. 完了を確認する：すべての受け入れ条件を満たしていること
2. イシューをクローズする：bd close <id> --reason "Implemented X, PR #123"
3. 同期する：bd sync
4. 次の作業を確認する：bd ready

マルチエージェントの連携

# See who's working on what
bd list --status in_progress --json | jq '.[] | {id, title, assignee}'

# Hand off work
bd update <id> --assignee other-agent
bd comment <id> "Handoff: context and next steps"

イシューの種類

種類	使用する場面
feature	新機能
bug	不具合の修正
task	一般的な作業項目
spike	調査・検証
chore	メンテナンス、クリーンアップ

優先度レベル

優先度	意味
0	重大 — ほかの作業をすべて中断
1	高 — 次に対応
2	中 — 通常の流れ
3	低 — 時間があるときに対応
4	バックログ — 将来検討

ステータスの流れ

open -> in_progress -> done
         |-> blocked -> in_progress

ベストプラクティス

1. 論理的な単位ごとにイシューを作成する：無関係な作業をまとめないでください
2. 明確なタイトルを付ける：方法ではなく、何をするかを説明してください
3. 依存関係を使う：対応可能な作業が見えるようになります
4. こまめに同期する：ほかのエージェントに状況を共有してください
5. 速やかにクローズする：古い in_progress イシューを残さないでください

Swarm との連携

1. 編集前に引き受ける：コードに触れる前にステータスを更新してください
2. ブロッカーを記録する：見つかったブロッカーのイシューを作成してください
3. 確実に引き継ぐ：担当者を更新し、コンテキストを追加してください
4. 終了前に同期する：bd sync で状態を共有してください

トラブルシューティング

# Check daemon health
bd daemons health

# View daemon logs
bd daemons logs

# Force reimport from JSONL
bd import --force

# Check for conflicts
bd sync --dry-run