Solution Architects Club · Practical tool · English

Turn an architecture review into an owned decision

A decision record connects a proposal to its alternatives, evidence and accountable owner. Use a blank worksheet or inspect a fictional partial-payment example before writing your own draft.

Free to explore. Worksheet inputs stay in this browser tab; no account or paid API is required.

Conceptual title illustration for Solution Architects Club
Conceptual title image. Any real observation data is identified separately below.

A review question, not a decoration

Consider an order service that times out after the payment provider may already have authorised a charge. The useful question is how to determine the business state before retrying. The diagram below describes the review path; it does not assert that any option is suitable for your system.

Partial-payment decision branchesAn uncertain payment response branches to blind retry, query state with the original transaction key, or manual reconciliation. Each option requires explicit evidence and ownership.UnknownBlind retryQuery original stateReconcile manuallyDuplicate effects?Stable transaction key?Owner and time boundary?

Draft an architecture decision record

Nothing entered here is transmitted. The sample is fictional and remains unapproved; loading it does not overwrite any server-side record.

Blank Markdown template

No decision has been approved or submitted.

Use the record in a real review

Evidence prompts to complete with the team
ConcernQuestionEvidence to bring
FailureWhat happens after a partial success?Worked failure sequence, duplicate-effect behaviour and retry rules.
PermissionsWho can read, change or restore the state?Permission boundary and a negative-access test.
RecoveryHow is business state reconciled?Recovery rehearsal and an accountable restart decision.
OperationsWho will know that the design is failing?Signals, runbook, ownership and escalation route.

The Club provides open professional-practice resources. A commercial architecture review or delivery enquiry is handled by MGCA Ltd; a worksheet export is not a contract, approval or assurance certificate.

Take the next step with context

Keep the question, assumptions and evidence together. These tools help organise a review; an exported record does not approve a design or certify a system.