Tag: architecture decision record

Claiming Architectural Reality, Part I — ADRs That Find You at Change-Time

This article opens a three-part series on Claiming Architectural Reality — an effort to make architectural knowledge living, contextual, and actionable.

  • Part I introduces the Architecture Decision Record Scanner pre‑commit hook — a simple way to keep architectural decisions visible and accessible inside the codebase.
  • Part II explores pairing ADRs with architecture fitness tests to ensure architectural integrity through CI/CD.
  • Part III focuses on AI‑assisted discoverability and validation to surface relevant ADRs and detect drift early.

Together, these parts outline a path from static documentation toward architecture that reacts, informs, and evolves with the system.

→ Jump to the Practical Application

Continue reading “Claiming Architectural Reality, Part I — ADRs That Find You at Change-Time”