OrdoAnimi Architecture — Architecture Toolkit

← OrdoAnimi Architecture Framework

OrdoAnimi Architecture — Practitioner Toolkit

Architecture Toolkit

Templates · Diagrams · Governance · Patterns

Reusable solution architecture artefacts — Mermaid, C4, UML, data flow, trust boundary diagrams, and structured templates for AoAP, CSA, SAS, SAD, ADR, and TRA submission. Everything in this toolkit is tooling-agnostic and delivery-ready.

OrdoAnimi Architecture does not replace your diagramming tools.

This toolkit provides reusable solution architecture patterns, decision structures, and artefact templates. The diagrams are written in open formats — Mermaid and PlantUML — that render in any compatible tool. OrdoAnimi Architecture connects these artefacts to delivery governance, decision traceability, and TRA readiness.

Mermaid PlantUML C4 Model UML Lucidchart Visio Draw.io ArchiMate Orbus iServer GitHub Copilot

Engagement pathway — which artefacts, in which order

Pathway	When to use	Artefacts	Governance
Fast-Track	Low complexity, known domain, low risk	`AoAP`	Peer review or lead architect sign-off
Standard	Medium complexity or moderate risk	`AoAP` + `CSA`	Architecture Review Board — standard session
Full	High complexity, unfamiliar domain, or regulatory scope	`AoAP` + `CSA` + `SAS` + `SAD`	Architecture Review Board — full session
TRA-Ready	Full pathway + TRA submission required	All above + TRA package	ARB + TRA body submission

Toolkit — four capability areas

Engagement

Engagement Toolkit

Intake checklist and discovery framework. Use before producing any artefact. Surfaces the Current Intent Statement.

2 templates toolkit/engagement-toolkit/

Visual Modelling

Visual Modelling Toolkit

Mermaid and PlantUML diagram templates — C4, data flow, trust boundary, UML sequence, activity, deployment. Open format, tool-agnostic.

10 diagrams diagrams/

Architecture Artefacts

Artefact Templates

AoAP, CSA, SAS, SAD (TRA-ready), and ADR templates. Structured for ARB review and delivery governance.

5 templates templates/

Governance

Governance & TRA Toolkit

TRA readiness checklist mapped to ISM, PSPF, Privacy Act, and sector-specific obligations. Every unchecked item is a rejection risk.

1 checklist toolkit/governance-tra-toolkit/

Mermaid diagrams — open in any Mermaid-compatible tool

architecture-engagement-flow.mmd

Full engagement lifecycle — intake through to delivery handoff and architecture register. Shows all three complexity pathways and governance gates.

.mmd · Mermaid

c4-context-template.mmd

C4 Level 1 — System Context. Users, administrators, the core system, and all external dependencies. Replace bracketed placeholders.

.mmd · C4 Context

c4-container-template.mmd

C4 Level 2 — Container. Web app, API gateway, application service, worker, database, cache, event bus. Full interaction set included.

.mmd · C4 Container

data-flow-template.mmd

End-to-end data flow — external consumer through ingress, application, persistence, async/event, and observability layers.

.mmd · Data Flow

trust-boundary-overlay-template.mmd

Four-zone trust boundary overlay — External / DMZ / Application / Data / Admin. Security controls mapped to each zone boundary.

.mmd · Security

architecture-governance-flow.mmd

Architecture governance process — intake, triage, three ARB pathways, TRA decision branch, revise/resubmit loop, and delivery handoff.

.mmd · Governance

decision-to-delivery-traceability.mmd

Full traceability chain from CIS through AoAP → CSA → SAS → SAD → TRA, with ADR cross-references, ARB gate, and delivery backlog linkage.

.mmd · Traceability

PlantUML diagrams — open in PlantUML, IntelliJ, VS Code, or any compatible tool

sequence-diagram-template.puml

Full request/response sequence — user, frontend, API gateway, application service, database, external service, event bus. Happy path and two error paths included.

.puml · Sequence

activity-diagram-template.puml

Request processing activity flow — input validation, authentication, authorisation, business logic, parallel fork for event and persistence, error exits.

.puml · Activity

deployment-diagram-template.puml

Cloud deployment diagram — edge/perimeter, public subnet, application tier (auto-scaling), data tier (primary + replica + cache), platform services, admin/management plane.

.puml · Deployment

Architecture artefact templates — Markdown, structured for ARB and TRA submission

architecture-intake-checklist.md

Engagement intake checklist — scope, stakeholders, constraints, information state, risk, and artefact pathway decision. Use before any artefact is produced.

architecture-discovery-framework.md

Structured discovery questions for CIS development — organisational context, current state, decision inventory, risk, future state intent, and the blank cell test.

.md · Discovery

architecture-on-a-page-template.md

AoAP template — one-line statement, context, scope, stakeholders, current and target state, component summary, integrations, decisions, risks. Fast-track and standard pathway.

conceptual-solution-architecture-template.md

CSA template — logical architecture, component interactions, integration surface, security architecture, resilience, observability, decisions, open issues.

solution-architecture-summary-template.md

SAS template — executive summary, what is being built, decisions made, open questions, key risks, dependencies, compliance posture, delivery pathway, and the ask.

sad-tra-ready-template.md

Full SAD structured for ARB review and TRA submission — business context, architecture overview, integration, security, resilience, decisions, risk register, compliance posture, TRA readiness summary.

.md · SAD / TRA

architecture-decision-record-template.md

ADR template — context, decision, rationale, three options with pros/cons, consequences (positive and trade-off), compliance notes, review conditions, artefact update checklist.

tra-readiness-checklist.md

TRA submission readiness checklist — 10 sections covering system description, security architecture, IAM, data management, vulnerability management, resilience, observability, supply chain, compliance, and documentation completeness.

Toolkit to module mapping

Module 01 — Orientation

Use: architecture-intake-checklist. Identify engagement archetype before selecting artefact pathway.

Module 02 — Intelligence

Use: architecture-discovery-framework. Build the Current Intent Statement. Run the blank cell test.

Module 03 — Design

Use: AoAP, CSA templates + Mermaid C4 and data flow diagrams. Produce the logical design.

Module 04 — Artefacts

Use: SAS, SAD, ADR templates + all diagram templates. Produce the full artefact set for governance.

Module 05 — Communication

Use: SAS as the stakeholder communication artefact. Use governance flow diagram for ARB briefings.

Module 06 — Velocity Loop

Use: decision-to-delivery-traceability diagram. Update ADRs and architecture register each cycle.