researching-options-and-decisions

Document architecture decisions by gathering context, reviewing existing ADRs, and evaluating two to four options side-by-side. This produces a structured comparison table covering cost, effort, and risks, ending with a clear recommendation and tradeoff statement.

Evaluating architecture tradeoffs requires comparing viable choices across cost, maintenance, and risk dimensions. A structured option analysis surfaces roadmap impacts and ADR conflicts before implementation begins, ensuring every design path is fully understood.

Create an option comparison table by analyzing two to four implementation strategies against criteria like effort, cost, and maintenance. This structured decision framework captures context research and yields a documented recommendation with explicit tradeoffs.

A decision framework supports idea vetting and roadmap impact analysis by documenting discovery and comparing alternatives. It captures the resulting ADR, task queue updates, and chat logs after approval to maintain full recommendation traceability.

Use structured option analysis when teams debate adopting new patterns or face roadmap-impacting decisions. It stops ad hoc architecture choices by enforcing context research, risk assessment, and a confirmation step before implementation proceeds.

The decision documentation workflow captures updates in the Architecture and Decisions doc, roadmap, and task queue after approval. This ensures full traceability of the recommendation and preserves the resulting tasks for implementation.