# 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]
