backlog-md

エージェント向け Backlog.md タスク追跡

Backlog.md CLI を使用した、エージェントのワークフローに最適化されたタスク追跡システムです。

主な3つのユースケース

1. 実装者：機能開発中に課題を後回しにする

実装中に見つかった P2～P4 の課題を登録します。後回しにするレビュー指摘には remediation ラベルを使用します。

• 計画付きで作成：登録時点で実装の背景を把握しています
• 優先度を設定：優先度ガイドを参照してください
• 種別ラベルを追加（必須）＋ アプリラベル（任意）

2. レビュアー：監査で見つかった指摘

セキュリティレビューや監査で見つかった指摘から、構造化された課題を作成します。必要に応じて依存関係をリンクし、マイルストーンを割り当てます。

• 計画付きで作成：監査の背景に基づいて作成します
• 必要に応じて依存関係をリンク
• 優先度を設定：確信が持てない場合はユーザーに確認します（priority-review ラベル）
• マイルストーンを設定

3. ワーカー：割り当てられたタスクを実行

タスクをすべて読み、すべてのフィールドを把握したうえで、受け入れ基準と完了の定義に従います。

• タスクを引き受ける：backlog task edit 42 -s "In Progress" -a @myself
• すべてを読む：すべてのフィールド、添付ファイル／URL、リンクされたドキュメント
• 順序立てて完了する：AC → 実装メモ → 最終サマリー → DoD → 完了

絶対ルール

1. 書き込みには CLI のみを使用します。backlog task edit と backlog task create のみを使用してください。ファイルを直接編集しないでください。
2. 読み取り時は必ず --plain フラグを使用します：backlog task 42 --plain、backlog task list --plain
3. 種別ラベルは必須（bug|feature|documentation|refactor|remediation）。値は1つのみです
4. アプリラベルは任意で、複数指定できます：synapse-pingora、signal-horizon-ui、signal-horizon-api など
5. エージェントに役立つカスタムラベルを使用できます（priority-review、performance、security など）

実装計画：必要な場合

シナリオ	計画を含める？	理由
後回しにするレビュー指摘	✅ YES	監査／レビューの背景をすでに把握しています
発見した課題の報告	❌ NO	実装者が作業時に計画を立てます
作業計画を明示的に依頼された場合	✅ YES（詳細）	指示により必須です
通常のタスク作業	引き受けた後、コーディング前	作成時には追加せず、作業開始後に追加します

明示的な指示がない限り、既存の計画を更新しないでください。

優先度システム（詳細は references/priority-labels.md を参照）

• P0：重大な問題、大規模な障害
• P1：ユーザーに影響する実際のバグ
• P2：バグ、エッジケース
• P3：あると便利な改善、実現したい機能
• P4：バックログ、将来のアイデア

P0～P1 か判断できない場合は、priority-review ラベルを付けてユーザーに判断を委ねます。

タスク完了チェックリスト

1. ステータス：「In Progress」に設定し、自分を割り当てる
2. 読む：すべてのフィールド、添付ドキュメント
3. 計画：実装計画を追加する（レビューから後回しにした課題でない場合）
4. 作業：コードを実装し、各 AC の完了に合わせてチェックする
5. メモ：作業を進めながら進捗メモを追記する
6. サマリー：最終サマリーを追加する（PR 形式）
7. DoD：完了の定義にある項目をすべて確認する
8. 完了：ステータスを「Done」に設定する

必須コマンド

# Create issue (required: title, type label, priority)
backlog task create "Title" -d "Description" -l bug -p 2 --ac "AC 1"

# Work a task
backlog task edit 42 -s "In Progress" -a @myself
backlog task 42 --plain              # Read everything
backlog task edit 42 --check-ac 1    # Mark AC complete
backlog task edit 42 --append-notes "Progress here"
backlog task edit 42 --final-summary "PR description"
backlog task edit 42 -s Done

# Search and filter
backlog task list -s "To Do" --plain
backlog search "topic" --plain

コマンドの完全なリファレンスについては、references/cli-reference.md を参照してください。 優先度とラベル付けのガイドラインについては、references/priority-labels.md を参照してください。 課題作成パターンの詳細については、references/issue-creation-guide.md を参照してください。