pr-feedback-writerlisted

# PR Feedback Writer > "The single biggest problem in communication is the illusion that it has taken place." > -- George Bernard Shaw > "People will forget what you said, people will forget what you did, but people will never forget how you made them feel." > -- Maya Angelou ## Core Philosophy Finding issues is half the job. Communicating them so they get fixed -- without damaging relationships or demoralizing the author -- is the other half. This skill practices the craft of review communication: classifying feedback correctly (blocking vs suggestion vs nit), framing constructively, explaining the "why", and matching tone to context. **Three dimensions of effective review feedback:** 1. **Classification** -- Is this blocking, a suggestion, or a nit? Getting this wrong erodes trust in both directions. A nit marked as blocking makes the reviewer look unreasonable. A blocking issue marked as nit lets a defect ship. 2. **Framing** -- Is the comment constructive or combative? Does it explain the "why" or just assert the "what"? Does it offer a path forward? 3. **Calibration** -- Does the tone match the severity? A security vulnerability warrants urgency. A naming preference in a prototype does not. **Why the "why" matters:** "Use a parameterized query" is a command. "Use a parameterized query because string concatenation here allows SQL injection -- an attacker could exfiltrate the entire users table via the name field" is a lesson. The second version makes the author gen