Decisions
Architecture decision records
Each ADR is a Markdown file in
docs/adr/. Argue in the GitHub thread, then change the file.How a decision moves
An ADR starts as proposed with a recommendation and a list of questions. Discussion happens in a GitHub issue titled with the ADR number. When the team agrees, someone edits the file: status becomes accepted (or rejected), the questions get answers, and the PRD sections it names get updated in the same pull request.