adr-new

To create an Architecture Decision Record, use a command with your desired title to generate a markdown file from a YAML template. The system applies sequential numbering and populates standard sections like status, context, decision, and consequences automatically.

An Architecture Decision Record template provides a standardized structure to document software architecture choices, capturing status, deciders, context, decision, rationale, and consequences to ensure decisions are well-documented and accessible across the project.

Automated ADR tools handle sequential numbering by evaluating the existing ADR directory and assigning the next available number to uniquely identify each new markdown file, preventing numbering conflicts when documenting software architecture decisions.

Standardized architecture decision records include predefined sections for status, date, deciders, context, decision, rationale, and consequences. This template ensures all critical aspects of a software architecture choice are consistently captured in the generated markdown.

Generating architecture decision records requires access to the project's ADR directory and a YAML template file. The tool writes sequentially numbered markdown files directly into this specified directory to maintain organized architectural documentation.

Yes, you can specify a custom title when automating architecture decision record creation. This user-defined title is used to generate the markdown file name and populate the content within the standardized YAML template sections.