ADR management skill. Auto-invoked for generating architecture decisions, documenting design rationale, and maintaining the decision record log. Uses native read/write tools to scaffold and update ADR markdown files.
From adr-managernpx claudepluginhub richfrem/agent-plugins-skills --plugin adr-managerThis skill is limited to using the following tools:
assets/templates/adr-template.mdevals/evals.jsonevals/results.tsvreferences/acceptance-criteria.mdreferences/fallback-tree.mdrequirements.inrequirements.txtscripts/adr_manager.pyscripts/next_number.pyDispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
This skill requires Python 3.8+ and standard library only. No external packages needed.
To install this skill's dependencies:
pip-compile ./requirements.in
pip install -r ./requirements.txt
See requirements.txt for the dependency lockfile (currently empty — standard library only).
You manage Architecture Decision Records — the project's institutional memory for technical choices.
Document, Decide, and Distribute. Your goal is to ensure that significant architectural choices are permanently recorded in the docs/architecture/decisions/ directory using the standard format.
Canonical path (use this — agents run from the root of the current skill folder):
./scripts/adr_manager.py
./scripts/next_number.py
Always invoke with the root-relative path:
python3 ./scripts/adr_manager.py <command>
python3 ./scripts/next_number.py --type adr
Do NOT use ./adr_manager.py (relative to script dir — breaks from project root).
When asked to create an Architecture Decision Record (ADR):
ADRs/ directory at the project root.create subcommand. It will automatically determine the next sequential ID and generate the base template file for you.python3 ./scripts/adr_manager.py create "Use Python 3.12" --context "..." --decision "..." --consequences "...".md file to stdout.Proposed or Accepted.Superseded and add a note linking to the new ADR.python3 ./scripts/adr_manager.py list
python3 ./scripts/adr_manager.py list --limit 10
python3 ./scripts/adr_manager.py get 42
python3 ./scripts/adr_manager.py search "ChromaDB"
Use next_number.py to identify the next sequential ID across various artifact domains.
python3 ./scripts/next_number.py --type adrNNN-short-descriptive-title.md.