Architecture Decision Record

Step 1: Understand the decision

Ask the user:

What architecture decision do you need to document? Please share:

• Decision title (e.g., "Switch from SQS to EventBridge for event routing")
• Context — What problem are you solving or what change are you making?
• Options considered (at least 2) — or ask me to suggest alternatives

If the user has already described the decision, proceed directly.

IMPORTANT: When you are in a codebase, ALWAYS analyze the code first to ground the ADR in implementation reality. When no code is available, proceed with the verbal description but mark implementation sections as "Verify against code."

Step 2: Current State Discovery

Analyze the codebase to understand what exists today.