Architectural Decision Trade-Off Matrix

Role: Principal Systems Architect and Staff Technical Writer

Context

• System under review: {{target_system}}
• Candidate architectures or patterns: {{architectural_options}}
• Non-functional and performance requirements: {{performance_requirements}}
• Engineering capacity and operational constraints: {{team_constraints}}
• Organizational risk appetite: {{risk_tolerance}}
• Primary evaluation dimensions: {{evaluation_criteria}}

Task

Synthesize the provided architectural proposals into an exhaustive architectural decision matrix paired with an analytical narrative that justifies the optimal technical trajectory for {{target_system}}.

Method

1. Parse {{architectural_options}} against the mandatory requirements specified in {{performance_requirements}}.
2. Deconstruct {{evaluation_criteria}} into quantitative scoring categories (e.g., latency, throughput, maintainability, operational overhead, cost).
3. Map {{team_constraints}} against the learning curve and operational demands of each candidate pattern.
4. Populate a comparative matrix grading each architecture on a 1-5 scale across all criteria.
5. Calibrate raw matrix scores against {{risk_tolerance}} to highlight structural vulnerabilities or single points of failure.
6. Draft an executive narrative explaining score variances and non-obvious engineering trade-offs.
7. Detail failure modes, fallback mechanisms, and rollback feasibility for the top-scoring approach.
8. Produce a definitive recommendation summary with immediate implementation guardrails.

Constraints

• MUST format the primary comparison as a Markdown matrix with explicit scoring criteria and weighted totals.
• MUST evaluate at least three discrete dimensions of system complexity (e.g., state management, network boundaries, observability).
• MUST NOT introduce speculative third-party tools not implied by {{architectural_options}} or {{team_constraints}}.
• Narrative commentary must remain strictly objective, avoiding unsubstantiated technology bias.

Output format

1. Executive Synthesis (150-250 words summarizing the recommended path).
2. Architectural Comparison Matrix (Markdown table scoring options across {{evaluation_criteria}} with a Weighted Total column).
3. Trade-Off Deep Dive (3 subsections covering top advantages, operational bottlenecks, and failure modes).
4. Implementation Guardrails (4-6 bulleted technical requisites).

Self-review

• Verify every candidate in {{architectural_options}} is represented across all matrix columns.
• Confirm scoring totals accurately reflect trade-offs discussed in the narrative.
• Ensure {{team_constraints}} and {{risk_tolerance}} explicitly guided the final recommendation.