docs(todo): 順位 79 (PR #117 T3-1 採用) 登録 — docs-governance.md retirement workflow 拡充

[aloekun]

Summary

PR #117 (docs/coderabbit-monitoring-efficiency.md retirement) の post-merge-feedback で採用された Tier 3 #1 (T3-1) を docs/todo*.md 系列に登録する docs-only PR。実装は今回スコープ外で、別 PR で進める。

PR #115 → #116 で確立した「post-merge-feedback の採用案を docs PR で独立に登録 → 実装は別 PR」運用の 3 例目。

変更内容

1. todo.md priority table 追加

順位 79 💎 Tier 3 (XS): docs-governance.md § Retirement Workflow に「残タスクの lifecycle 整合」要件明記

2. todo5.md 詳細セクション追加

順位 79 の詳細を既存フォーマット (動機 / 設計決定 / 作業計画 / 完了基準 / 詰まっている箇所) で記述。

採用根拠

観察: PR #117 で順位 15 (cli-pr-monitor 通知 Recovery 経路) を「Bb-3 で吸収済」として priority table から削除した際、現 docs-governance.md § Retirement Workflow Step 2「Migrate residual tasks」は priority table から除外するケース (= 完了/意図的 deprioritize/defer) を未定義。

提案: Step 2 を拡充し、priority table から除外するタスクを 3 値で commit/PR description に明示する要件を追加:

• 完了 (subsumed): 別タスクで実質達成済 (例: 順位 15 → Bb-3 で吸収)。subsuming task / PR を引用
• 意図的 deprioritize: 優先度を下げて当面着手しない。理由を引用
• defer: 後続 bundle で扱う。次の bundle context を引用

post-merge-feedback サマリー (PR #117)

.claude/feedback-reports/117.md で生成済。5 件中:

Recommendation	件数	採用された提案
✅ 採用 (本 PR で登録)	1	T3-1 (docs-governance.md retirement workflow 拡充)
🤔 様子見	3	T2-1 (todo sync lint) / T3-2 (ADR amendment heading template) / T3-4 (Parked Initiatives section)
❌ 却下	1	T3-3 (~/.claude/rules/* PR description rule、memory feedback_no_unenforced_rules 自動適用)

運用観察 (docs PR 経由でフィードバック登録 — 3 例目)

• PR docs(monitoring): Bundle b 完成記録 + Bb-3 post-merge-feedback の採用 3 件登録 (PR #115 follow-up) #116 (Bb-3 採用 3 件 = 順位 76/77/78)
• PR docs(adr): coderabbit-monitoring-efficiency.md retire — knowledge を ADR-018/034 に集約 #117 retirement で副次的に T3-1 採用提案を発生
• 本 PR (#???) でその T3-1 を独立 docs PR として登録

→ 「post-merge-feedback の採用 → docs PR で登録 → 実装は別 PR」運用が定着。docs PR の所要時間は概ね 3-5 分 (lint + push + PR 作成)、コーディング時間より短く済む。

pre-push-review 結果

all("approved") (1 iteration、2m 17s)。blocking anomaly なし。docs-only diff として ADR-035 の適用 criteria すべてをクリア。

Test Plan

• pnpm lint:md (54 ファイル / 0 error)
• pre-push-review all("approved")
• (post-merge) 順位 79 着手時に retirement workflow Step 2 改訂が他 PR で参照可能になることを確認
• (post-merge) PR docs(adr): coderabbit-monitoring-efficiency.md retire — knowledge を ADR-018/034 に集約 #117 自身が retroactive example として引用可能であることを確認

Out of Scope

• 順位 79 の実装 (docs-governance.md 改訂) — 本 PR は登録のみ
• 様子見 3 件 (T2-1 / T3-2 / T3-4) の採用判断 — 重複/再発を観察するため蓄積中

Summary by CodeRabbit

ドキュメンテーション

• タスク廃止ワークフローと分類方法に関するガイダンスを追加しました
• ライフサイクル管理要件を明記し、タスク削除時の注釈ルールを整備しました
• セキュリティと安全性に関するドキュメンテーションを強化しました
• マージ後のプロセス堅牢性に関する指針を追加しました

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c4de4789-22d3-4d1d-a5b3-31ca8c48b953

📥 Commits

Reviewing files that changed from the base of the PR and between b4d77e5 and 2f05a05.

📒 Files selected for processing (2)

• docs/todo.md
• docs/todo5.md

---

📝 Walkthrough

Walkthrough

このプルリクエストはドキュメント・ガバナンスの要件を追加しています。docs/todo.mdにTier 3タスク（タスク削除時に「サブサム/優先度下げ/先送り」いずれかの明示を義務付け）を新規挿入し、docs/todo5.mdでリタイアメント・ワークフロー手続き、ADR-038安全性ガイドライン、テスト基盤ガイダンスを拡充しました。

Changes

タスク・ライフサイクル・ガバナンス

Layer / File(s)	Summary
ガバナンス要件 docs/todo.md	PR #117採用によるTier 3タスク追加：タスク削除時に「完了/優先度下げ/先送り」の3値を明示する要件を規定し、将来の曖昧性を構造的に防止。
リタイアメント・ワークフロー定義 docs/todo5.md	新規セクション追加：3値分類（subsumed/deprioritize/defer）、ワークフロー手続き、完了基準を詳述。ADR-038タイムスタンプ演算安全性の関連コンテンツを挿入。
実装ガイダンス・テスト基盤 docs/todo5.md	no-ephemeral-todo-reference不変量、テスト・スキャフォルディング、既存lint/テスト基盤との統合点を明記。ADRおよびセキュリティドキュメントへのクロス・リンク補強。

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

• aloekun/claude-code-hook-test#117: 本PR内のTier 3タスク記述で直接参照されており、採用されたリタイアメント・ワークフロー要件の出典。
• aloekun/claude-code-hook-test#112: リタイアメント・ワークフロー導入およびtodo更新でタスク・ガバナンス要件を共有。
• aloekun/claude-code-hook-test#109: docs/todo*.md同一ガバナンス/todo更新とドキュメント・ライフサイクル・リタイアメント・ワークフロー要件の重複実装。

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PRのタイトルは本来の変更内容（docs/todo.md と docs/todo5.md への順位79の登録）を正確に反映しており、具体的で明確です。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}