PhraseryPhrasery homeGet Phrasery
Design & UX21 categories

Write up the rationale for this design decision

Documenting a decision before everyone forgets why it was made.

Longrationalewritingdecisions
Write a design rationale for the decision below, aimed at someone who joins the team in a year and asks why it is like this.

Sections:
- **Decision**: one sentence, present tense.
- **Problem**: what the user was struggling with, and the evidence if we have any.
- **Options considered**: each with its honest upside, not a strawman.
- **Why this one**: the trade we knowingly accepted.
- **What we gave up**: name it plainly.
- **Revisit if**: the specific signal that should make us change this.

Keep it under a page. Do not claim evidence we do not have. Where the real reason was a constraint such as time, scope, or a technical limit, say that outright rather than dressing it up as user research.

Decision:
Context:

Making it yours

  • Paste your own material where the prompt asks for it. Everything above that line is instruction, not content.
  • Delete any rule that does not apply to you. A shorter prompt that fits beats a thorough one that does not.
  • If the answer comes back vague, add a line saying what you do not want. Constraints work better than encouragement.

Briefs and decisions. The work around the design: turning a request into a brief, choosing between options, writing down why.

Related prompts

Keep this one

Phrasery saves prompts with a right-click and puts them back the same way. Add this to your own library in one click.

Add to your browser โ€” free