adr

The ADR skill provides a streamlined command-line interface for software engineering teams to document, track, and manage Architecture Decision Records directly within their development workflow. By capturing the context, reasoning, and consequences of critical technical choices, this skill serves as an essential tool for maintaining architectural consistency, onboarding new contributors, and preventing the repetition of past mistakes. It is designed for developers, architects, and technical leads who need a lightweight, version-controlled method to archive design patterns, library selections, and infrastructure changes over the lifecycle of a codebase.

• Standardized initialization of ADR directory structures (supporting common paths like docs/adr or architecture/decisions).

• Seamless creation of new decision records using consistent templates for context, decision, and consequence analysis.

• Built-in support for lifecycle management including superseding outdated records and tracking status transitions (Proposed, Accepted, Deprecated, Superseded).

• Powerful search capabilities for querying existing architectural history by terms, titles, or decision content.

• Integrated listing and viewing commands to quickly browse project design history without leaving the terminal.

• This skill expects the user to interact via the /adr command followed by specific actions such as new, list, or search.

• ADR templates are provided and configurable at the project level, ensuring consistent documentation quality across team members.

• It is highly recommended to keep ADR files in version control (Git) to maintain a chronological history of architectural changes alongside the source code.

• The tool is compatible with major AI-powered coding environments including Claude Code, Cursor, and various CLI-based development workflows.

• Inputs typically include titles for new records or search terms for discovery; outputs are usually formatted Markdown files that serve as both documentation and searchable knowledge bases.