Skip to content

trackbed:docs:adr

Write an Architecture Decision Record for a significant, long-lived decision, following the project's existing ADR format.

/trackbed:docs:adr [decision title]

Author Architecture Decision Records for significant, long-lived decisions, with lifecycle states (PROPOSED / ACCEPTED / SUPERSEDED / DEPRECATED). Finds the project's existing ADR log and matches its format and numbered or dated filenames; falls back to docs/decisions/ and a Nygard-style template otherwise. Use when adopting a new pattern, committing to a dependency, changing a public interface, changing the data model, or rejecting an alternative a future maintainer might reasonably re-propose. Initiative-local SIW decisions stay in the spec and LOG for transfer to Linear.