Adr Create

Creates numbered Architecture Decision Records in your docs/adr folder, automatically figures out the next sequential ID, and registers them in AgentDB's graph database. The template follows the standard ADR format with status, context, decision, and consequences sections. What's clever here is the semantic search component: it looks for related ADRs you've already written and automatically links them together with causal edges. Good for teams that actually maintain ADRs and want the cross-referencing done automatically. Saves you from manually tracking which decisions relate to which, though you'll need Claude Flow's MCP tools set up for the graph features to work.

skills.sh installs: 742
GitHub stars: 81.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ruvnet/ruflo --skill adr-create --agent claude-code

Installs into .claude/skills of the current project.

Files

Create ADR

Create a new Architecture Decision Record with the next sequential number, register it in the AgentDB graph, and link it to related ADRs.

When to use

When a significant architectural decision needs to be recorded -- new technology adoption, API design choices, data model changes, infrastructure decisions, or any cross-cutting concern that affects multiple components.

Steps

Find next number -- Glob for docs/adr/ADR-*.md and parse existing numbers to determine the next sequential ID (ADR-001, ADR-002, etc.). Create docs/adr/ if it does not exist.
Slugify title -- Convert the title argument to a lowercase, hyphen-separated slug (e.g., "Use PostgreSQL for persistence" becomes use-postgresql-for-persistence).

Create ADR file -- Write the file at docs/adr/ADR-NNN-<slug>.md using the standard template:

# ADR-NNN: <Title>

- **Status**: proposed
- **Date**: <today's date YYYY-MM-DD>
- **Deciders**: <leave blank for author to fill>
- **Tags**: <leave blank>

## Context

<!-- What is the issue that motivates this decision? -->

## Decision

<!-- What is the change that we are proposing? -->

SKILL.md on GitHub