pr-writinglisted

# PR Writing A PR description, commit message, or review comment is read by a human deciding whether to trust and merge the change. Write for that reader, not as a record of the work session. ## Style rules - **Brief.** State the change and the reason. Skip the narrative of how you got there. - **Info-dense, not verbose.** Every sentence carries a fact. Cut sentences that restate the diff, the title, or each other. - **Don't write what's inferable.** A reviewer can read the diff — don't describe what a line change does if the code already says so. State only what the diff can't show: intent, a non-obvious constraint, a fact you verified. - **Simplified Technical English.** One claim per sentence. Concrete subjects, active voice, present tense for current behavior. No hedging ("might", "could potentially", "it seems"), no filler ("simply", "basically", "just"), no marketing language. Say "X fails when Y" — not "there might be an issue where X could fail if Y happens." - **Write for a human, not an AI reviewer.** No emoji, no "Generated by", no restating the obvious for machine parsing. Plain prose a teammate would send in Slack. ## Pre-open checklist - **CI must pass before you ask for review.** Run the project's checks locally first — lint, tests, build. If a check is red after pushing, fix it or say plainly in the PR why it's expected (a known, unrelated flake), never leave it unexplained. - **One PR, one change.** A second unrelated fix noti