TemplateDocs

Decision one-pager

A decision one-pager template: the question, options with trade-offs, your recommendation, what got ruled out and why, and sign-off.

Last updated

Fill in the blanks

Assembled in your browser — nothing you type is stored or sent anywhere.

Your document

# Decision: Should we build our own billing system or adopt a third-party platform? **Owner:** Finance & Platform (joint) · **Date:** 2026-09-04 ## Options A. Build in-house - full control and no per-transaction fee, but 4-5 months of engineering time and ongoing maintenance. B. Adopt Stripe Billing - live in 3 weeks, 0.7% transaction fee, but less flexibility on invoice customization. C. Adopt Chargebee - a similar timeline to Stripe, higher fee, but better support for our multi-currency needs. ## Recommendation Adopt Stripe Billing. The 0.7% fee is smaller than the fully-loaded cost of the engineering time Option A requires, and multi-currency is not yet a near-term need - if it becomes one, Chargebee stays on the table for a later migration. ## Ruled out Building in-house was ruled out: the 4-5 month timeline delays the Q4 pricing changes that depend on it, and billing is not a differentiator worth owning. Chargebee was ruled out for now on cost, with the door left open if multi-currency becomes urgent. ## Sign-off Approved by: ______________ (CFO) Date: ______________

How to use it well

  • →List every option you seriously weighed, including the one you didn't pick, with its real trade-off - a memo that only shows the winning option reads as a decision already made, not one being reviewed.
  • →Say what was ruled out and why in the same breath as the recommendation - it's usually the first question a stakeholder asks, and answering it up front heads off the memo becoming a re-litigation thread.
  • →A sign-off line only works if someone's name actually goes on it. A recommendation nobody is asked to approve tends to sit as a nice document rather than become a decision.

Part by part

# Decision: {{question}}
The title is the question, not the topic. It forces the document to be about something answerable rather than about an area.
## Recommendation
A stated position. A document presenting options without a recommendation moves the analysis to the reader, which is the work it was meant to do.
## Ruled out
Options considered and rejected, with reasons. It is what stops the same alternatives being raised in the meeting the document was supposed to shorten.
## Sign-off
Who decides and by when. Without it, a decision document is a discussion document and the decision is deferred by default.

Common mistakes

  • Presenting options with no recommendation.

    Reads as balanced and is an abdication — you have done the analysis and the reader has not. Neutral option papers reliably produce another meeting rather than a decision.

  • A title naming a topic rather than a question.

    Database strategy is a discussion; should we move billing to Postgres by Q3 is a decision. The title determines which meeting you get.

  • Omitting who signs off.

    Everyone assumes someone else will decide, and the document circulates until it is stale. Naming the decider and the date is what converts it into an event.

Questions

Is it wrong to have a recommendation?

The opposite — it is the point. You have done the work, so state what you think and why. A reader who disagrees now has something specific to argue with, which is a faster route to a decision than neutrality.

How does this differ from an ADR?

This is written before the decision to get one made; an ADR is written after, to record what was decided and why. Using this first and an ADR afterwards is the natural pairing.

What if the decider disagrees with the recommendation?

That is a good outcome — the document surfaced the disagreement with the reasoning visible. It is much better than a neutral paper where nobody discovers the objection until implementation.

Should the ruled-out section be detailed?

One line per option is usually enough. The purpose is to show the space was explored and to pre-empt re-proposals, not to relitigate each alternative in full.

Related in Templates