ADHD PR説明文
このリポジトリのデフォルトPR本文フォーマット。 レビュアーは一目で説明を読み終えられるようにします。差分はすでにGitHub上にあるため、ファイルの移動を改めて記述しないでください。
エージェントは、NakamaのPR説明文を作成または書き換える際（ce-commit-push-pr 経由も含む）には、必ずこのスキルを読み込んでください。本文の形状はここから取得しますが、実際の主張（アウトカム、リスク、検証内容）は差分から収集してください。
形状（必須）
## Summary
<1行: 誰が何をして → どうなるか。変更内容が専門用語でない限り、専門用語による曖昧さは避ける。>
**Before:** <1行 — 以前の動作やコスト>
**After:** <1行 — 新しい動作。リスク評価に役立つ場合は、主要な関数やパス名を記載>
Why safe:
1. <理由>
2. <理由>
3. <理由> <!-- 最大2～3項目。言うことがなければ#3は削除 -->
Only re-add / follow up if <1つの残余リスクまたはロールバックのトリガー>。
## Test plan
- [x] <すでに実行したコマンド>（<N> pass）
- [ ] <人間が2分以内に実行できる手動確認1つ>
テスト計画の後にオプションとして（ワークフローがCompound Engineeringバッジを想定している場合、維持）:
---
[](https://github.com/EveryInc/compound-engineering-plugin)
ルール
- リード = アウトカム。 最初のSummary行は新しい世界を表し、「このPRは～を削除する」ではありません。
- Before/After = 2行。 ラベルは太字。段落で囲まない。
- Why safe = 番号付き、最大3つ。 本文全体の箇条書きは最大5つに制限。それ以上ある場合は、意思決定に影響するものだけを残す。
- 1つの残余リスク。 この変更を取り消すことになるケースを1つ挙げる。本当にない場合は省略。
- 差分の詮索禁止。 ファイル、行数、または「エクスポートも整理した」をストーリーとして列挙しない。ただし、それがリスクそのものである場合は除く。
- テスト計画 = 実行可能。 合格数を添えたチェック済みコマンドを優先。1つの未チェックの手動確認。
- タイトルは従来通り。
type(scope): imperative— 短く。本文がこの形状を持ち、タイトルに絵文字やエッセイは不要。 ghで適用。 本文を一時ファイルに書き込み、gh pr edit <n> --body-file …またはgh pr create --body-file …を使用。--body "$(cat …)"は使用しない。
ゴールデン例
この密度に一致させる:
## Summary
組織メモリの提案を承認 → バレットが `MEMORY.md` に追加される。LLM呼び出しなし。
**Before:** 決定論的マージ、その後オプションでファイル全体をモデルが書き換え。
**After:** 決定論的マージのみ（`applyApprovedOrgMemoryBullet`）。
Why safe:
1. 重複排除と置き換えは既にその関数内で動作中
2. LLMパスは既に決定論的結果にフォールバックしている
3. −230行、同じ承認結果
Only re-add an LLM rewrite if contradictory bullets start surviving approve.
## Test plan
- [x] `bun test packages/agent/src` (80 pass)
- [x] `bun test apps/server/src/services/org-memory-service.test.ts` (15 pass)
- [ ] 保留中の提案を1つ承認（固定 + 最近のログ）— バレットが以前と同様に追加されることを確認
アンチパターン
| やってはいけない | やるべきこと |
|---|---|
| 複数段落のSummary | 1行のアウトカム + Before/After + Why safe |
| 「このPRは～を目的としています」/「～するために」 | 動詞またはユーザーのアクションで始める |
Summaryの下にネストした### | フラットな## Summary + ## Test planのみ |
| 削除したファイルをすべて再度記述 | 残余リスクのみ |
| 曖昧な「テスト合格」 | 正確なコマンド + 合格数 |
ワークフロー
- PRの差分/コミットを読む（
gh pr view、git diff base...HEAD） - 名前: アウトカム、Before、After、最大3つのWhy-safe、1つの残余リスク
- テンプレートを埋める — 差分がすでに証明している文は削除
--body-fileで適用- PRのURLを返信（「タイトルを詰めてほしい場合は言ってください」は有用な場合のみ追加）