Public preview

Architecture Decision Records Archive

Each major decision: context, options, decision, consequences — one page, sequential.

50 min Advanced

Goal

Prevent "why did we decide this last year? forgotten" — institutional memory.

Steps

1

Identify major past decisions (6 mo).

5 more steps locked

Expected Outcome

Immediate

You find 2 old decisions whose context you forgot.

Evidence base

School: 12-Factor / Architecture Decision Records

Founders: Michael Nygard · Adam Wiggins (2011)

Nygard — Cognitect blog 2011 "Documenting Architecture Decisions" introduced ADR; Wiggins (Heroku) — 12-Factor App popularized structured docs.

Frequently asked questions

How long does "Architecture Decision Records Archive" take?

This exercise takes about 50 minutes, practiced solo in a Action format.

When will I notice the effect of "Architecture Decision Records Archive"?

You find 2 old decisions whose context you forgot. In the short term: In 6 months, "why did we do this?" recall in seconds.

Is "Architecture Decision Records Archive" evidence-based?

Yes — it draws on 12-Factor / Architecture Decision Records (Michael Nygard, Adam Wiggins (2011)). Nygard — Cognitect blog 2011 "Documenting Architecture Decisions" introduced ADR; Wiggins (Heroku) — 12-Factor App popularized structured docs.

Is "Architecture Decision Records Archive" suitable for beginners?

Its difficulty level is: Advanced. No external tools required — it can be practiced directly inside the app.

Subscribe for full access

Subscribe to Plus for full access to this practice and the whole catalogue, or try first — free, no sign-in, no commitment.

Interactive practice locked · 5 more steps locked

7 complete practices (one per domain) are free forever, no sign-in.