skills.rest
brayandiazc
brayandiazcCOMMUNITY
Explore all skills by this author →
Website𝕏@brayandiazcGitHub

new-adr

Generates a numbered Architecture Decision Record from a template and updates the decisions index.

15|22|Updated May 5, 2024
Search Tags:#template#documentation#markdown#adr#generate#architecture decision record#decisions index
One-click install
npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill new-adr-brayandiazc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new-adr
Source: https://github.com/brayandiazc/project-starter-template-es-ai/tree/main/.claude/skills/new-adr
Command: npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill new-adr-brayandiazc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Recording architecture decisions consistently is tedious: you must find the next ADR number, copy the template, name the file correctly, and update the index. This Skill automates that bookkeeping so the author only writes the actual decision content. ## Core Features & Use Cases - Automatic numbering: Scans docs/decisions/ for the highest NNNN-*.md file and assigns the next zero-padded number. - Template-based creation: Copies docs/decisions/0000-template.md into a new kebab-case file with title, Proposed status, and today's date prefilled. - Index maintenance: Adds a link to the new ADR in docs/decisions/README.md in numeric order. - Use Case: After deciding to switch databases, run the skill with a short title and get docs/decisions/0007-use-server-side-rendering.md ready to fill in with Context, Decision, and Consequences. ## Quick Start Ask the assistant to create a new ADR titled "use server-side rendering" and it will generate the numbered file and update the decisions index.

Frequently Asked Questions about new-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Architecture Decision Record automatically?▼

Invoke the skill with a short title, such as "/new-adr use server-side rendering". It finds the highest numbered ADR in docs/decisions/, copies the template to the next number, and registers the new file in the index.

How are ADR files numbered and named?▼

Files follow the NNNN-kebab-title.md convention with zero-padded sequential numbers, for example 0007-use-server-side-rendering.md. The skill computes the next number from the highest existing file in docs/decisions/.

Does the skill fill in the ADR content for me?▼

No. It only sets the title, Proposed status, and current date. The Context, Decision, and Consequences sections remain as guided placeholders for the author to complete, and the skill never marks an ADR as Accepted.

Can the skill edit or replace existing ADRs?▼

No. The skill explicitly refuses to edit or replace existing ADR files. It only creates new numbered records and appends their links to the index in docs/decisions/README.md.

What happens if the decisions index has different conventions?▼

The skill reads docs/decisions/README.md first and follows its numbering scheme, naming convention, and index maintenance rules whenever they differ from the default steps.

Related Skills

Explore More Software Engineering Skills→
cliveportmancliveportman
1

docs-conventions

Define and enforce documentation conventions for the docs/ directory.

Community
Intermediate
abdullah1854abdullah1854
1

session-handoff

Generate Markdown Architectural Decision Records from structured inputs.

Community
Intermediate
abudhahirabudhahir

architecture-documenter

Generate system architecture documentation and Architecture Decision Records.

Community
Advanced
jtvarisjtvaris

architecture-decision

Generate Architecture Decision Records with context, constraints, and alternatives.

Community
Intermediate