Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

adr-create — Claude Code skill: numbered ADRs in AgentDB

Writes an Architecture Decision Record into docs/adr with the next number, stores it in AgentDB and links it to related decisions. Useful when a decision has to be recorded and findable later.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add ruvnet/ruflo --skill adr-create -a claude-code
Open on GitHub

What adr-create does

The skill takes the title you give it, globs docs/adr/ADR-*.md to find the highest number and writes the next file at docs/adr/ADR-NNN-<slug>.md. The slug comes from the title. If the folder doesn't exist, it gets created.

Inside sits the usual template: status proposed, date, deciders, tags, then Context, Decision and Consequences split into positive, negative and neutral, with a Links block at the end. After writing, the skill stores a JSON record under mem:ADR-NNN at the semantic tier, searches the adr-patterns namespace for something similar and adds a depends-on causal edge to every hit.

None of that graph work happens without the ruflo MCP server connected, because the store, search and edge steps call its tools. The markdown file still lands on disk. Check your MCP list before the first run if you expect the links.

What it helps with

  • number a new ADR correctly and drop it into docs/adr/
  • start from a template with context, decision and consequences
  • tie a fresh decision to earlier ones on the same topic
  • pull up past ADRs by title through adr-patterns
  • keep the decision in agent memory so other sessions find it

Example prompts for the agent

  • Create an ADR for moving session storage to Redis
  • adr-create Split billing into its own service
  • Turn this decision into an ADR and link it to the related ones

How to install adr-create

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill adr-create -a claude-code

2Manually: put the files in place

~/.claude/skills/adr-create/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/adr-create/

From the same set104

The whole set →
ruflo ruvnet This skill adds multi-agent orchestration, memory, routing, and MCP tools to a project. Use it for swarm tasks and multi-step workflows. Claude Code CX Codex Cursor +1 4,000installs Swarm Orchestration ruvnet Skill for managing agent swarms with parallel execution, dynamic topology, and automatic load balancing. Use when a single agent is not enough and you need to orchestrate specialists of different types. Claude Code CX Codex Cursor +1 2,100installs github-project-management ruvnet Turns issue triage and board upkeep into gh and ruv-swarm calls: labels, subtasks, duplicate lookup. Useful when the tracker holds more tickets than order. Claude Code CX Codex Cursor +1 1,400installs github-workflow-automation ruvnet Automates GitHub Actions with AI agent coordination. Generates optimised pipelines, manages pull requests, analyzes failed runs, and deploys updates with risk assessment. Claude Code CX Codex Cursor +1 1,300installs github-code-review ruvnet Runs a swarm of specialized AI agents to inspect GitHub pull requests for security, performance, and architecture issues. Claude Code CX Codex Cursor +1 1,300installs stream-chain ruvnet Chains sequential agent steps together using streaming JSON flow and provides ready-to-run pipelines. Claude Code CX Codex Cursor +1 1,200installs flow-nexus-swarm ruvnet Deploy cloud-based AI agent swarms and define event-driven workflows with message queues. Use it to coordinate tasks, inspect runs, and scale a swarm. Claude Code CX Codex Cursor +1 1,200installs performance-analysis ruvnet Detects bottlenecks in Claude Flow swarms, profiles agent operations, and generates reports with actionable optimization recommendations. Claude Code CX Codex Cursor +1 1,200installs

Similar

ux-heuristics wondelai A skill that audits interface usability: it flags where users stall, rates each finding by severity, and tells you what to fix first. Claude Code CX Codex Cursor +1 9,300installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. Claude Code CX Codex Cursor +1 410,700installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. Claude Code CX Codex Cursor +1 410,300installs shadcn shadcn-ui A skill that keeps your agent on the rails with shadcn/ui: adds components, searches registries, fixes markup and builds a design system from your spec. Claude Code CX Codex Cursor +1 122,100installs

Questions about adr-create

How do I install adr-create in Claude Code?

Run npx skills add ruvnet/ruflo --skill adr-create -a claude-code. The skill then sits at ~/.claude/skills/adr-create/SKILL.md.

What does adr-create do?

It creates an ADR file with the next sequential number from a standard template, registers the decision in AgentDB and adds links to similar ADRs from adr-patterns.

What does the AgentDB registration need to work?

A connected ruflo MCP server providing agentdb_hierarchical-store, memory_search and causal-edge. Without it you only get the markdown file.

Source text

SKILL.md · MIT 
---
name: adr-create
description: Create a new Architecture Decision Record with sequential numbering and AgentDB registration
argument-hint: "<title>"
allowed-tools: mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-recall mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge mcp__plugin_ruflo-core_ruflo__memory_store mcp__plugin_ruflo-core_ruflo__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

1. **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.

2. **Slugify title** -- Convert the title argument to a lowercase, hyphen-separated slug (e.g., "Use PostgreSQL for persistence" becomes `use-postgresql-for-persistence`).

3. **Create ADR file** -- `Write` the file at `docs/adr/ADR-NNN-<slug>.md` using the standard template:
   ```markdown
   # 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? -->

   ## Consequences

   ### Positive
   -

   ### Negative
   -

   ### Neutral
   -

   ## Links
   ```

4. **Store in AgentDB** -- Call `mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store` with:
   - key: `mem:ADR-NNN`
   - tier: `semantic`
   - value: a JSON-encoded string: `{ "id": "ADR-NNN", "title": "<title>", "status": "proposed", "date": "<today>", "file": "docs/adr/ADR-NNN-<slug>.md" }`

5. **Find related ADRs** -- Call `mcp__plugin_ruflo-core_ruflo__memory_search` with the title as query in namespace `adr-patterns` to find related decisions. If matches are found, add them to the Links section and call `mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge` for each relationship with:
   - sourceId: `mem:ADR-NNN`
   - targetId: `mem:ADR-RELATED`
   - relation: `depends-on`

6. **Store pattern** -- Call `mcp__plugin_ruflo-core_ruflo__memory_store` in namespace `adr-patterns` with key `ADR-NNN` and the title + context as value for future semantic search.

7. **Report** -- Output the created file path, ADR number, and any related ADRs found.

© ruvnet · MIT · ruvnet/ruflo

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor