ADR Template

  • Status: {Active | deprecation reason, e.g. "Superseded By xxx"}

  • Last Modified: {YYYY-MM-DD when the decision was last updated}

  • Related Issue: [#{issue number}](https://github.com/HHS/simpler-grants-gov/issues/{issue number})

  • Deciders: {list everyone involved in the decision}

  • Tags: {space and/or comma separated list of tags}

Context and Problem Statement

{Describe the context and problem statement, e.g., in free form using two to three sentences. You may want to articulate the problem in form of a question.}

Decision Drivers

  • {driver 1, e.g., a constraint, priority, condition, etc.}

  • {driver 2, e.g., a constraint, priority, condition, etc.}

  • ...

Options Considered

  • {option 1}

  • {option 2}

  • ...

Decision Outcome

Chosen option: "{option 1}", because {justification. e.g., only option which meets a key decision driver | which satisfies x condition | ... }.

Positive Consequences

  • {e.g., improved performance on quality metric, new capability enabled, ...}

  • ...

Negative Consequences

  • {e.g., decreased performance on quality metric, risk, follow-up decisions required, ...}

  • ...

Pros and Cons of the Options

{option 1}

{example | description | pointer to more information | ...}

  • Pros

    • Good, because {argument a}

    • Good, because {argument b}

    • ...

  • Cons

    • Bad, because {argument c}

    • ...

{option 2}

{example | description | pointer to more information | ...}

  • Pros

    • Good, because {argument a}

    • Good, because {argument b}

    • ...

  • Cons

    • Bad, because {argument c}

    • ...

  • [{Link name}](link to external resource)

  • ...

Last updated