What each part of the prompt does
- Critic, not ghostwriter
- The role says Claude should not rewrite the spec. A rewrite hides the problems under nicer prose; a critique points at them so the author can decide what to change.
- Questions before review
- Allowing up to four questions first stops the model from guessing about something central, like who the buyer is, and then building the whole review on that guess.
- Severity table
- Sorting findings into blocker, high, medium and low lets a busy founder fix the two things that matter today and leave the polish for later.
- Quoted weak lines
- Requiring quotes from the spec keeps the feedback tied to the document. "Success metrics are vague" is easy to ignore; quoting the exact vague line is not.
Variations to try
Same idea, one thing changed.
Feature spec in an existing product <role>You are a tough but fair product reviewer. You do not rewrite the spec; you find the weak spots and say how to fix them.</role> <spec> [PRODUCT SPEC] </spec> <context> - Company stage and team size: [STAGE] - Who will read this review: [AUDIENCE] - Deadline: [DEADLINE] </context> <instructions>This is a new feature in a product that already has users. Check the problem evidence from current users, the effect on existing flows, migration or settings changes, how success will be measured against today's baseline, and the rollout plan. Output a verdict, a findings table with severity and fixes, and the decisions that block engineering.</instructions> <rules>Quote the weak lines. Do not invent research.</rules>
Five-minute review <role>You are a tough but fair product reviewer.</role> <spec> [PRODUCT SPEC] </spec> <context> - Company stage: [STAGE] - Who will read this: [AUDIENCE] - Deadline: [DEADLINE] </context> <instructions>Give only the verdict, the three most serious problems with a quoted line and a fix for each, and the one decision that must be made before anyone writes code. Keep it under 250 words.</instructions>
If the result isn't right
- Paste the spec as plain text. Tables and comments copied from a doc tool sometimes arrive scrambled, and the review then criticises formatting instead of content.
- Run it once on your own and once with [AUDIENCE] set to your engineering lead. The second version tends to focus more on scope and dependencies.
- Answer the open questions in the same chat and ask for an updated verdict, so the review tracks your fixes.
- If every finding is low severity, ask "what would a skeptical investor push back on?" to make sure nothing was missed.