docs(ledger): 夜間ループでマージした順位を台帳から削除する運用を明文化

[aloekun]

Summary

• 夜間ループの PR をマージするときは同時に台帳から該当順位を削除する運用を claude-code-web-tasks.md に明文化
• 今回マージ対象の順位 163 を 3 ファイルから削除 (台帳 / todo-summary.md / todo11.md の詳細エントリ)
• 削除対象はマージした順位だけ。クローズした夜間 PR の順位は完了していないので残す

Context

Why: 夜間ループの「着手済み」判定は claude/nightly-* ブランチの存在だけを見る (ADR-072 決定 3)。台帳に完了を示す列は無く、無人可 列の ✅ は着手可否の印であって進捗ではない。

したがって PR をマージしてブランチを削除すると、除外マーカーが消えて同じ順位が再選択される。しかも完了済みタスクの重複実装になる。

先行事例: #365 のブランチを手で削除した際、順位 203 が再選択されて #373 が作られた。あれはクローズ由来だったが、マージ由来でも同じ構造で起きる。

なぜ夜間ループ自身が後始末できないか: Guard step が台帳の書き換えを禁止している (ADR-072 決定 6)。自律 actor が自分の選択元を書き換える経路を塞ぐための意図的な制約なので、完了の記録は人間側の責務として残る。今回この責務が明文化されていなかったため、#381 のマージ直前に発覚した (2026-08-10 ユーザー判断で本 PR を先行させた)。

既存の「着手フロー」との関係: 手順 3〜4 が既に「完了後に台帳と todo から削除する」と定めていたが、Web セッションで人間が着手する場合を想定した記述で、夜間ループ経由のケースが読み取れなかった。同じ削除をマージ時に行う旨を専用の節として追加した。

Scope decision: docs のみ。PR #381 のマージはこの PR が land した後に行う (順位 163 が master の台帳から消えていないと、次の夜間 run で再選択されうる)。

Validation

• pnpm lint:md (127 files) / pnpm lint:docs: 0 error
• pnpm push pre-push review: approved
• 順位 163 の残存が無いことを確認 (grep '^| 163 ' docs/*.md が 0 件、詳細エントリの見出しも消滅)
• todo11.md の section 削除後に --- が重複していたため整形済み

References

• ADR-072 決定 3 (ブランチ = 着手済みマーカー) / 決定 6 (台帳書き換えの禁止)
• ADR-031 § 残存ブランチ検出 (クローズ由来のブランチを週次で棚卸し、再挑戦は許容)
• PR feat: 順位 203 の無人実装 (nightly-todo) #365 / feat: 順位 203 の無人実装 (nightly-todo) #373 (再選択が実際に起きた事例) / feat: 順位 163 の無人実装 (nightly-todo) #381 (本 PR の契機)

Summary by CodeRabbit

• ドキュメント
  • 夜間ループで作成されたPRをマージする際の、関連タスク順位の削除手順を追加しました。
  • クローズ済みPRの順位の扱いや、ブランチ削除後の再選択に関する注意事項を明記しました。
  • 完了した「Cross-ref edge case test coverage」タスクをタスクリストから削除しました。

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a5da47ac-9338-4387-bf29-893125a91b96

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

📝 Walkthrough

Walkthrough

PR マージ時のタスク台帳更新手順を追加しました。順位 163 の cross_ref validator テストタスクを関連する一覧から削除しました。

Changes

タスク台帳の保守

Layer / File(s)	Summary
台帳更新手順 docs/claude-code-web-tasks.md	PR マージ時に関連ファイルと詳細エントリを更新する手順を追加しました。クローズした PR の順位を保持するルールも明記しました。
順位 163 のタスク削除 docs/claude-code-web-tasks.md, docs/todo-summary.md, docs/todo11.md	cross_ref validator の edge case テストタスクを Batch 1 と詳細 TODO から削除しました。

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• aloekun/claude-code-hook-test#92: 順位参照と TODO 台帳の保守を扱っています。
• aloekun/claude-code-hook-test#158: 今回更新したタスク取得手順に関連します。
• aloekun/claude-code-hook-test#362: タスク台帳の削除とライフサイクル規則を扱っています。

🚥 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	タイトルは、夜間ループでマージした順位を台帳から削除する運用の明文化という主な変更を正確かつ簡潔に示しています。
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/ledger-completion-cleanup

---

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.}

[aloekun]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/claude-code-web-tasks.md`:
- Line 50: Update the Japanese connective at the end of the explanatory
paragraph in docs/claude-code-web-tasks.md, replacing the sentence-ending
“したがって:” with wording that explicitly introduces the following problems, such as
“そのため、次の問題が起きます。”.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: dd0daebe-6043-4563-84ca-1c96bfa7e701

📥 Commits

Reviewing files that changed from the base of the PR and between e1c35e7 and e22b0ac.

📒 Files selected for processing (3)

• docs/claude-code-web-tasks.md
• docs/todo-summary.md
• docs/todo11.md

💤 Files with no reviewable changes (2)

• docs/todo11.md
• docs/todo-summary.md

[github-actions]

🤖 PR Monitor 分析 (GitHub Actions バックストップ)

• トリガー: pull_request_review (submitted) / 実行 run
• CI: rust (ubuntu-latest) pass / rust (windows-latest) pass / CodeRabbit review completed (pass) / request は skipping（対象外) / analyze は本ジョブ自身のため pending（除外）— 実質 green
• レビュー状況: CodeRabbit が review 実施済み（COMMENTED, actionable comment 1件）。人間レビューはまだ無し（reviewDecision 空、mergeStateStatus: BLOCKED — 承認待ちの可能性）
• Verdict: user_decision

Applicable Findings (Critical / High / Major)

該当なし

Applicable Findings (Medium 以下)

#	File (Line)	Reviewer	Issue	Recommended Action
1	docs/claude-code-web-tasks.md (Line 50)	CodeRabbit	「本ファイルに完了を示す列は無く、無人可 列の ✅ は着手可否の印であって進捗ではない。したがって:」の文末が体言止め風の中断で、後続の箇条書きへの接続が不自然（LanguageTool 指摘: SITAGATTE_END）	CodeRabbit 提案通り「そのため、次の問題が起きます。」等、後続文を明示的に導く表現に修正（Minor / Quick win、任意修正）

Filtered (not applicable)

該当なし

次のアクション

• Minor な文言修正指摘（接続語）のみのため、マージ前に任意で反映するかは著者判断でよい（ADR-035: 本 PR は docs/claude-code-web-tasks.md を含むため厳密には docs-only 扱い対象外だが、当該指摘はテキスト品質の指摘でありADR矛盾等の問題ではない）
• mergeStateStatus が BLOCKED のため、マージ前にレビュー承認状況（reviewDecision 未確定）を確認する