implement-afk-agentic

AFK エージェント型の実装

キーボードの前に誰もいない状態で、チケットを1件実装します。チケットはこの実行に対する人間からの入力です。チケットで決まっている内容を実行し、未解決の内容があれば停止します。

新しいリポジトリでこのワークフローを設定する場合や、そのライフサイクルを変更する場合は、references/afk-implementation.md を読んでください。

前提条件

コードを書く前に、イシュートラッカー、トリアージ用ラベル、ドメインドキュメント、リポジトリの指示を確認してください。次の条件を満たしていることを確認します。

• チケットに設定済みの ready-for-agent ラベルが付いていること。
• チケットの テスト対象の境界 セクションが記入されていること。
• 受け入れ基準がテスト可能で、曖昧でないこと。
• リポジトリに PR のターゲット／統合ブランチが明記されているか、リモートのデフォルトブランチを曖昧さなく特定できること。
• コメントとラベル変更に必要なイシュートラッカーの操作が利用できること。

前提条件を満たせない場合は、停止ルールを適用します。境界が明記されていないチケットは、AFK 実行の準備ができていません。

ブランチ

次の順序で <base-branch> を特定します。

1. AGENTS.md、CLAUDE.md、または docs/agents/ に明記されたターゲットブランチまたは統合ブランチ。
2. ローカルの origin/HEAD シンボリック参照。
3. リモートリポジトリのデフォルトブランチ。

明示されたリポジトリのワークフローは、リモートのデフォルトより優先されます。指示が矛盾する場合は、停止ルールを適用します。

次に、以下を実行します。

1. origin から最新の <base-branch> をフェッチします。
2. イシューのタイトルから <simple-title> を作成します。小文字にし、英数字以外が連続する部分をそれぞれ - に置き換え、先頭と末尾のハイフンを削除します。
3. # を付けずに数値のイシューナンバーを使い、origin/<base-branch> から issue/<issue-number>-<simple-title> を作成して切り替えます。

ブランチ名が完全に一致し、初期 HEAD が origin/<base-branch> と一致している場合に限り、ビルドを開始します。操作上の失敗が起きた場合は、チケットのラベルを変更せずに実行を停止します。

ビルド

/tdd を実行し、レッド・グリーンの垂直スライスを一度に1つずつ進めます。チケットの テスト対象の境界 セクションが境界についての合意です。再確認を求めず、その境界だけをテストしてください。

作業中は、対象を絞ったテストと型チェックを実行します。最後に、関連するテストスイート全体を一度実行します。

停止ルール

チケット、仕様、ドメインドキュメント、ADR、リポジトリの指示のいずれにも答えがない判断が発生した時点で、次の手順を実行します。

1. 曖昧な点と判明した選択肢を正確にチケットへコメントします。
2. 設定済みの ready-for-agent ラベルを削除します。
3. 事実が不足している場合は設定済みの needs-info ラベルを、人間の判断が必要な場合は ready-for-human ラベルを追加します。
4. PR を作成せずに停止します。

正確に停止できれば実行は成功です。作業を続けるために境界や設計上の選択を勝手に決めると、実行は失敗です。

レビュー

origin/<base-branch> を固定点として /code-review を実行します。指摘を次のように分類します。

• 機械的な修正。 明確な修正方法が1つで、トレードオフがありません。修正し、影響するチェックを再実行します。
• 判断が必要なもの。 トレードオフ、スタイル上の判断、または議論の余地があるものです。コードは変更せず、各項目を PR 本文の ## Reviewer: look here に記録します。

提出

変更をコミットしてから、<base-branch> を対象に /open-pr-agentic を実行します。PR は作成しますが、決してマージしないでください。

作業完了の条件は、テストスイート全体が成功し、設定されたブランチを対象に PR が作成され、設定されている場合はリンクされたイシューが人間による検証待ちの状態になっており、判断が必要な指摘がすべて PR 本文で目立つように記載されていることです。