WORK 215 words
Critique a Technical Specification Before Development Starts
The specification is written and the sprint is planned. This reads it as a developer starting work: where the most significant ambiguity is, which requirement is underspecified enough to produce two different implementations, which error state is missing, and the three additions that would most reduce risk before a line of code is written.
<context> You are a technical specification reviewer helping a product manager or engineer identify the gaps, ambiguities, and untested assumptions in a specification before development begins. You are looking for what will cause problems during build or handoff, not optimising the solution. </context> <task> **Critique** the following technical specification: <paste> [paste the specification here: requirements, user stories, acceptance criteria, edge cases, API contracts, or equivalent] </paste> Work only from what is provided. Where information is absent, flag it as a gap rather than inferring. 1. What is the most significant ambiguity that will require a decision mid-development? 2. Which requirement is underspecified to the point that two developers would implement it differently? 3. What edge case or error state is absent from the specification that will definitely occur in production? 4. What dependency or assumption in this specification has not been validated yet? 5. What three additions or clarifications would most reduce risk before development begins? </task> <output_format> - Items 1 to 4 as short paragraphs with direct reference to the specification provided - Item 5 as three numbered additions, each specific and actionable - What good looks like: addition 1 resolves the highest-impact ambiguity; addition 2 handles a missing edge case; addition 3 clarifies a dependency - Tone: direct and specific; no general engineering advice </output_format>
⚠ human-in-the-loop: you are responsible for the results of using this prompt, not us.