Skip to content

docs(todo): split summary and todo5.md tasks to keep files under 50KB#133

Merged
aloekun merged 2 commits intomasterfrom
docs-todo-split-50kb
May 9, 2026
Merged

docs(todo): split summary and todo5.md tasks to keep files under 50KB#133
aloekun merged 2 commits intomasterfrom
docs-todo-split-50kb

Conversation

@aloekun
Copy link
Copy Markdown
Owner

@aloekun aloekun commented May 9, 2026

Summary

Claude Code の読み取り安定性閾値 (~50KB) を超過していた docs/todo.md (68KB) と docs/todo5.md (67KB) を分割。全 todo*.md / todo-summary.md (8 ファイル) を 50KB 以下に整列。

File Sizes (50KB Threshold Check)

File Before After Status
docs/todo.md 68KB 36KB
docs/todo2.md 32KB 32KB ✅ (unchanged)
docs/todo3.md 18KB 18KB ✅ (unchanged)
docs/todo4.md 47KB 47KB ✅ (unchanged)
docs/todo5.md 67KB 25KB
docs/todo6.md 15KB 15KB ✅ (unchanged)
docs/todo7.md (new) 45KB
docs/todo-summary.md (new) 33KB

Split Boundary Rationale

docs/todo5.md は古い半分 (PR #101#109、順位 47-67、13 タスク) を docs/todo7.md に移動し、新しい半分 (PR #110 以降、順位 68-88、11 タスク) を残す形で分割。これにより docs/local-llm-offload-history.md の "末尾"・"順位 80-88 = todo5.md" 参照が破壊されない。

Pre-push Review

simplicity-review / security-review 両方 APPROVE (run: 20260509-054442-pre-push-review)。

Non-blocking findings 2 件 (preamble カウント不整合):

  • docs/todo6.md line 5: 「六つすべてを確認すること」 → 八つに更新が必要
  • docs/todo7.md line 5: 「七つすべてを確認すること」todo-summary.md を含めて八つに更新が必要

機能影響なしの ephemeral tracking なので別 commit で fold-in 検討。

Test Plan

  • recommended-order-summary anchor が GitHub 上で正しく解決すること (markdown プレビュー確認)
  • docs/todo-summary.md table 内のファイル列リンク (todo2.mdtodo7.md) が解決すること
  • CodeRabbit が分割整合性 (移動前後で順位 47-69 のメタ情報が一致) を検証すること

Summary by CodeRabbit

  • Documentation

    • 推奨実行順序のサマリーテーブルを専用ドキュメントとして新規追加しました
    • タスク管理ドキュメント群の参照先を一括更新し、参照構造と運用ルールを明確化しました
    • lintルールの説明例を修正し、悪例の参照先を更新しました
  • Chores

    • ドキュメント構成を最適化し、タスク分割とマルチファイルワークフローを確立しました

Review Change Stack

Claude Code の読み取り安定性閾値 (~50KB) を超過していた docs/todo.md (68KB)
と docs/todo5.md (67KB) を分割。

- docs/todo.md (68KB → 36KB): 推奨実行順序サマリー section を独立した
  docs/todo-summary.md (新規 33KB) に切り出し。todo.md には pointer のみ残す
- docs/todo5.md (67KB → 25KB): PR #101#109 由来の古い半分 13 タスクを
  docs/todo7.md (新規 45KB) に分離。todo5.md には PR #110 以降が残存
- recommended-order-summary anchor 参照 7 箇所 (todo2-6.md /
  custom-lint-rules.toml) を todo-summary.md# に更新
- ADR-034 / local-llm-offload-history.md の priority table 参照 4 箇所も
  todo-summary.md に追従更新
- todo-summary.md table の「ファイル」列で 順位 47-67 を todo5.md → todo7.md
  に変更、todo7.md 内部チェックリストの「本 todoN.md エントリを削除」も整合

全 8 ファイル (todo.md / todo2-7.md / todo-summary.md) が 50KB 以下に収まる。
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 9, 2026

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: bedac609-1d74-48e6-8d23-9342813a3292

📥 Commits

Reviewing files that changed from the base of the PR and between 8a99495 and 4889413.

📒 Files selected for processing (2)
  • docs/todo6.md
  • docs/todo7.md
✅ Files skipped from review due to trivial changes (2)
  • docs/todo7.md
  • docs/todo6.md

📝 Walkthrough

Walkthrough

PR #133 は、TODO 関連ドキュメント群の参照構造を再編成し、新規 docs/todo-summary.md を推奨実行順序の中央索引として追加、関連ファイルの参照先を todo-summary.md に統一し docs/todo7.md を新設して一部タスクを分離しました。

Changes

TODO ドキュメント構造再編成

Layer / File(s) Summary
文書体系ポリシー
docs/todo.md
冒頭ルール更新:分割ルール・ファイル役割分担・セッション検証要件(8 ファイル確認)を明文化し、docs/todo-summary.md を索引ファイルに位置付け。
推奨実行順序の中央索引
docs/todo-summary.md
新規追加。順位/Tier/タスク/参照ファイル/工数/依存を列挙する大規模表と Bundle 群の運用履歴・採否情報を追加。
PR 起源タスク群
docs/todo7.md
新規追加。時刻境界検出カスタムルール、エラーパステスト、takt 更新、comment-lint MultiEdit 対応、post-merge 堅牢化、PreToolUse 制御、pipe truncate 禁止、ADR-030 回復仕様などのタスク群を収録。
todo2–todo6 の参照リンク統一
docs/todo2.md, docs/todo3.md, docs/todo4.md, docs/todo5.md, docs/todo6.md
「推奨実行順序」参照先を docs/todo-summary.md#recommended-order-summary に統一。
ADR・履歴ドキュメントの参照更新
docs/adr/adr-034-coderabbit-auto-monitoring.md, docs/local-llm-offload-history.md
ADR-034 の新セッション確認手順や履歴中の Bundle 登録記述で参照先を docs/todo-summary.md に差し替え。
Lint ルール例の更新
.claude/custom-lint-rules.toml
no-mutable-anchor ルールの「bad」リンク例を todo-summary.md に変更。

推定レビュー工数

🎯 3 (Moderate) | ⏱️ ~25 分

関連 PR

🚥 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タイトルは、このPRの主要な変更である「docs/todo.mdとdocs/todo5.mdを分割し、ファイルを50KB以下に保つ」という目的を明確かつ簡潔に要約している。
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

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

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 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/todo6.md`:
- Line 5: The preamble in docs/todo6.md incorrectly states "六つすべてを確認すること" even
though the repo currently has eight todo files; update that sentence to reflect
eight files and list them explicitly (todo.md, todo2.md, todo3.md, todo4.md,
todo5.md, todo6.md, todo7.md, todo-summary.md) and ensure the parallel note in
todo7.md is also updated so both preambles are consistent with the PR summary.

In `@docs/todo7.md`:
- Line 5: Update the sentence that reads "新セッションでは七つすべてを確認すること" to reflect the
current count after adding todo-summary.md by replacing "七つ" with "八つ" (or
otherwise adjusting the number to match the actual files to be checked), and
verify any neighboring text that enumerates files still matches the new total so
the statement and any counts remain consistent.
- Line 103: The relative ADR link
"../docs/adr/adr-036-bundle-z-three-layer-review.md" in docs/todo7.md is
incorrect (it resolves to docs/docs/...), so update that link text to the
correct path from the docs/ folder (e.g.
"adr/adr-036-bundle-z-three-layer-review.md" or
"./adr/adr-036-bundle-z-three-layer-review.md") so the reference to ADR-036
resolves properly.
🪄 Autofix (Beta)

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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d01e3962-dc52-4675-b430-b47cd196d9a3

📥 Commits

Reviewing files that changed from the base of the PR and between fd54b08 and 8a99495.

📒 Files selected for processing (11)
  • .claude/custom-lint-rules.toml
  • docs/adr/adr-034-coderabbit-auto-monitoring.md
  • docs/local-llm-offload-history.md
  • docs/todo-summary.md
  • docs/todo.md
  • docs/todo2.md
  • docs/todo3.md
  • docs/todo4.md
  • docs/todo5.md
  • docs/todo6.md
  • docs/todo7.md

Comment thread docs/todo6.md Outdated
Comment thread docs/todo7.md Outdated
Comment thread docs/todo7.md Outdated
PR #133 で CodeRabbit が検出した 3 件 Minor finding を修正:

- docs/todo6.md:5: 「六つすべてを確認すること」→「八つすべてを確認すること
  (todo.md / todo2-7.md / todo-summary.md)」
- docs/todo7.md:5: 「七つすべてを確認すること」→「八つすべてを確認すること
  (todo.md / todo2-7.md / todo-summary.md)」 (todo-summary.md カウント漏れ修正)
- docs/todo7.md:103: ADR-036 link を `../docs/adr/...` → `adr/...` に修正
  (todo7.md は docs/ 配下なので `../docs/` は誤り。todo5.md からの分割で表面化
  した pre-existing bug)

cli-finding-classifier (ADR-038) は ADR-035 docs-only filter で
not_applicable 判定したが、GitHub thread state は依然 unresolved のため
fold-in fix で thread を closeable な状態にする。
@aloekun
Copy link
Copy Markdown
Owner Author

aloekun commented May 9, 2026

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 9, 2026

✅ Actions performed

Review triggered.

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.

@aloekun aloekun merged commit 4210e79 into master May 9, 2026
1 check passed
@aloekun aloekun deleted the docs-todo-split-50kb branch May 9, 2026 08:45
aloekun added a commit that referenced this pull request May 9, 2026
…#134)

- todo6.md / todo-summary.md に Bundle j 3 タスク追加 (順位 94-96)
  - 94: docs/ 内 ../docs/ 相対パストラップ検出 lint rule (Tier 1, S)
  - 95: docs/todo*.md preamble file count 自動照合 (Tier 2, S)
  - 96: Markdown cross-reference validator CI step (Tier 2, M)
- local-llm-offload-analysis.md に Phase c MVP 完了 (PR #132) を反映
  - 実装方針変更 (takt facet -> cli-push-runner stage) を §1 Phase c に記述
  - Phase c+ (Bundle i) として PR #132 post-merge-feedback 採用 3 件
  - §8.E を MVP land 済みステータスに更新
  - 再開チェックリストに Phase c smoke / Bundle i 着手手順を追加
- todo-summary.md retrospective に Bundle j (PR #133 post-merge-feedback) 追記
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant