Create sequential Architecture Decision Records in docs/adr with required sections.
npx skills add https://github.com/gmanch94/agora --skill adr-new-gmanch94
Please help me install this Agent Skill. Skill: adr-new Source: https://github.com/gmanch94/agora/tree/main/.claude/skills/adr-new Command: npx skills add https://github.com/gmanch94/agora --skill adr-new-gmanch94
It prevents important engineering and architecture decisions from being lost, ambiguous, or hard to reverse by generating a consistent Architecture Decision Record in the repository’s established format.
docs/adr/NNNN-<slug>.md using the house template and required sections.Ask the AI to run adr-new and write an ADR for a non-trivial decision you are about to make in this project.
High-intent search queries and answers about installing and using this skill.
To create an Architecture Decision Record, this skill computes the next sequential ADR number and applies the repository’s standard template to produce a correctly named Markdown file in docs/adr.
A standard ADR template requires four core sections: Status, Context, Decision, and Consequences. The generated file applies this scannable structure to ensure consistent formatting and house style.
You should document an engineering decision using an ADR when facing a design choice that will be expensive to reverse. This prevents important architecture decisions from being lost or ambiguous.
To supersede or deprecate a prior ADR without editing history, this skill guides you to create a new sequential ADR that explicitly references and supersedes the old one, preserving an audit-friendly log.
No external dependencies or components are required. The skill operates independently to compute the next ADR number, apply the template, verify file placement, and surface the Decision summary.
The best way to ensure consistent formatting across multiple Architecture Decision Records is to apply a standardized template that enforces scannable structure, matches tone and length, and auto-generates the sequential file name.
mattjeffersonInitialize a repository with Harness Engineering directory structure and baseline documentation files.
ranma2913Generate structured Architectural Decision Records with front matter under /docs/adr.
AmsterdamEnforce Amsterdam engineering standards and governance artifacts across projects.
infantesromeroadrianGenerate markdown Architecture Decision Records from a YAML template with sequential numbering.