Skip to content

Architecture Options And Decision Matrix

Purpose: compare architecture options with weighted quality attributes before making a technical direction decision.

Use this section by itself when the team needs to decide agent roles, write boundaries, reversibility, or implementation paths.

Inputs

  • Current-state discovery.
  • Candidate architecture options.
  • Quality attributes and weights.
  • Data exposure.
  • Tool permissions.
  • Reversibility.
  • Validation strength.
  • Team skill and operating constraints.

Outputs

  • Option comparison.
  • Weighted decision matrix.
  • Selected direction.
  • Rejected options and rationale.
  • Read/write boundaries.
  • Recovery path.
  • Human review model.

Agent Task Contract

Compare options using maintainability, modularity, security, testability, delivery speed, scalability, operational simplicity, team skill fit, agent compatibility, client fit, cost control, and risk reduction. End with unresolved risks and required local reviewers.

Help update architecture options, rejected-option rationale, read/write boundaries, and review gates when the design changes. Keep human review and acceptance explicit.

Do not turn a recommended option into a production approval.