← More templates

Technical proposal template

By Kivrelune Studio

Technical proposal

Technical proposal

Give reviewers enough context to choose an approach and tell whether it worked.

Problem and scope

Proposal: [short title]
Author and reviewers: [names]
Decision due: [date]
Today [user or system] experiences [measured problem] when [condition].
In scope: [boundary]
Out of scope: [adjacent work]

Design choice

Proposed approach: [main change and affected components]
Alternative considered: [approach and trade-off]
Evidence: [measurement, test or prior decision]
Example: Cache the weekly summary for ten minutes. A live query is fresher, but an unchanged summary currently triggers the same aggregation for every opening.

Rollout and decision

  • Trial with [small cohort] for [period].
  • Compare [signal] against [baseline and threshold].
  • Roll back by [reversible action] if [condition].

Decision: [proceed, revise or defer] · Owner: [name] · Date: [date]

Using this template

Document the measured problem and compare a proposed engineering approach with a credible alternative on the same evidence. Ask reviewers to agree on a bounded trial, success signal and reversible rollout decision before authorizing the wider change.

Download Markdown

Questions & answers

Looking for more help? Visit the Help center.

How do we make a technical trade-off understandable to a nontechnical sponsor?

Describe the effect on users, operating effort or cost and attach the engineering evidence. Present the alternatives against the same success measure and state the decision required.

What is included in this template?

Problem and scope · Design choice · Rollout and decision. Each section includes prompts you can adapt to your team.

How can the project team keep this current?

Give each open decision an owner and a due date. At the next checkpoint, update the milestone and record the work that changed since the last review.

How do I use my own copy?

Choose “Start with this doc” to open an editable copy on this device. You can also copy the Markdown or download the file and use it in your own editor.

A shared library for your team
and the AI they work with.