new-adr

To create an Architecture Decision Record, simply provide the decision title. The system automatically generates a slug, applies a standardized template with context, decision, and consequences sections, and populates date metadata without requiring manual file setup.

A standardized ADR template includes sections for the title, context, decision, and consequences. It comes pre-populated with date metadata and inferred canonical numbering, ensuring durable structural decisions are consistently documented across your engineering team.

No, the ADR creation process does not automatically commit files. It supports local path resolution to generate the document locally, allowing you to validate the template and content before manually committing the decision record to version control.

You should use an Architecture Decision Record when engineers need to document durable structural decisions. ADRs provide a standardized format to capture the context, decision, and consequences, ensuring critical architectural choices are traceable and maintained over time.

Yes, you can generate ADR slugs automatically from the provided decision title. The system creates a URL-friendly slug while simultaneously inferring the next canonical number and applying the standardized template within your configured decisions directory.