adr-er

README

ADR-ER

a friendly little thing for managing architectural decision records

this is a super pretty simple cli app for working with ADRs using the Nygard format.

ADRs are stored in a local directory that can/should be tracked along with the code:

under the current working directory, the application will look for a viable directory named adr, .adr, or architectural-decision-records.

"viable": the contents of the candidate directories are scanned. a "viable" one has only markdown files that fit the ADR naming convention. eg: 0003-security-audit.md, 0007-team-expansion.md, etc. Subdirectories are allowed in the ADR dir, but its immediate files must be only ADRs.

This mechanism is to prevent the app from writing markdown files into source-code directories

Install

go install github.com/therealkevinard/adr-er@latest

TODO: github != gilab. learn GH actions for release

Creating an ADR

Run adr-er create to make a new ADR. this opens a tui form to fill in the deets.
Only Title is strictly required, but all fields are recommended.

When you're all done, the ADR file will be created with an incremented sequence number.

Templating is a one-way job, but the file can be edited all you want as text once it's created.

Viewing exising ADRs

Use adr-er view to open a handy little navigator for existing ADR files.
The app has simple keyboard navigation and supports filtering the list. for tall files, the viewer is scrollable - you just have to tab/arrow over to the viewer to scroll (otherwise, you're scrolling the file list, yknow?)