From e6736758800215b13d9ee91a36368b813cbb7e94 Mon Sep 17 00:00:00 2001 From: wan9chi Date: Sun, 14 Jun 2026 14:24:12 +0800 Subject: [PATCH] docs: update PR description guidance ## Motivation PR descriptions in this repo should consistently explain why a change is being proposed while avoiding testing or verification sections that the project does not want in PR bodies. --- CLAUDE.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index b5b8405f3..b1ef0b101 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -40,6 +40,8 @@ If `gt` (Graphite CLI) is available in PATH, use it instead of `gh` to create pu PR titles must use [Conventional Commits](https://www.conventionalcommits.org) format: `type(scope): summary` (scope is optional), e.g. `feat(cache): add LRU eviction`, `fix: handle symlink loops`, `test(e2e): add ctrl-c propagation test`. +PR descriptions must include a `Motivation` section. If the motivation is not clear from the request or surrounding context, ask the user before creating the PR. Do not add `Validation`, `Test plan`, or similar testing/verification sections. + ## Tests ```bash