docs(adr-028): 原則 6 — multi-line PR body は --body-file で渡す

[aloekun]

概要

docs/claude-code-web-tasks.md の順位 166 (Tier 3) タスクを実装しました。

ADR-028 に PR body 複数行時の --body-file 推奨 + shell argument truncation の why/how 補足追記 (PR #181 T3-#1 採用)

PR #134 / #181 で 2 回観測された pnpm create-pr の PR body truncation を、ADR-028 に permanent reference として codify します。順位 165 が test 層で防御するのに対し、本タスクは docs 層で後発の AI / reviewer が逆引き可能な構造的予防策を作る相補関係です。

変更内容

• docs/adr/adr-028-pnpm-create-pr-gate.md
  • 「原則 6: PR body が複数行/長文の場合は --body-file で渡す」を追加
    • why: 複数行 body をシェル引数直渡しすると argv 段階で改行が delimiter 化し body が partial 化（エラーにならない silent UX 劣化）
    • how: scratch file 経由（pnpm create-pr -- --body-file <path> / gh pr edit <N> --body-file <path>、scratch は __pr-body.md）
    • docs 層（本原則）と test 層（別タスク）の相補関係を明記
  • ステータス行に 2026-05-30 改訂注記、参照セクションに memory feedback_pnpm_create_pr_body と PR docs: Bundle j 登録 + Phase c MVP land 反映 (PR #132 post-merge-feedback) #134 / docs: 順位 8 handoff doc を 2026-05-28 セッション結果で update + PR #179 follow-up 登録 #181 の back-link を追加
• トラッキング更新（着手フローに準拠）: claude-code-web-tasks.md / todo-summary.md の順位 166 行、todo9.md の詳細セクションを削除

完了基準の充足

• ADR-028 に複数行 body ケースの why / how を codify
• 後発の AI / reviewer が ADR から逆引き可能
• memory feedback_pnpm_create_pr_body との相互参照
• PR docs: Bundle j 登録 + Phase c MVP land 反映 (PR #132 post-merge-feedback) #134 / docs: 順位 8 handoff doc を 2026-05-28 セッション結果で update + PR #179 follow-up 登録 #181 を実例 cite

docs-only の変更で副作用はありません。

---

Generated by Claude Code

Summary by CodeRabbit

• Documentation

  • アーキテクチャ決定記録（ADR-028）にPR本体の複数行対応に関する運用規範を追記しました。

• Chores

  • 完了済みタスクをタスク管理ドキュメントから削除し、リストを整理しました。

[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: a30a03dd-c4e7-4863-b8b7-145c8eaea1c2

📥 Commits

Reviewing files that changed from the base of the PR and between cd747b4 and efa896f.

📒 Files selected for processing (4)

• docs/adr/adr-028-pnpm-create-pr-gate.md
• docs/claude-code-web-tasks.md
• docs/todo-summary.md
• docs/todo9.md

💤 Files with no reviewable changes (3)

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

---

📝 Walkthrough

Walkthrough

ADR-028ドキュメントに「原則6」を追加し、PR body複数行時の--body-file推奨をcodify。対応するタスク管理ドキュメント（claude-code-web-tasks.md、todo-summary.md、todo9.md）から完了済みタスク記録を削除して同期。

Changes

ADR-028「原則6」の追加とタスク同期

Layer / File(s)	Summary
ADR-028「原則6」の追加と参照整備 docs/adr/adr-028-pnpm-create-pr-gate.md	ADR-028ドキュメントのステータス表記に2026-05-30の改訂を追記し、PR bodyが複数行の場合は--bodyのシェル引数直渡しを避け、スクラッチファイル経由で--body-fileを使うという原則6を追加。一次防衛memoryと根拠PR（#134、#181）への参照も併記。
タスク管理ドキュメントの同期削除 docs/claude-code-web-tasks.md, docs/todo-summary.md, docs/todo9.md	採用タスク表、todo-summary、todo9から、ADR-028補足追記タスク（順位166）の記録を削除し、タスク管理ドキュメント間の一貫性を保つ。

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

• aloekun/claude-code-hook-test#56: ADR-028の初版導入を行ったPRであり、本PRはその後続の原則6追加として関連。
• aloekun/claude-code-hook-test#182: PR #182がtodo-summary.md・todo9.mdに順位166のタスクを追加したのに対し、本PRがその同一タスク記録を削除しており、ライフサイクル管理で対応。
• aloekun/claude-code-hook-test#57: ADR-028のPR body処理ルール（--body-fileによる一時ファイル経由）を実装したPRであり、本PRはその運用規範をADRレベルで正式化。

🚥 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タイトルはADR-028に原則6を追加し、マルチラインPR bodyを--body-fileで渡すという主要な変更を明確に要約している。
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.}