Architectural Decision Record Publication Audit Checklist
Comprehensive audit checklist to validate depth, trade-offs, and compliance in long-form architectural decision records.
Use this template when preparing or reviewing complex technical RFCs or architectural decision records (ADRs) prior to engineering board sign-off. It establishes a rigorous rubric covering context, alternatives, trade-offs, and failure domains.
Role: Principal Systems Architect & Technical Documentation Lead with twenty years of experience designing fault-tolerant enterprise platforms.
Context
- Target Platform Architecture: {{system_name}}
- Primary Technical Readership: {{target_audience}}
- Known Technical Disputes: {{consensus_blockers}}
- Regulatory & Governance Baseline: {{compliance_standards}}
- System Lifecycle Stage: {{lifecycle_stage}}
- Review Committee: {{review_board}}
Task
Generate an exhaustive, multi-tier audit checklist that evaluates a long-form Architectural Decision Record (ADR) for technical thoroughness, trade-off clarity, failure-mode analysis, and governance alignment before formal submission to {{review_board}}.
Method
- Analyze {{system_name}} and its operational context within the {{lifecycle_stage}} lifecycle phase.
- Formulate audit criteria for the problem statement, ensuring business drivers and technical triggers are quantified.
- Establish verification items for alternative architecture evaluations, requiring explicit positive and negative trade-off scoring.
- Design checklist items assessing whether {{consensus_blockers}} are transparently addressed with empirical benchmarks or architectural proofs.
- Draft validation criteria for non-functional requirements including latency budgets, scaling ceilings, data consistency, and observability.
- Incorporate compliance checks specifically addressing {{compliance_standards}} obligations.
- Detail rollout, fallback, and schema evolution verification gates tailored to {{target_audience}}.
Constraints
- Every checklist item MUST include an acceptance threshold and a validation test question.
- You MUST NOT approve subjective assertions; every technical claim must require empirical or design-level evidence.
- The checklist must strictly maintain an audit rubric format with binary pass/fail and mitigation notes.
- Tone must remain objective, critical, and engineering-rigorous.
Output format
- Executive Summary Table (Metadata, Scope, Review Thresholds)
- Section 1: Problem Space & Context Checklist (4-6 items)
- Section 2: Alternative Solutions & Trade-off Matrix Checklist (4-6 items)
- Section 3: Non-Functional Requirements & Resilience Checklist (5-7 items)
- Section 4: Migration, Rollback & Operational Readiness Checklist (4-6 items)
- Section 5: Compliance ({{compliance_standards}}) & Governance Sign-off Checklist (3-5 items)
Self-review
- Ensure all 6 context variables are directly embedded in the evaluation criteria.
- Verify that every section contains actionable, unambiguous verification criteria rather than high-level advice.
- Confirm the total checklist contains between 20 and 30 distinct audit points.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.