Tools & Templates
Templates give you a proven structure to copy and fill in. Tools let you start from the reference architectures and integration patterns on this site and shape the result to your organisation. Where a template and a tool produce the same thing, they link to each other.
See it all together: the Appointment Booking worked example
One fictional system documented end to end: 14 requirements, 7 decisions, a solution architecture design, 3 interface contracts and a running demo.
Tools
ICR Builder
Write an integration contract record, step by step, and check it as you go
Choose how two systems exchange data and, if you like, one of the integration patterns on this site, and the builder prefills the interaction type and the security, service-level and error-handling prompts. Work through the front matter and the 17 sections with guidance on each; a live checklist applies the conformance rules of the ICR specification (v0.2, a draft); a flow helper drafts the Mermaid sequence diagram with its accessible title and description. Export the record as markdown, or open an existing one to edit.
Good to know about the ICR Builder
Choose how two systems exchange data and, if you like, one of the integration patterns on this site, and the builder prefills the interaction type and the security, service-level and error-handling prompts. Work through the front matter and the 17 sections with guidance on each; a live checklist applies the conformance rules of the ICR specification (v0.2, a draft); a flow helper drafts the Mermaid sequence diagram with its accessible title and description. Export the record as markdown, or open an existing one to edit.
- Starts from the integration patterns on this site and keeps the pattern's controls referenced, not copied
- The checklist applies the ICR's conformance rules (specification v0.2, a draft) as you type
- Your draft stays in your browser and nothing is sent to us; drawing a diagram fetches the diagram library from a public CDN
- Designed for desktop screens, with a usable tablet layout
Strategy Modeler
Build your own reference architecture and technology strategy
Start from the Integration, Data Platform or Security reference architecture and make it yours: define the people it serves and what they need to do, adjust the layers and components, and map each component to the products you use with a lifecycle status — strategic, tactical or decommission. Export the result as JSON, a Word document or a PDF.
Good to know about the Strategy Modeler
Start from the Integration, Data Platform or Security reference architecture and make it yours: define the people it serves and what they need to do, adjust the layers and components, and map each component to the products you use with a lifecycle status — strategic, tactical or decommission. Export the result as JSON, a Word document or a PDF.
- Starts from the reference architectures on this site, kept in step with them
- Your work stays in your browser — nothing is sent to us
- Designed for desktop screens
Templates
Records for decisions, designs, reference architectures and, for the integration architect, the Integration Contract Record: the agreement behind one integration, with its owners, service levels, error handling and testable acceptance criteria. Each template has a worked example.
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.
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.
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.
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.