Architecture Templates
Ready-to-use architecture document templates: Integration Contract Records (ICR), Architecture Decision Records (ADR), Reference Architectures and Solution Architecture Designs (SAD). Each comes with a worked example from one fictional system, and downloads as Markdown or Word.
See it all together: the Appointment Booking worked example
One fictional system, documented end to end with records like these: 14 requirements, 7 decisions, a solution architecture design, 3 interface contracts, and a running demo with an automated test for 20 of the contracts' 23 acceptance criteria. See how the records connect on one page.
4 templates
Integration Contract Record (ICR) Template
A Markdown template for the agreement behind one integration between systems: purpose and parties, the pattern and its interaction flows, the interface specifications it relies on, data, security, service levels, error handling, change and support, and testable acceptance criteria. Written so a reviewer, an operator or an AI coding agent can act on it. Version 0.2 of the format, a draft.
Includes a worked example
Architecture Decision Record (ADR) Template
A Markdown Architectural Decision Record on the MADR 4.0.0 standard, extended with an options evaluation matrix, principle alignment and governance fields for architecture review.
Includes a worked example
Reference Architecture Template
A structure for documenting a reference architecture: scope and principles, layers of product-neutral components with example implementations, the patterns and decisions behind them, and a lifecycle roadmap.
Includes a worked example
Solution Architecture Design (SAD) Template
A comprehensive template for documenting end-to-end solution designs: stakeholders and quality goals, requirements and decisions, context, components and runtime behaviour, data design, security, deployment, risks and a glossary.
Includes a worked example