Feature spec
The full-lifecycle template: problem, scope, acceptance criteria, plan, task breakdown. For any new capability worth building carefully.
Open template
Template gallery · 6 sheets
Spec templates
Every template below is a real, usable starting point — not a sketch. Each page walks through the sections with annotations explaining why each one exists, and every page ends with a one-click copy of the raw template.
API spec
Endpoints, schemas, error contracts, versioning, and consumer impact. For any interface another team — or agent — will build against.
Open templateBugfix spec
Reproduction, root-cause hypothesis, fix strategy, and regression tests. Turns "fix the bug" into an investigation with a paper trail.
Open templateMigration spec
Schema changes, backfill strategy, dual-write windows, and rollback criteria. For data and system migrations where failure is not an option.
Open templateRefactor spec
Current-state analysis, target design, behavior-preservation guarantees, and staged rollout. Refactors that don't change behavior — provably.
Open templateArchitecture decision record
Context, options considered, decision, and consequences. The lightest spec in the gallery — and the one future you will thank you for.
Open template
How to use the gallery
Pick the template closest to your work, copy it, and fill in every section — deleting a section is fine, skipping one silently is not. Each template's page explains what each section is for and what good looks like. When your team outgrows these, the template marketplace will carry community-reviewed packs for specific stacks and domains.