drlisted

# /dr - Decision Record Creation ## Input Take the decision title from `$ARGUMENTS`. If empty, confirm New decision / Update existing via AskUserQuestion. For New decision ask for the title; for Update existing, list recent DRs in `<git-root>/docs/decisions/` for selection (§ Updating an Existing DR). Shape a title you are creating into a specific action like "Adopt X for Y", keeping it 5-64 characters and free of `/:*?"<>|`. The archive defaults to `<git-root>/docs/decisions/`, and the `DR_DIR` env var moves it. ## Adoption Gate Proceed to the process only when all three conditions below hold. When one is missing, skip the DR and apply the table top to bottom, leaving the decision where the first matching row says. | Condition | Where it goes when missing | | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- | | Hard to reverse. Changing the decision later carries meaningful cost | A design note in the project, or the commit message body when there is none | | Surprising without context. A future reader will ask "why this way?" | A design note in the project, or the commit message body when there is none | | Result of a real trade-off. Genuine alternatives ex