Close the gaps before you build

Fill documentation gaps until requirements, technical design, acceptance criteria, and test strategy describe one buildable system.

Use this when

Use this before building a new software project when its idea or early documents still leave important implementation decisions open to interpretation.

How it runs

1. Inventory the current project documents and identify the missing requirements, technical design, task breakdown, acceptance criteria, or test strategy needed before implementation.
2. Find the single largest gap, contradiction, or vague requirement that could make competent engineers build different systems, then close it with concrete detail traceable to a stated requirement.
3. Record assumptions that can be made safely, ask the user about genuine product forks, and recheck every edited document against the others for consistency.
4. Have two independent reviewers describe the intended components, data model, dependencies, and definition of done; repeat until their descriptions materially agree or a required decision blocks progress.

Done when

✓ Two independent reviewers derive substantially the same build from the project documents. Their descriptions agree on the components, data model, dependencies, and definition of done, and every required artifact is specific, consistent, traceable, and testable.

Why it works

A concrete convergence test exposes ambiguity that a single author may read past. Fixing one divergence at a time keeps the documents coherent and turns project preparation into evidence that another engineer can follow rather than a pile of planning text.

Implementation note

Do not add detail merely to make the documents longer or invent product requirements to force agreement. Keep every claim tied to a stated requirement, record assumptions, and return unresolved product choices to the user.

Source: Forward Future ↗graded C · 55/100 — how grades work →

More docs loops