New architecture decision record

Complete the sixteen sections of the Tyree & Akerman template; completeness and flags are computed on submit, and the report renders a commit-ready Markdown ADR.

  1. Author
  2. Org
  3. Issue
  4. Decision
  5. Status
  6. Assumptions
  7. Constraints
  8. Positions
  9. Argument
  10. Implications
  11. Decisions
  12. Requirements
  13. Artifacts
  14. Principles
  15. Notes
  16. Sign-off

Step 1 — Author identification

Who is writing this ADR.

Step 2 — Organization & context

The organization context for the decision.

Step 3 — Issue

Tyree & Akerman §1: the architectural design issue being addressed; explain why now.

Step 4 — Decision

Tyree & Akerman §2: the position chosen, stated clearly.

Step 5 — Status & group

Tyree & Akerman §3 & §4: workflow status and architectural category.

Step 6 — Assumptions

Tyree & Akerman §5: environmental factors influencing the decision (cost, schedule, technology).

Step 7 — Constraints

Tyree & Akerman §6: environmental limits imposed by the decision.

Step 8 — Positions (alternatives)

Tyree & Akerman §7: viable alternatives considered. Mark exactly one as chosen.

Position 1

Step 9 — Argument

Tyree & Akerman §8: rationale for the chosen position over the others (cost of implementation, ownership, time-to-market, resourcing).

Step 10 — Implications

Tyree & Akerman §9: consequences, follow-on decisions, scope/schedule impact, training requirements.

Step 11 — Related decisions

Tyree & Akerman §10: other ADRs this depends on, supersedes, or is superseded by. One per line.

Step 12 — Related requirements

Tyree & Akerman §11: business or functional requirements addressed. One per line.

Step 13 — Related artifacts

Tyree & Akerman §12: designs, models, scope documents impacted. One per line.

Step 14 — Related principles

Tyree & Akerman §13: enterprise principles this aligns with or breaks. One per line.

Step 15 — Notes

Tyree & Akerman §14: discussion log captured during socialisation. Append-only; each note is timestamped.

No notes yet. Add one as you socialise the decision.

Step 16 — Summary & sign-off

Confirm sign-off. The next button generates the Markdown ADR.