Skip to content

docs(todo): PR #82 post-merge-feedback の Tier 1 / Tier 3 finding をタスク化 + ファイルサイズ調整#83

Merged
aloekun merged 2 commits intomasterfrom
docs-todo-followups-pr82
Apr 27, 2026
Merged

docs(todo): PR #82 post-merge-feedback の Tier 1 / Tier 3 finding をタスク化 + ファイルサイズ調整#83
aloekun merged 2 commits intomasterfrom
docs-todo-followups-pr82

Conversation

@aloekun
Copy link
Copy Markdown
Owner

@aloekun aloekun commented Apr 27, 2026

Summary

  • PR docs(todo): PR #81 post-merge-feedback の知見反映 + ADR-032 (docs-only fast path) タスク化 #82 の post-merge-feedback report (.claude/feedback-reports/82.md) で挙げられた Tier 1 / Tier 3 finding 3 件を採用しタスク化
  • 既存 markdownlint hook task に MD028 / MD040 / MD058 の初期 rule set 明示を追記 (T1-1 + T1-2 を既存 task に吸収)
  • 個人開発ブランチ保護方針 ADR/グローバルルール明文化を新規タスクとして追加 (T3-1)
  • reviewer facet 改善 (review-simplicity / review-security の DRY/YAGNI/security 軸明文化) を新規タスクとして追加 (T3-combined)
  • 推奨実行順序サマリー表を 10 件 → 12 件に拡張、全順位を再採番

Commit 構成

commit 内容
qrzsxmsm docs(todo): PR #82 post-merge-feedback の Tier 1 / Tier 3 finding をタスク化
slqktsll docs(todo): T3-combined (reviewer facet 改善) を todo.md → todo2.md へ移動

commit を分けた理由は、前者がタスク追加 (機能変更)、後者がファイル間移動 (ファイルサイズ管理) で目的が異なるため。

主な変更点

1. T1-1 + T1-2 (markdownlint hook 統合の補強)

post-merge-feedback が PR #82 で MD028 / MD040 / MD058 を初期 rule set として推奨。これは既存タスク docs/todo.md L412 (順位 3/12) の内部仕様強化に該当するため、新規タスク化せず既存 task の作業計画に明示を追記:

  • 設計決定 ルール: MD028 (no-blanks-blockquote) / MD040 (fenced-code-language) / MD058 (blanks-around-tables) を初期 rule set として有効化
  • 作業計画: .markdownlint.json 作成ステップに 3 ルールの有効化を明示

2. T3-1: 個人開発ブランチ保護方針 ADR/グローバルルール明文化 (新規タスク、Tier 1 順位 2/12)

PR #82 の計画フェーズで「Required reviewers (人間レビュー必須) は個人開発 + AI エージェント前提では anti-pattern」という判断に到達したが、7 回のフィードバック反復を要した。次回類似設計時に同じ反復を繰り返さないため、設計原則を ~/.claude/rules/common/git-workflow.md に恒久化する。

  • 配置先: 順位 1 (git-workflow.md jj 運用節更新) と同じファイルへの追記のため 並列実施推奨
  • 工数: XS
  • 内容: 「Required reviewers は anti-pattern」「CI-only blocking + event-driven 人間レビュー」「全変更レビューではなくリスクの高い変更だけ止める」を明文化

3. T3-combined: reviewer facet 改善 (新規タスク、Tier 2 順位 6/12、todo2.md 配置)

post-merge-feedback の 3 件 (simplicity DRY スコープ / simplicity YAGNI スコープ / security docs-only 判定軸) を 1 タスクに統合。reviewer の精度向上は 全 PR の review 効率に直結 (false positive iteration 削減)。

  • .takt/facets/instructions/review-simplicity.md に DRY 適用範囲 (コードロジックのみ) と YAGNI 適用範囲 (計画書・ドキュメント内の "将来候補" は対象外) を追記
  • .takt/facets/instructions/review-security.md に docs-only 変更の判定軸 (trust boundary 変化有無) を追記

4. todo.md 推奨実行順序サマリー表の更新

10 件 → 12 件に拡張し全順位を再採番。新規 2 件を以下に挿入:

  • 順位 2: T3-1 (Tier 1)
  • 順位 6: T3-combined (Tier 2)

戦略コメントに「順位 1-2 グローバルルール並列可」「順位 6 reviewer facet 改善は Tier 2 内で並列可能」を追記。

5. T3-combined を todo.md → todo2.md へ移動 (ファイルサイズ管理)

新規タスク 2 件を todo.md に追加した結果ファイルサイズが 52KB に到達 (50KB 閾値超過) したため、結合度の低い T3-combined を todo2.md に移動。結合度判断:

  • T3-1: 順位 1 (git-workflow.md jj 運用節更新) と同一ファイル編集 (~/.claude/rules/common/git-workflow.md) のため todo.md 残置
  • T3-combined: 独立コンポーネント (reviewer facet) のため todo2.md 移動

結果: todo.md = 49KB (閾値内に復帰)、todo2.md = 29KB

Test plan

  • docs/todo.md 推奨実行順序サマリー表が 12 件に拡張、新規 2 件 (順位 2, 6) が含まれることを確認
  • docs/todo.md markdownlint task に MD028/MD040/MD058 が明示されていることを確認
  • docs/todo.md に T3-1 (個人開発ブランチ保護方針) タスクが追加されていることを確認
  • docs/todo2.md に T3-combined (reviewer facet 改善) タスクが追加されていることを確認
  • 既存 5 タスクの「実行優先度」行が新採番 (/12) に更新されていることを確認
  • todo.md ファイルサイズが 50KB 以内に収まっていることを確認 (現在 49KB)
  • PR docs(todo): PR #81 post-merge-feedback の知見反映 + ADR-032 (docs-only fast path) タスク化 #82 post-merge-feedback report (.claude/feedback-reports/82.md) との整合性確認 (3 件全て反映済)

関連

aloekun added 2 commits April 27, 2026 23:26
PR #82 マージ後の post-merge-feedback report (.claude/feedback-reports/82.md)
で挙げられた以下 3 件を採用。

T1-1 + T1-2 (markdownlint hook 統合の補強):
- 既存の markdownlint task に MD028 / MD040 / MD058 の初期 rule set 明示を追記
- 新規タスク化ではなく既存タスクの作業計画に吸収

T3-1 (個人開発ブランチ保護方針 ADR/グローバルルール明文化、新規):
- 「Required reviewers は個人開発 + AI エージェント前提では anti-pattern」
  判断を ~/.claude/rules/common/git-workflow.md に明文化
- 計画フェーズで 7 回のフィードバック反復を要した経緯を恒久化
- 順位 1 (git-workflow.md jj 運用節更新) と同一ファイル編集のため並列実施可
- Tier 1 順位 2/12

T3-combined (reviewer facet 改善、新規、Tier 3 #2-4 統合):
- review-simplicity.md に DRY スコープ + YAGNI スコープ規定を追記
- review-security.md に docs-only 判定軸 (trust boundary 変化有無) を追記
- 全 PR の review 精度向上、false positive iteration 削減
- Tier 2 順位 6/12

その他:
- 推奨実行順序サマリー表を 10 件 → 12 件に拡張、順位を再採番
- 既存タスク 5 件の実行優先度 line を新採番に更新
- 戦略コメントに「順位 1-2 グローバルルール並列可」「順位 6 reviewer facet
  改善は Tier 2 内で並列可能」を追記
前 commit で 2 タスク追加した結果 docs/todo.md が 52KB に達し、ユーザー
指定の 50KB 閾値 (Claude Code 読み取り安定性) を超過。T3-combined は
既存 todo.md content との結合度が低いため独立移動が容易と判断。

変更内容:
- todo.md から「Reviewer facet 改善 (PR #82 T3-combined)」セクションを削除
- todo2.md 末尾に同セクションを追加 (内部の「本 todo.md エントリを削除」
  → 「本 todo2.md エントリを削除」に修正)
- todo.md 推奨実行順序サマリー表の順位 6 行のファイル参照を todo.md →
  todo2.md に更新

結果:
- todo.md: 52KB → 49KB (閾値内に復帰)
- todo2.md: 21KB → 29KB (余裕あり)

T3-1 (ブランチ保護方針 ADR/グローバルルール明文化) は順位 1 (git-workflow.md
jj 運用節更新) と同一ファイル編集のため、結合度が高く todo.md に残置。
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 27, 2026

Warning

Rate limit exceeded

@aloekun has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 8 minutes and 44 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1088a9d4-083c-4f64-88b4-5df8dc3f5094

📥 Commits

Reviewing files that changed from the base of the PR and between 2c89e34 and 35aae32.

📒 Files selected for processing (2)
  • docs/todo.md
  • docs/todo2.md

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 e4749b8 into master Apr 27, 2026
1 check passed
@aloekun aloekun deleted the docs-todo-followups-pr82 branch April 27, 2026 14:46
aloekun added a commit that referenced this pull request Apr 27, 2026
PR #83 マージ後の post-merge-feedback report (.claude/feedback-reports/83.md)
で挙げられた 3 件のうち 2 件採用、1 件却下:

T3-1 (却下済み変更の再適用防止グローバルルール明文化、新規):
- 「ユーザーが現セッションで明示却下した変更は、後続の Edit / Write 操作で
  付随適用しない」ルールを ~/.claude/CLAUDE.md or coding-style.md に追記
- 本セッションで MD040 fence 不意追加を即 revert した事象の恒久化
- todo2.md に追加 (T3-2 の新ルール「新規タスクは todo2.md」適用)
- Tier 1 順位 3/13

T3-2 (todo.md / todo2.md 運用ルール明文化、即実施):
- docs/todo.md 冒頭の運用ルール blockquote を強化
- 「todo.md は既存タスクの編集・完了削除専用、新規追加は todo2.md へ」
  を明示。例外条項 (同一ファイル/コンポーネント密結合タスク) も追記
- 本タスク自身がこの新ルールに従って T3-1 を todo2.md に配置している

T3-3 (Markdown-only PR の review skip): 却下 (重複)
- ADR-032 (順位 9-11/13) と完全重複のため新規タスク化せず。
  ADR-032 既存タスクで吸収

その他:
- 推奨実行順序サマリー表を 12 件 → 13 件に拡張、全順位を再採番
- 既存 6 タスクの実行優先度 line を /12 → /13 に更新、
  cross-reference 順位も調整
- todo2.md ADR-032 sub-phase listing も /10 → /13 に統一
  (前回の renumbering で漏れていた箇所を併せて修正)

ファイルサイズ:
- todo.md: 49KB → 49KB (微増、閾値内維持)
- todo2.md: 29KB → 33KB (T3-1 追加分)
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