A tool-based system for managing Architecture Decision Records, which are short documents explaining important software design choices and their consequences.

Creating, listing, viewing, checking, and indexing decision records in a project's architecture documentation.

It keeps these decisions numbered, consistently formatted, searchable, and checked for errors instead of being edited as loose files.

adr — Skill for Claude Code by aaronsb/claude-code-config

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add aaronsb/claude-code-config --skill adr

Clone the repo

git clone --depth 1 https://github.com/aaronsb/claude-code-config

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/aaronsb/claude-code-config/adr/github.svg)](https://agentmods.dev/skills/aaronsb/claude-code-config/adr)

Your own site

<a href="https://agentmods.dev/skills/aaronsb/claude-code-config/adr"><img src="https://agentmods.dev/badge/skills/aaronsb/claude-code-config/adr/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/aaronsb/claude-code-config/adr"><img src="https://agentmods.dev/badge/skills/aaronsb/claude-code-config/adr.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 74 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 690 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00074	$0.00690
Opus 5.5	$0.00030	$0.00276
Sonnet 5.5	$0.00015	$0.00138
Haiku 4.5	$0.00007	$0.00069

Measured 1mo ago against content hash 5ca1146de653, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

adr scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/adr/SKILL.md · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ADR Management

Operate ADRs through the docs/scripts/adr CLI tool. Never create ADR files manually.

Commands

# Discover
docs/scripts/adr domains                  # Show domain number series and ranges
docs/scripts/adr list --group             # List all ADRs grouped by domain
docs/scripts/adr list --domain system     # Filter to one domain
docs/scripts/adr list --status Accepted   # Filter by status
docs/scripts/adr view <number>            # View an ADR (accepts 14, 014, ADR-014)

# Create
docs/scripts/adr new <domain> "Title"     # Create from template in correct subdirectory

# Maintain
docs/scripts/adr lint                     # Check all ADRs for issues
docs/scripts/adr lint --check             # Exit 1 on errors (CI mode)
docs/scripts/adr index -y                 # Regenerate INDEX.md

# Config
docs/scripts/adr config                   # Show current adr.yaml configuration

Workflow

Check domains first: docs/scripts/adr domains to see available domains and number ranges
Create: docs/scripts/adr new <domain> "Decision Title" — assigns next number, uses YAML frontmatter template
Edit: Fill in Context, Decision, Consequences, Alternatives sections
Lint: docs/scripts/adr lint before committing
Index: docs/scripts/adr index -y after adding or changing ADRs

Configuration

Each project defines its domain structure in docs/architecture/adr.yaml:

domains: Name, number range, description, folder for each domain
statuses: Valid status values (Draft, Proposed, Accepted, Superseded, Deprecated)
defaults: Default deciders and initial status for new ADRs
legacy: Number range for pre-domain ADRs

Always run docs/scripts/adr domains to discover the project's actual configuration rather than assuming domains.

ADR Format

The tool generates ADRs with YAML frontmatter:

---
status: Draft
date: 2026-02-17
deciders:
  - aaronsb
  - claude
related: []
---

# ADR-NNN: Decision Title

## Context
## Decision
## Consequences
### Positive
### Negative
### Neutral
## Alternatives Considered

Read the full file on GitHub · 82 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 82 lines · 74 tokens per session scan A 5ca1146de653

Subscribe to this mod's changes

adr is a skill published in the GitHub repository aaronsb/claude-code-config (18 stars, last pushed 6mo ago), licensed MIT. It adds 74 tokens to every session and 690 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Claude Code Planning Writing and docs agent-coordination ai-agents claude developer-tools governance

achieving-cmmc-level-2-compliance

Prepare a defense-contractor environment for CMMC Level 2 certification: scope CUI and FCI, implement the 110 NIST SP 800-171 Rev 2 security requirements across 14 families, compute the SPRS score with the DoD Assessment Methodology, manage a compliant POA&M, and ready the organization for a C3PAO assessment. Use when…

mukul975/Anthropic-Cybersecurity-Skills · 255 tokens

composio

Use Composio from Agent Swarm through the agent-swarm x composio CLI route, the swarmx MCP tool, or a registered ctx.api.composio script connection. Trigger when a task needs connected third-party app tools such as Gmail, Google Calendar, Google Docs, Google Drive, GitHub, Slack, Notion, or HubSpot through Tool Router…

desplega-ai/agent-swarm · 128 tokens

review-offered-task

Turn prompt for an offered swarm task: read the offer, accept with task-action and start work-on-task, or reject with a reason.

desplega-ai/agent-swarm · 33 tokens

close-issue

Close a GitHub or GitLab issue with a summary comment.

desplega-ai/agent-swarm · 16 tokens

motion-design-replication

Rebuild the feel of a reference motion-design clip (camera, depth of field, easing, captions, outro) as an on-brand agent-swarm piece in Remotion, then prove it with side-by-side frames and a model re-read of the replica. Use when asked to "replicate this video's vibe for the swarm", "make one like this but ours", or…

desplega-ai/agent-swarm · 95 tokens

create-pr

Create a pull request (GitHub) or merge request (GitLab) from the current branch.

desplega-ai/agent-swarm · 22 tokens