A good technical specification is the cheapest place to catch a mistake — far cheaper than catching it in code review or production. But specs are often skipped or written so loosely that they settle nothing. This builder turns your requirements into a prompt that produces a complete, reviewable specification with the sections that actually prevent rework.
How it works
You describe the feature and its functional and non-functional requirements, plus the technical constraints the design must respect. You choose the audience — engineers, stakeholders, or both — and a format: a full spec, an RFC-style design proposal, or a one-page brief. The builder wraps this in a prompt that tells the model to act as a senior engineer and produce a structured document: overview, requirements, proposed design, alternatives considered, risks, acceptance criteria, and explicit out-of-scope. Copy it, run it, and answer the clarifying questions it asks.
What makes the spec rigorous
The prompt enforces the discipline that separates a real spec from a wish list. Requirements must be testable, not “should be fast.” Non-functional targets carry concrete numbers. The design must name a considered alternative and explain the trade-off, so reviewers can challenge the choice. Risks and open questions are surfaced rather than buried, and acceptance criteria are written in given/when/then form so done is unambiguous. Crucially, the model is told to list gaps as open questions rather than invent answers.
Tips for better output
- Separate the what from the how. Give the model clear requirements and constraints; let it propose the design. Pre-deciding the implementation undercuts the alternatives section.
- Lean on the open questions. The list the model returns is a checklist of decisions your team still needs to make — resolve them before building, not during.
- Guard against over-engineering. The prompt asks for the simplest design that meets the requirements and invites the model to question any requirement that looks unnecessary. Take that prompt seriously in review.