Skip to content

Commit 3facd36

Browse files
kim-emclaude
andauthored
chore: forbid process narrative in PR descriptions in CLAUDE.md (#14997)
This PR adds a note to .claude/CLAUDE.md that PR descriptions should describe the change as it stands, without narrating how it was developed or verified. 🤖 Prepared with Claude Code Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent 0f52346 commit 3facd36

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

.claude/CLAUDE.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,8 @@ Subject should use imperative present tense ("add" not "added"), no capitalizati
113113

114114
**Body format:** The first paragraph must start with "This PR". This paragraph is automatically incorporated into release notes, so keep it short, focus on user-side impact, and avoid implementation-specific wording. Save the implementation details for a follow-up paragraph. Use imperative present tense. Do NOT use markdown headings (`## Summary`, `## Test plan`, etc.) in PR bodies.
115115

116+
**No process narrative:** Describe the change as it stands. Do not narrate how it was developed or verified ("validated locally against nightly X", "relying on CI for the full build", what earlier drafts did).
117+
116118
**Line wrapping:** Do NOT hard-wrap lines in commit messages or PR descriptions. Write each paragraph as a single line and let display tools (GitHub, `git log`, terminals) soft-wrap. Bullet lists are still fine; just keep each `* item` body on one line.
117119

118120
Example:

0 commit comments

Comments
 (0)