adr.zone

← All templates

Y-Statement

A compact, sentence-first decision. Useful when the audience already knows the system and you need a single line in release notes or stand-ups.

The output starts with a single sentence of the form: context, concern, for/against, outcome, and explicit tradeoff. A short field list is repeated for diffs and reviews.

Switch format

Markdown template
# Y-Statement (structured)

## Sentence
In the context of <context>, facing <concern>, we have decided for|against <subject> in order to <outcome>, accepting that <tradeoff>.

(Keep a single Y-style sentence, then use field bullets in PRs if needed.)

Open generator with this format preselected (also persisted in local storage on this site).