Design Docs

Architecture write-ups and PR plans that survive a design review.

architecturespecplanning

Drafts a design document with problem, constraints, options, and a sequenced implementation plan.

Keeps the doc short enough to read in one sitting and specific enough to implement.

Includes open questions so reviewers know what still needs a decision.

Contract

Inputs. problem statement, constraints, existing systems.

Outputs. design doc, decision log, PR-sized work breakdown.