skills.rest
ruvnet
ruvnetCOMMUNITY
Explore all skills by this author →
Website𝕏@ruvGitHub

adr-create

Creates sequentially numbered Architecture Decision Records and registers them in AgentDB.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#ADR#decision tracking#Markdown#AgentDB#Documentation#architecture decision record#Software Architecture
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill adr-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-create
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-adr/skills/adr-create
Command: npx skills add https://github.com/ruvnet/claude-flow --skill adr-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recording architectural decisions consistently is hard: numbering drifts, formats vary, and decisions get lost without links to related context. This Skill standardizes ADR creation with sequential numbering, a fixed template, and graph-based registration so decisions stay discoverable.

Core Features & Use Cases

  • Sequential Numbering: Scans existing docs/adr/ADR-*.md files to assign the next ADR number automatically.
  • Standard Template: Generates a structured ADR file with Status, Date, Context, Decision, Consequences, and Links sections.
  • AgentDB Registration: Stores the ADR in a hierarchical memory tier and creates causal edges to related decisions found via semantic search.
  • Use Case: When adopting a new database or changing an API design, run this Skill to produce ADR-NNN-<slug>.md, link it to prior related ADRs, and make it searchable for future decisions.

Quick Start

Create a new ADR titled "Use PostgreSQL for persistence" and link it to any related existing decisions.

Frequently Asked Questions about adr-create

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

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

Invoke the skill with a title argument, and it scans docs/adr for existing ADR files, assigns the next sequential number, slugifies the title, and writes a templated Markdown file at docs/adr/ADR-NNN-<slug>.md.

How are ADRs numbered and named by this skill?▼

Numbering is determined by globbing docs/adr/ADR-*.md and parsing existing numbers to find the next ID. The filename combines the number with a lowercase hyphen-separated slug derived from the title.

Does this skill link related architecture decisions?▼

Yes. It runs a semantic memory search in the adr-patterns namespace using the title, adds matches to the Links section, and creates causal depends-on edges in AgentDB between the new and related ADRs.

What happens if the docs/adr directory does not exist?▼

The skill creates the docs/adr directory automatically before writing the first ADR file, so no manual setup of the folder structure is required.

What sections does the generated ADR template include?▼

The template includes Status, Date, Deciders, and Tags metadata, plus Context, Decision, Consequences (positive, negative, neutral), and Links sections. Status defaults to proposed and deciders are left blank for the author.

Related Skills

Explore More Software Engineering Skills→
govctl-orggovctl-org
239

discuss

Facilitate design discussions and draft RFC or ADR artifacts.

Official
Advanced
atomicinnovationatomicinnovation
30

review-adr

Review ADR YAML frontmatter and enforce lifecycle status transitions.

Official
Advanced
repowise-devrepowise-dev
5.0k

architectural-decisions

Identify and surface rationale behind architectural decisions from code, commits, and docs.

Official
Intermediate
alibabaalibaba
2.2k

mermaid

Render Mermaid diagrams from fenced code blocks in Markdown documents.

Official
Basic