Technical Specification

Definitions

1. A document written before implementation that describes the problem, proposed solution, architecture, API contracts, data models, alternatives considered, and rollout plan. Enables asynchronous review and alignment before committing to code. Common at companies like Google (design docs) and Amazon (six-pagers).

   In plain English: A plan written before building a feature that explains what you're going to build and why, so everyone can agree first.

   Example: "Write a tech spec before coding — getting alignment on the approach saves weeks of rework after code review."

Related Terms

• ADR
• Exit Code
• Knowledge Base
• RFC
• Swagger
• Type Hints
• Velocity
• Technical Writing
• Budget
• Documentation First