adr-create
Create a new Architecture Decision Record with sequential numbering and AgentDB registration
Best for architecture decisionsWorks with GitHubLow risk
⌘source
- author
@ruvnet- repo
- ruvnet/ruflo
- language
- TypeScript
★46kstars
5.1kforks
May 5, 2026
✦overview.md
Key Features
- ·Auto-increments ADR numbers
- ·Creates standardized Markdown templates
- ·Slugifies title for filenames
- ·Registers ADRs in AgentDB graph
- ·Links to related ADRs
Use Cases
- →Recording adoption of a new technology or framework
- →Documenting API design choices for future reference
- →Capturing infrastructure decisions that affect multiple teams
- →Tracking data model changes with rationale
Best for
- ✓architecture decisions
- ✓long-lived documentation
- ✓team knowledge base
Not ideal for
- !quick notes
- !non-architectural decisions
FAQs
name
adr-create
description
Create a new Architecture Decision Record with sequential numbering and AgentDB registration
argument-hint:<title>
allowed-tools:mcp__claude-flow__agentdb_hierarchical-store mcp__claude-flow__agentdb_hierarchical-query mcp__claude-flow__agentdb_causal-edge mcp__claude-flow__memory_store mcp__claude-flow__memory_search Bash Read Write Edit Grep Glob
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 --
Globfordocs/adr/ADR-*.mdand parse existing numbers to determine the next sequential ID (ADR-001, ADR-002, etc.). Createdocs/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 --
Writethe file atdocs/adr/ADR-NNN-<slug>.mdusing 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? -->
$install
1-click copynpx skills add ruvnet/ruflo --skill adr-createSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.