architecture

You can document architectural decisions by creating Architectural Decision Records (ADRs) to structure discussions and analyze design trade-offs methodically before coding continues.

The best way to structure architectural discussions is through an interactive dialogue that explores multiple design options and their trade-offs within a code-free environment to maintain planning focus.

You need to create an Architectural Decision Record when encountering multiple design choices and requiring a methodical approach to evaluate trade-offs before proceeding with code implementation.

You need to provide story context, current progress, relevant code, test specs, and existing ADRs as input to generate accurate ADR content and update test specifications.

No, code generation is paused during the architectural decision-making process to ensure the focus remains entirely on planning, trade-off analysis, and structured documentation.