Skip to content

docs(todo): queue 棚卸し + todo9 → todo11 分割 + 順位 177 優先度引上げ#197

Merged
aloekun merged 1 commit into
masterfrom
docs/queue-cleanup-and-todo9-split
Jun 6, 2026
Merged

docs(todo): queue 棚卸し + todo9 → todo11 分割 + 順位 177 優先度引上げ#197
aloekun merged 1 commit into
masterfrom
docs/queue-cleanup-and-todo9-split

Conversation

@aloekun

@aloekun aloekun commented Jun 6, 2026

Copy link
Copy Markdown
Owner

Summary

本セッションで実施した docs-only 作業 4 つを 1 PR に統合:

  1. PR Bundle 195-FB: jj revset hardcode lint rule + helper parameterize #196 post-merge-feedback 採用 2 件 — 順位 193 (Companion helper compile-time validation test) + 順位 194 (development-workflow.md "Plan First" grep step) を todo10.md に登録
  2. queue 棚卸し — 順位 ≤ 100 の 32 件を audit、8 件削除 (既存 land 確認または動機失効) + 7 件改訂 (Status update で現状反映)
  3. todo9.md → todo11.md 分割 — 75KB / 890 行 → 37KB / 454 行 + 新 todo11.md (41KB / 453 行)、theme-based split (仕組み化バンドル + 週次拡張は todo9 / PR-specific follow-up は todo11)
  4. 順位 177 優先度引上げ — PostToolUse hook ファイルサイズ検出が 4 回目同型観測 (PR docs(todo): split summary and todo5.md tasks to keep files under 50KB #133/feat(hooks-pre-tool-validate): jj-message-required preset で jj new / jj split の -m 必須化 (順位 144) #172/docs: Phase D dogfood + 順位 174-182 採用 (週次レビュー Phase D + 既存変更 bundle) #186 + 本セッション = Very High frequency) に到達、Tier 1 内優先実装に格上げ

削除 8 件 (棚卸し根拠)

順位 task 削除根拠
41 Bundle Y2 効果定量計測 動機の主軸失効 (Bundle Z 完成 + Z2 不採用)
42, 43, 46 rate-limit auto-retry 系 (Bundle a Sub-PR 2) PR #97 / #113 / #129 / #185 段階 land 完了
45 check-ci-coderabbit --list-findings Rust モード PR #101 で land 済 (6cd931652c58)
57 Aggregation cap integration test PR #171 で land 済 (51328e8c9873)
93 coding-style.md partial fix 例追加 ~/.claude/rules/common/coding-style.md に既に section 存在 (PR #94/#111/#132 cite 込み)
97 with_num_ctx serialization test src/lib-ollama-client/src/lib.rs:494 で mockito test 実体存在

cross-reference 修復: 順位 49 (旧依存 Bundle a Sub-PR 2 消滅)、順位 61 (旧依存 順位 45 land 済)。

改訂 7 件 (Status update 2026-06-06)

順位 改訂ポイント
11 ADR-018 park / ADR-030 短命プロセス移行後の再現確認が前段必要
19 ADR-037/043/PR #194 land 後の残余 case baseline 観測が前段
27 Phase D-7 = PR #154 land 済を反映
38 ADR-031 採用昇格済 (PR #192) → Bundle W/X land のみ残依存
40 PR #175 push-runner bookmark_check 実装済 → skill 側は二重防御に縮小
51 採用案 C (fix.md instruction) は land 済、残作業 = dogfood 観測のみ
92 ADR-038 採用昇格済 (PR #156) で Phase d 運用入り、動機書き換え

todo9.md 分割の構造

  • todo9.md (37KB / 454 行): 既存ルール仕組み化バンドル (順位 146-151) + 週次レビュー拡張 (順位 152-154) を保持
  • todo11.md (41KB / 453 行、新規): PR-specific follow-up entries 10 件 (順位 157, 160-173)

todo-summary.md 冒頭の「追加先ファイル」明記を todo10.md に更新 (新規エントリは引き続き todo10.md へ、todo11.md は split 専用)。preamble 数詞 (十一つ→十二つ、todo2-10.md→todo2-11.md) を 7 ファイル分一括同期 (cli-docs-lint preamble check 経由で検出 + Python script で batch fix)。

順位 177 優先度引上げ (3 箇所同期)

  • todo10.md entry 本体: Status update 2026-06-06 blockquote 追加、🚀 Tier 1🚀 Tier 1 (優先実装) に格上げ
  • todo-summary.md table 行: Tier 列を太字 + 注記、dependency 列に urgency note 先頭追加
  • todo-summary.md 末尾の戦略 note: 「直近優先 (2026-06-06 ユーザー指示)」段落を新設、Bundle 195-FB-Followup (順位 193 + 194) の次の PR で消化推奨と specific call-out

統計

  • 10 ファイル変更 (1 新規)
  • net 約 240 行削減 (削除 8 件 + 分割で重複なし)
  • 全 todo*.md が 50KB 閾値以下: todo9 (37KB), todo10 (36KB), todo11 (41KB)

Pre-push-review

pre-push-review workflow APPROVE (1 iteration, 7m 56s)。docs-only PR として ADR-035 評価ポリシー適用、code-equivalent 変更なし。

Test plan

  • cli-docs-lint preamble check pass (cli-push-runner quality_gate)
  • markdownlint clean (全 todo*.md)
  • cargo test pass (本 PR は docs-only だが workspace test も green)
  • takt pre-push-review APPROVE
  • post-merge-feedback で削除/改訂判断の質を観測 (次回 PR で確認)

参照

  • .claude/feedback-reports/196.md (PR Bundle 195-FB: jj revset hardcode lint rule + helper parameterize #196 post-merge-feedback の採否確定)
  • memory feedback_todo_no_history (削除は痕跡なし、コメントマーカー不使用)
  • memory feedback_pnpm_create_pr_body (multi-line body は --body-file で渡す)
  • ADR-035 (docs-only PR 評価ポリシー)
  • ADR-033 (採番管理簡素化、順位 renumber は避けて semantic markers で表現)

Summary by CodeRabbit

  • Documentation

    • Updated internal task management documentation and project status tracking files. Reorganized and split documentation for improved maintainability, with no impact to end-user functionality.
  • Chores

    • Consolidated and restructured development workflow documentation to reflect current project phases and priorities.

本 PR は以下 4 つの作業を 1 コミットに統合:

## A. PR #196 post-merge-feedback 採用 2 件 (順位 193, 194 登録)

PR #196 (Bundle 195-FB) post-merge-feedback 8 件のうち 2 件採用、6 件却下/様子見。

採用 (todo10.md に entry 追加、todo-summary.md table に行追加):
- 順位 193 (T2): Companion helper group 署名整合 compile-time validation test
- 順位 194 (T3): development-workflow.md \"1. Plan First\" に Codification
  重複確認 step 追記

却下/様子見の詳細は .claude/feedback-reports/196.md 参照。

## B. queue 棚卸し (順位 ≤ 100 の 32 件を audit)

8 件削除 + 7 件改訂で queue の signal/noise 改善:

削除 8 件 (既存 land 確認、または動機失効):
- 順位 41 (Bundle Y2 効果定量計測): 動機の主軸失効 (Bundle Z 完成 + Z2 不採用)
- 順位 42, 43, 46 (rate-limit auto-retry 系): PR #97/#113/#129/#185 段階 land 完了
- 順位 45 (--list-findings Rust モード): PR #101 で land 済
- 順位 57 (Aggregation cap integration test): PR #171 で land 済
- 順位 93 (coding-style.md partial fix 例追加): ~/.claude/rules/common/
  coding-style.md に既に section 存在
- 順位 97 (with_num_ctx serialization test): lib.rs:494 で mockito test 実体存在

改訂 7 件 (Status update 2026-06-06 を front-matter に追加、現状反映):
- 順位 11: ADR-018 park / ADR-030 短命プロセス移行後の再現確認が前段
- 順位 19: ADR-037/043/PR #194 land 後の残余 case baseline 観測が前段
- 順位 27: Phase D-7 = PR #154 land 済を反映
- 順位 38: ADR-031 採用昇格済 (PR #192) → Bundle W/X land のみ残依存
- 順位 40: PR #175 push-runner bookmark_check 実装済 → skill 側は二重防御に縮小
- 順位 51: 採用案 C (fix.md instruction 追加) は land 済、残作業 = dogfood 観測のみ
- 順位 92: ADR-038 採用昇格済 (PR #156) で Phase d 運用入り、動機書き換え

cross-reference 修復:
- 順位 49: 旧依存 Bundle a Sub-PR 2 (順位 42/43/46) 消滅を反映
- 順位 61: 旧依存 順位 45 land 済を反映

## C. todo9.md → todo11.md 分割

todo9.md が 75KB / 890 行に到達し読み取り安定性閾値 (50KB) 超過のため分割:

- todo9.md (37KB / 454 行): 既存ルール仕組み化バンドル (順位 146-151) + 週次
  レビュー拡張 (順位 152-154) を保持
- todo11.md (41KB / 453 行、新規): PR-specific follow-up entries 10 件
  (順位 157, 160, 161, 162, 163, 165, 170, 171, 172, 173)

theme-based split で意味的分離 + 両ファイルとも 50KB 閾値以下に収まる。
todo-summary.md table の file 参照を Python script で一括更新 (10 件)、
todo-summary.md 冒頭の \"追加先ファイル\" 説明を todo10.md に更新。

## D. 順位 177 優先度引上げ

PostToolUse hook ファイルサイズ検出 task が 4 回目の同型観測に到達 (PR #133 +
#172 + #186 + 本セッション = Very High frequency)。CLAUDE.md code-review.md
\"同型 finding の閾値判定\" (3 観測 = Tier 1 昇格) を超え systemic risk 閾値到達。

3 箇所同期更新:
- todo10.md entry 本体に Status update 2026-06-06 blockquote 追加、優先度を
  \"Tier 1\" → \"Tier 1 (優先実装)\" に格上げ
- todo-summary.md table 行で Tier 列を太字 + 注記、dependency 列に urgency note
- todo-summary.md 末尾の戦略 note に \"直近優先 (2026-06-06 ユーザー指示)\"
  段落を新設、Bundle 195-FB-Followup (順位 193 + 194) の次の PR で消化推奨と
  specific call-out

## 統計

- 10 ファイル変更 (1 新規)
- ~670 lines insertions, ~910 lines deletions (net ~240 行削減)
- 全 todo*.md が 50KB 閾値以下に収まる (todo9: 37KB, todo10: 36KB, todo11: 41KB)

## 参照

- .claude/feedback-reports/196.md (採否確定 commit、PR #196 由来)
- memory feedback_post_merge_feedback_adoption_requires_user_approval per
  ユーザー承認済
- memory feedback_todo_no_history (削除は痕跡なし、コメントマーカー不使用)
- ADR-035 (docs-only PR 評価ポリシー)
- ADR-033 (採番管理簡素化、順位 renumber は避けて semantic markers で表現)
@coderabbitai

coderabbitai Bot commented Jun 6, 2026

Copy link
Copy Markdown

Review Change Stack

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: b9f3c282-80b9-4bce-897d-9be78a312aa4

📥 Commits

Reviewing files that changed from the base of the PR and between 3a3a150 and 7945872.

📒 Files selected for processing (12)
  • docs/todo-summary.md
  • docs/todo.md
  • docs/todo10.md
  • docs/todo11.md
  • docs/todo2.md
  • docs/todo3.md
  • docs/todo4.md
  • docs/todo5.md
  • docs/todo6.md
  • docs/todo7.md
  • docs/todo8.md
  • docs/todo9.md

📝 Walkthrough

Walkthrough

PR #197 reorganizes task-management documentation by updating the recommended execution-order summary table, creating a new todo11.md file to separate PR-specific follow-up work from todo9.md (addressing Claude Code reader constraints), and propagating file-split references and status updates across all related todo*.md files as of 2026-06-06.

Changes

Task documentation reorganization

Layer / File(s) Summary
推奨実行順序テーブル再編成
docs/todo-summary.md
docs/todo-summary.md の推奨実行順序テーブル全体を大幅に更新。多数の rank/tier/task/依存関係が差し替わり、vitest 固定、pnpm create-pr ヘルプ改善、.failed recovery、gh-token-efficiency、Secret detection PreToolUse、companion helper group 署名整合検証、Plan First grep 確認ステップなどが新規追加または再順位付けされる。末尾の「戦略」「直近優先」セクションも更新され、rank 177 が最優先として明記される。
新規タスク記録ファイル todo11.md 追加
docs/todo11.md
PR-specific follow-up タスク(rank 157, 160–173)を todo9.md から分離するため、新規ファイル todo11.md を作成。ファイル分割の背景、推奨参照順序、および PR #174#183 に関連する post-merge feedback、CR 回帰テスト、ドキュメント統一、グローバルルール、memory codification、subprocess utils 抽出などのタスク定義をテンプレート形式で列挙。
クロスファイル参照先更新とステータス追記
docs/todo.md, docs/todo2.md, docs/todo3.md, docs/todo4.md, docs/todo5.md, docs/todo6.md, docs/todo7.md, docs/todo8.md
ファイル分割(2026-06-06)に伴い、複数の todo ファイルの冒頭部で参照先リンク(todo2-10.md → todo2-11.md)を更新し、確認対象タスク数を「十一つ」から「十二つ」に変更。既存タスク項目に「Status update (2026-06-06)」を追記し、Phase 進捗、ADR 採用昇格、前提条件充足、依存関係の再整理などを明記(例:cli-pr-monitor termination 再検、takt REJECT-ESCALATE 実装状況、cargo-mutants L3 週次化、scale-aware eval fixtures ADR-038 本採用)。
todo9.md 内容分割と参照リダイレクト
docs/todo9.md
従前の Bundle 1 dogfood checklist 詳細記述(rank 157, 160–173)を削除し、todo11.md 参照の短い注記に置き換え。ファイル位置づけセクションに 2026-06-06 の分割方針と新セッション確認範囲を追記。
todo10.md の新規タスク追加と優先度更新
docs/todo10.md
新セッション確認対象を todo2-11.md へ拡張。PostToolUse ファイルサイズ閾値超過検出タスクの優先度を Tier1/Very High に引上げ、観測頻度増加を反映。companion helper group 署名整合検証テスト(compile-time witness)と development-workflow.md「1. Plan First」への grep 確認ステップ追記の 2 つの新規タスクを追加。/weekly-review skill 重複検出の grep 対象を todo2-10.md から todo2-11.md へ変更。

推定レビュー工数

🎯 2 (Simple) | ⏱️ ~12 minutes

関連する可能性のある 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のタイトルは「docs(todo): queue 棚卸し + todo9 → todo11 分割 + 順位 177 優先度引上げ」で、変更内容の主要なポイント(queue の棚卸し、todo9 から todo11 への分割、順位 177 の優先度引上げ)を明確に記述しており、変更セット全体の主要な目的と完全に一致している。
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.

@aloekun aloekun merged commit ac124f0 into master Jun 6, 2026
1 check passed
@aloekun aloekun deleted the docs/queue-cleanup-and-todo9-split branch June 6, 2026 14:02
aloekun added a commit that referenced this pull request Jun 6, 2026
…順位 177) (#198)

PostToolUse Edit / Write 直後にファイルサイズ閾値超過を検出して分割を促す mechanical layer
を実装。ファイル分割を user 判断ベース → mechanical layer に移管し、認知負荷削減 + 早期検出
を実現する。

## 背景

4 PR の同型観測 (Very High frequency) で systemic risk 閾値到達:
- PR #133: todo.md → todo2.md split
- PR #172: todo8.md → todo9.md split
- PR #186: todo9.md → todo10.md split
- PR #197: todo9.md → todo11.md split (本日 land)

順位 177 として todo10.md に登録済み、PR #197 で Tier 1 (優先実装) に格上げ。
ユーザー指示 (2026-06-07) で次の PR で消化と決定。

## 設計

配置: option B = 既存 hooks-post-tool-linter (generic linter) に Layer 0.5 として統合。
option A (新 binary) に対する優位性:
- 新 binary 追加なし → deploy 簡素 (Effort S 寄り)
- PostToolUse hook 数の最小化 (1 PR push で発火する hook 数を抑制)
- ADR-039 bounded lifetime dogfood サイクルを最短で開始可能

## 実装

### Layer 0.5 配置

main() を 4 layer helper に refactor (関数長 50 行制限内に収まる構造):
- Layer 0: UTF-8 整合性 (既存)
- Layer 0.5: file_size_check (新規、metadata-only) ★
- Layer 1: 正規表現 custom-rules (既存)
- Layer 2: 外部ツール pipeline (既存)

### Config schema

[post_tool_use.file_size_check] section (ADR-039 opt-in pattern 準拠):
- enabled = false (default OFF)
- threshold_bytes = 51200 (50KB、Claude Code 読み取り安定性閾値)
- paths = ["docs/**/*.md", "src/**/*.rs"] (default 対象 glob)
- touch_trigger = true (ratchet、既存超過は触られるまで grandfather)

Kill-switch: enabled = false で完全停止。

### Pure function design

check_file_size_threshold(file, size_bytes, config) は I/O フリーの純粋関数として実装、
file system access は呼び出し側 (run_file_size_layer) に分離。tests が deterministic に
書け、memory feedback_test_dry_antipattern に従い各 variant 独立 setup が trivial。

### touch_trigger ratchet の MVP 制限

touch_trigger = false (strict mode = 全 enabled paths を毎回スキャン) は ADR-039 bounded
lifetime dogfood 後の判定に倒し、MVP では config field 受理のみ (true/false 同挙動)。
3-5 PR の dogfood 観測後に default-ON 昇格 or strict mode 実装 or 却下を判定。

## ADR-007 amendment (Layer 0.5 追記)

ADR-007 § Layer 0.5 追記 section を新設し、file_size_check が Q1/Q2/Q3 判断フロー対象外
であることを codify。同型 (metadata-only、content 非依存) の future check は同 Layer 0.5
に追加することで regex / AST 層との責務境界を維持する原則を明文化。

## Tests

8 variant 独立 setup (memory feedback_test_dry_antipattern 適用):
1. enabled=false で短絡 (kill-switch 動作確認)
2. paths glob 不一致で skip
3. size 閾値内で skip
4. size 超過で feedback emit
5. docs/todo* に対する recovery hint 文脈別出し分け
6. paths が空配列の場合 skip
7. touch_trigger=false が MVP では true と同挙動
8. Windows backslash path の forward-slash 正規化

全 8 test pass、既存 141 test との non-regression 確認済 (cargo test 149/149 passed)。
cargo clippy --workspace -- -D warnings clean。

## Dogfood

threshold=30720 で hooks-config.toml を temporarily enable、docs/todo10.md (38155 bytes)
に hook 発火を実観測:
[file-size-check] docs/todo10.md: ファイルサイズ 38155 bytes が threshold 30720 bytes
(= 30.0 KB) を超過しています。ファイル分割を推奨します (docs/todo*.md の場合は新
todo<N+1>.md を新設して entry を移管).

小ファイル (docs/todo5.md 11909 bytes) は no-op を確認。dogfood 後 enabled=false /
threshold=51200 に revert 済 (production default = opt-in).

## 関連 docs 更新

- docs/todo10.md: 順位 177 entry 削除 (実装完了)
- docs/todo-summary.md: 順位 177 table 行 + 「直近優先 2026-06-07」call-out 段落 削除
- docs/adr/adr-007-custom-linter-layer-boundary.md: § Layer 0.5 追記 新設

## 参照

- memory feedback_pipeline_over_rules: rule → hook 切替の体系適用
- ADR-039: experimental feature 標準パターン (opt-in + kill-switch + bounded lifetime)
- ADR-007: custom-linter layer boundary (本 PR で Layer 0.5 追記)
- 順位 102 (PR #148 land): paths glob filter helper を再利用
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