← Back to templateTechnical proposalEditable copy on this deviceDownload MarkdownEdit your copy in Markdown# 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]