triage

トリアージ

設定済みのトラッカー上のタスクを、受付担当の小さな状態遷移に沿って移動します。トリアージは、リモートのレコードまたはローカルの受付タスク本文を対象とします。機能のドラフトにある未解決の提案には、担当ロールがありません。

トラッカーが外部プルリクエストを依頼窓口として扱う場合、トリアージの対象にはプルリクエストも含まれます。PRはコードが添付されたタスクであり、以下に記載する違いを除き、同じロールと状態を使用します。#42 のように番号だけが示されている場合は、トラッカーの設定に従ってイシューまたはPRを特定します。

ドキュメントとトラッカーの契約

プロジェクトのドキュメントとそのルールについては、project-documents.md を参照してください。プロジェクトのドキュメントを更新する前に、必ず読んでください。そこに記載されている用語（authorized、obligation、lazy、pointer）は全体を通じて適用されます。関連する要件、仕様、作業状況、バックログがある場合は、それらを確認してください。

トラッカーの設定と、AGENTS.md が参照するトリアージロールを読み込みます。トラッカーの設定が見つからない場合、この実行でタスクがどこにあるかユーザーに尋ねてください（リポジトリのリモートにあるイシュートラッカーをコマンドラインツールまたは接続済みサーバー経由で利用するか、ローカルの受付タスク本文を利用するか）。トリアージの前に、読み取り専用のクエリを1回実行して読み取りアクセスを確認してください。ロールが見つからない場合は、以下の標準文字列を使用してください。レポートには、不足していた設定と、この実行で想定した内容を記載してください。設定として記録してはいけません。

「コメントする」「ロールを適用する」「クローズする」は、トラッカーの設定に従って処理します。

• リモートでの操作には、プラットフォーム固有の実際のコマンドとラベルを使用します。公開済みのリモートタスクへのローカルのタイトル／リンク参照は、リモート側のロール状態を重複させるものではありません。
• ローカルのタスク本文では、先頭付近に Category: と Status: を記載します。コメントは ## Comments の下に追記します。却下する場合は、受付を Status: not-planned としてクローズします。受付状態とは別に、本文にデリバリーの進捗、ブロッカー、受け入れの証拠を記録できます。

リモートへのコメント、ロール変更、クローズには、メンテナーからの明示的なトリアージ依頼または確認済みの結論による承認が必要です。ローカルドキュメントの一般的な編集許可は、リモートへの公開権限を与えるものではありません。範囲内で仕様、進行中の作業、変更履歴をローカルに維持してください。候補の先送りには、project-documents.md に記載されたバックログの権限に従ってください。リモートのバックログと並行するローカルのキューを作成してはいけません。

トリアージ中に投稿するすべてのコメントまたは新しいタスクは、以下で始めます。

> *This was generated by AI during triage.*

参考ドキュメント

• agent-brief.md：長期利用できる、準備完了状態のブリーフ。
• out-of-scope.md：却下された機能強化のナレッジベース。

ロール

カテゴリロール：

• bug：何かが壊れています。
• enhancement：新機能または改善です。

受付状態ロール：

• to-evaluate：メンテナーによる評価が必要です。
• on-hold：指定された返信、依存関係、または阻害要因を待っているため、保留中です。
• ready：仕様が完全に定まり、概要が添付されているため、着手できます。
• not-planned：対応せずに終了し、その理由が記録されています。

これらの状態は、作業に着手できるかどうかを示します。進行中、レビュー中、デプロイ済みといった状態は、トラッカー独自の進捗フィールド、ローカルのタスク進捗、ブランチ、または PR で管理します。

着手可能な概要には、人間が実装する必要がある作業と、アクセス権、判断、手動テストなど、委任できない理由を記載できます。これは概要の一項目であり、別のロールではありません。PR の場合、着手可能とは、エージェントが仕上げるか人間がマージするかにかかわらず、その差分に対する次の手順が明確になっていることを意味します。

トリアージ済みの各タスクには、カテゴリロールをちょうど1つ、状態ロールをちょうど1つ付与します。状態が競合する場合（1つのタスクに状態が2つ記載されている場合、またはロールがトラッカー独自の状態と食い違う場合）は、それぞれの状態を出典と日付とともに示し、最新の証拠（最新のコメント、リンクされたプルリクエストの状態など）が裏付ける状態を推奨します。メンテナーが選択するまでは、ロールを適用しないでください。ロールファイルは標準ロールをプロジェクトで実際に使われている文字列に対応付けます。語彙を重複して作るのではなく、その対応付けを使用してください。

通常、トリアージされていないタスクは to-evaluate になり、その後 on-hold、ready、または not-planned に移行します。保留中のタスクは、指定された条件が満たされたら to-evaluate に戻します。メンテナーはこれを上書きできますが、通常と異なる遷移にはフラグを立て、事前に確認してください。

呼び出し

メンテナーは /triage を実行し、依頼内容を説明します。

• 「対応が必要なものをすべて表示してください。」
• 「#42 を確認しましょう。」
• 「#42 を ready にしてください。」
• 「エージェントが着手できる ready の項目は何ですか？」

対応が必要な項目を表示する

設定済みのトラッカーを照会し、古い順に次の3つのグループを表示します。

1. 状態ロールのない、トリアージされていないタスク。
2. to-evaluate のタスク。
3. 指定された条件が満たされた on-hold のタスク。表示する前に、返信、マージ済みの依存関係、または解消済みの阻害要因があるか、メモを確認してください。

PR を対象に含める場合は、項目に [PR] または [task] のタグを付けます。検出の対象となる外部 PR は、設定の作成者フィルターに合致するものに限ります。明示的に指定された PR は、作成者にかかわらずトリアージします。件数と各項目の概要を1行で表示し、メンテナーに選択を促します。

タスクまたは PR をトリアージする

1. コンテキストを収集します。 本文、コメント、ロール、作成者、日付、過去のトリアージメモを読みます。PR の場合は差分も読みます。AGENTS.md が参照するドメイン用語集と該当するアーキテクチャ決定記録を使って調査します。ドメインの概念で既存の実装を検索し、どこを調べたかを報告します。AGENTS.md が範囲外フォルダーを指定している場合は、そのフォルダーの記録も読み、該当する過去の却下を明らかにします。
2. 推奨します。 カテゴリーと状態を、根拠および関連するコードベースの概要（すでに実装されている動作を含む）とともに提示します。指示を待ちます。
3. 検証します。 改善に着手する前に、報告者の手順でバグを再現します。PR の場合は、差分をその主張と照合し、関連するテストまたはコマンドを実行します。コードパス、失敗、または情報不足とともに、確認できた動作を報告します。情報不足の場合は、保留の推奨が妥当です。
4. 必要に応じて改善します。 インタビューメソッドに従って、人に確認しながら疑問を解消します。用語が曖昧、意見が分かれる、または用語集やコードと衝突する場合は、その衝突を明示し、具体的なシナリオで検証して、標準用語を提案します。人の合意が得られたら、glossary-format.mdに従って用語集に追加します。未解決の提案は機能のドラフトに残し、合意された動作と受け入れ条件を仕様に反映し、変更の取り消しが難しい決定はdecision-record-format.mdに従って記録します。
5. 確認済みの結果を適用します。
   • ready：エージェントブリーフを投稿します。これは、正規の仕様および該当する要件にリンクする、タスク実行に関する正式な契約です。人の対応が必要な理由があれば明記します。
   • on-hold：保留解除の条件を具体的に記したメモを投稿します。延期候補は、正式に設定されたバックログで管理します。ローカルで追跡する場合はローカルの本文に、リモートで追跡する場合は承認済みのリモート更新に記録します。公開待ちおよび作業を一時停止中の項目は、競合するバックログやコピーしたトラッカーの状態ではなく、ローカルの作業状態で管理します。
   • not-planned、実装済み：既存の実装へのリンクを添えてクローズします。これは却下ではなく、却下ナレッジベースにも登録しません。
   • not-planned、却下されたバグ：丁寧に説明してクローズします。
   • not-planned、却下された機能強化：範囲外の記録を作成または更新し、コメントにリンクしてからクローズします。
   • to-evaluate：ロールを適用し、必要に応じて進捗の一部を記録します。
6. project-documents.mdに従って、関連するローカルコンテキストとルートの変更履歴を更新します。結果と次のアクションがあれば報告します。

状態の直接指定

メンテナーが状態を直接指定した場合は、その判断を尊重します。実行前にロールの変更、コメント、またはクローズを確認し、改善の手順は省略します。改善セッションを経ずに ready にする場合は、エージェントブリーフが必要か確認します。この明示的な指定を理由に、存在しないブリーフがあるかのように扱ってはいけません。

保留テンプレート

## Triage Notes

**What we've established so far:**

- Resolved fact or decision

**Waiting on:** the concrete reply, dependency, or blocker that must arrive

**What we still need (@reporter):**

- Specific, actionable question

解決済みの質問を記録し、後のセッションで同じ質問を繰り返さないようにします。スレッド全体を読み直さなくても保留が解除されたか確認できるよう、保留内容を具体的に記します。

再開

過去のメモ、未回答の質問、関連する進行中作業のコンテキストを読みます。明記された保留が解除されたか確認し、続行する前に更新後の状況を提示します。解決済みの回答は再利用し、再度質問しないようにします。