docs(adr-040): step_timeout の sublinear/KV cache 説明追記と 600s/720s 数値整合

[aloekun]

概要

docs/claude-code-web-tasks.md の 順位 116 (T3 / XS、PR #145 T3-#1) を着手。ADR-040 の step_timeout 比例係数 section に sublinear / KV cache locality の clarification を追記し、reference table の 600s と係数 derivation の 720s の数値整合を取った。

背景の不整合

ADR-040 の線形 ceiling は header で 720s と記載されていたが、formula は 22 ms/token × 32768 = 721s を算出しており、丸め由来の数値不整合があった。

変更内容

docs/adr/adr-040-local-llm-context-size.md:

• 線形 ceiling の formula を 180s × (32768 / 8192) = 180s × 4 = 720s に修正し、721s との不整合を解消（22 ms/token 表示は丸め由来の近似である旨を併記）
• canonical 600s が線形 ceiling 720s を 120s (17%) 下回る差を、sublinear / KV cache locality の定量表現として明文化（per-token ≈22 → ≈18.3 ms/token の 17% 改善と整合）
• reference table 直下に、表の 600s と係数 section の 720s の関係を整合説明として追記

docs/claude-code-web-tasks.md:

• 着手フロー step 3 に従い順位 116 の行を削除

トラッキング cleanup の所見

docs/todo-summary.md と各 docs/todoN.md を確認したところ、順位 116 に対応する table 行・詳細 section は既に存在しなかった（PR #145 関連で残るのは順位 117 のエントリのみ）。そのため着手フロー step 3 (todo-summary 行削除) / step 4 (todoN.md section 削除) は削除対象なしで、claude-code-web-tasks.md の行削除のみ実施した。

検証

• 純 docs 修正のため Rust ビルド / Windows hook / pnpm パイプライン非依存（claude-code-web-tasks.md の採用判定基準 2 を満たす）
• 数値整合: 180s × 4 = 720s、(720 − 600) / 720 ≈ 17%、per-token (22 − 18.3) / 22 ≈ 17% が相互に整合

https://claude.ai/code/session_01LyAvRfNsyLF1HNNb9hrQC6

---

Generated by Claude Code

Summary by CodeRabbit

リリースノート

• ドキュメント
  • LLMコンテキストサイズ設定に関する説明が更新され、タイムアウト係数の記述が整理されました
  • リファレンス値テーブルの根拠説明が追記されました
  • Claude Code Web対応タスクリストに新たなタスクエントリが追加され、参照先が明記されました

[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: eea8a7e8-3669-45a7-85e4-563352ad283e

📥 Commits

Reviewing files that changed from the base of the PR and between 312956d and c275450.

📒 Files selected for processing (2)

• docs/adr/adr-040-local-llm-context-size.md
• docs/claude-code-web-tasks.md

💤 Files with no reviewable changes (1)

• docs/claude-code-web-tasks.md

---

📝 Walkthrough

Walkthrough

ADR-040 の step_timeout 比例係数説明を線形導出・定量差・運用補正の三層構造に再構成し、参照値テーブルの根拠文を更新。Web タスク表に ADR-007 case study 対応タスク（rank 120）を追加し、関連ファイルを明記。

Changes

ドキュメント・タスク管理の更新

レイヤー / ファイル	概要
ADR-040 step_timeout 係数の定量化と運用ルール化 docs/adr/adr-040-local-llm-context-size.md	step_timeout 比例係数の説明（線形導出 720s と canonical 600s、KV cache locality による差分）を、線形 derivation の前提、17% の定量差、未測定環境での初期 ceiling と 2x margin 補正ルールへ再構成。参照値テーブルの根拠文も一貫性を持たせて更新。
Web タスク表への ADR-007 case study タスク追加 docs/claude-code-web-tasks.md	Claude Code Web 対応可能タスク表に rank 120 の新規エントリ「takt-workflow-persona-without-model ルールコメント拡張 + ADR-007 case study 追記」を追加。編集対象ファイル .claude/custom-lint-rules.toml および docs/adr/adr-007-custom-linter-layer-boundary.md を参照明記。

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• aloekun/claude-code-hook-test#145: PR #145 で導入した ADR-040 コンテンツ（step_timeout 比例係数と参照値テーブル）に対する直接的な継続編集・定量化・整合化。
• aloekun/claude-code-hook-test#161: ADR-007（semantic self-limitation と lint rule チェックリスト）の更新内容と同じ ADR-007 文脈を扱い、Web タスク表に case study 追記を反映。

🚥 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(adr-040): step_timeout の sublinear/KV cache 説明追記と 600s/720s 数値整合」は、主な変更内容（ADR-040 ドキュメントの step_timeout に関する sublinear/KV cache の説明追記と、600s/720s の数値整合化）を正確に反映しており、変更セットの中心的な改善を明確に示しています。
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.}