docs(agents): standardize AE-HANDOFF protocol

[ootakazuhiko]

概要

• /handoff 運用の標準プロトコルを文書化
• PR/Issueコメントで再利用できる最小テンプレートを追加

変更内容

• 追加: docs/agents/handoff.md
  • AE-HANDOFF の必須項目（Goal/Status/Next actions/Commands/Artifacts/Risks/Blockers）を定義
  • Change Package が存在する場合の参照方法を定義
• 追加: templates/comments/AE-HANDOFF.md
  • すぐ貼り付けできるコメントテンプレート
• 更新: AGENTS.md
  • Progressive Disclosure に docs/agents/handoff.md を追加
• 更新: docs/agents/README.md
  • Handoff標準プロトコルへの導線を追加

影響範囲

• ドキュメントのみ（workflow実装ロジック変更なし）

検証

• pnpm -s run check:doc-consistency

Rollback

• 本PRをrevertすれば元に戻せます

関連

• Closes [Agents][Process] /handoff の標準プロトコル（AE-HANDOFF）と最小Evidenceテンプレを整備（Change Package #2289 と分離） #2296
• [Pull Requests] diff レビュー中心を廃止し、Change Package + 自己検証/第二エージェントで例外のみ人手化 #2289（Change Package本体の実装）

[github-actions]

Quality Summary

• Adapters:

• Formal: n/a

• Replay: n/a

• Trace IDs:

Harness Health

• severity: ok
• source: workflow=PR Maintenance, runId=22444007580, sha=34b709fb6210ea6a5d1dbaaac3f07158224ad755

Gate	Status	Checks
artifactsSchema	skip	0
testingHarness	skip	0
contextPack	skip	0
ciExtended	skip	0

[github-actions]

Progress Summary

• Missing: metrics, quality, traceability, phaseState

[github-actions]

Generate Artifacts Preview

Generated at: 2026-02-26T13:24:46.902Z

• tests/api/generated: clean
• artifacts/codex: clean
• artifacts/spec: clean

[github-actions]

KvOnce Trace Validation

• OTLP: ✅ Success (Issues: 0)
• NDJSON: ✅ Success (Issues: 0)

[Copilot]

Pull request overview

This PR standardizes the AE-HANDOFF protocol for agent-to-agent handoffs by introducing documentation and a reusable comment template. This work is separated from the Change Package implementation (#2289) and focuses solely on defining the minimal protocol for handoff communications between agents. The documentation establishes required fields (Goal, Status, Next actions, Commands, Artifacts, Risks, Blockers) and integrates the handoff protocol into the agent documentation hierarchy.

Changes:

• Adds standard AE-HANDOFF protocol documentation with required/optional fields and usage examples
• Adds reusable comment template for PR/Issue handoffs
• Integrates handoff documentation into Progressive Disclosure order and agent docs index

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
templates/comments/AE-HANDOFF.md	Reusable comment template with all handoff protocol fields
docs/agents/handoff.md	Complete protocol specification including purpose, required fields, usage, and example
docs/agents/README.md	Adds handoff protocol reference to agent docs index and notes future Prompt Pack expansion
AGENTS.md	Inserts handoff.md as #2 in Progressive Disclosure order, renumbers subsequent items

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

CI Status Snapshot (2026-02-26T20:08:07.347Z)

• docs(agents): standardize AE-HANDOFF protocol #2302 docs(agents): standardize AE-HANDOFF protocol | ✅12 ❌0 ⏳0 ⏭️14 | review:NONE | mergeable:MERGEABLE