Complete AI Training

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

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. Use the follow-ups below to go deeper.
Prompt

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

  1. Ask for any missing inputs, then wait for my reply before continuing.
  2. Restate the decision and the top three quality attributes you will judge against.
  3. Compare every option against every attribute, using consistent units and one scale throughout.
  4. For each cell, state the tradeoff plainly: what is gained and what is given up.
  5. Flag any cell where evidence is missing instead of filling it with a plausible guess.
  6. Recommend one option or a staged path, with the conditions that would change it.
  7. 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.