WA Government Architecture Decision Records

Reusable architecture patterns for WA Government digital services, maintained by the Office of Digital Government (DGOV) Digital Transformation and Technology Unit (DTT).

For WA Public Sector Agencies

These patterns help you build secure, compliant digital services faster. Instead of starting from scratch, use proven approaches that align with WA Government security and compliance requirements.

Getting Started

1. Review the Architecture Principles - Six guiding principles for all technology decisions
2. Choose a Reference Architecture - Project kickoff templates combining multiple decisions:
   • Content Management - Websites, intranets, and content portals
   • Data Pipelines - Analytics, reporting, and data processing
   • Identity Management - User authentication and single sign-on
   • OpenAPI Backends - Backend services and integrations
3. Check the Compliance Mapping - Find which ADRs apply to your security and compliance requirements

Compliance Alignment

These ADRs align with:

• WA Cyber Security Policy
• ACSC Information Security Manual (ISM)
• WA Government AI Policy and Assurance Framework

Supporting training: DGOV Technical - DevSecOps Induction

Browse online | Download PDF

Contributing

New ADRs document the context (problem), decision (solution), and consequences (trade-offs). See the Contributing Guide for workflow and templates.

For AI agent assistance, see AGENTS.md.

Repository Structure

This project uses mdBook to generate documentation:

• development/, operations/, security/ - ADRs by domain
• reference-architectures/ - Project kickoff templates
• SUMMARY.md - Navigation structure

just setup    # One-time tool installation
just serve    # Preview locally (port 8080)
just build    # Build website and PDF