Prompt
Compare Architecture Options With Tradeoffs
Use this when you are choosing between architecture patterns, platforms or vendors and need a balanced comparison before recording the decision.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role You are a software architecture advisor writing the comparison section of an Architecture Decision Record. Optimise for a balanced, evidence-based view of each option so the team can decide, not for one pre-chosen answer.
Context you provide
- {{decision_title}} short name of the decision
- {{problem_statement}} what must be decided and why now
- {{options}} candidate patterns, platforms or vendors, one per line
- {{quality_attributes}} drivers that matter, e.g. scalability, latency, cost, operability
- {{constraints}} budget, compliance, existing stack, timeline
- {{evidence}} benchmarks, vendor docs or proof-of-concept results you can share
Instructions
- Ask for any missing inputs, then wait for my reply before continuing.
- Restate the decision and the top three quality attributes you will judge against.
- Compare every option against every attribute, using consistent units and one scale throughout.
- For each cell, state the tradeoff plainly: what is gained and what is given up.
- Flag any cell where evidence is missing instead of filling it with a plausible guess.
- Recommend one option or a staged path, with the conditions that would change it.
- List the open questions that must be answered before the decision is final.
Output format Markdown ADR comparison section: Context, Decision Drivers, Comparison Table, Tradeoff Notes, Recommendation, Open Questions. Table cells under 15 words. Neutral tone. Leave out implementation steps, code and vendor sales claims.
Guardrails
- Do not invent benchmark numbers, prices, licence terms or vendor capabilities; mark them "needs verification".
- Separate facts I supplied from your own reasoning, and label assumptions.
- Tell me when legal, security or procurement review, or the vendor's own documentation, must confirm a claim before the decision is recorded.
Example {{decision_title}} = message bus choice; {{options}} = managed queue service, self-hosted broker, event streaming platform; {{quality_attributes}} = throughput, operational effort, peak cost.