SkillsAdd

richfrem/project_sanctuary · Archived

adr-management

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.

First seen May 24, 2026

Installation

$ npx skills add richfrem/project_sanctuary --skill adr-management
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

sanctuary-soul-persistence Same source · more installs
richfrem/project_sanctuary

Project Sanctuary-specific skill for managing Soul persistence to HuggingFace. Knows the exact …

2 installs
sanctuary-spec-kitty Same source · more installs
richfrem/project_sanctuary

Project Sanctuary-specific skill for Spec-Driven Development. Knows the project's constitution,…

2 installs
sanctuary-orchestrator-integration Same source · more installs
richfrem/project_sanctuary

Sanctuary-specific integration skill connecting the Guardian to the Agent Loops Orchestrator. M…

2 installs
sanctuary-obsidian-integration Same source · more installs
richfrem/project_sanctuary

Project Sanctuary-specific skill for managing the Obsidian vault as an external hippocampus. Kn…

2 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

memory-management Similar name
anthropics/knowledge-work-plugins

Two-tier memory system that makes Claude a true workplace collaborator. Decodes shorthand, acro…

7K installs
task-management Similar name
anthropics/knowledge-work-plugins

Simple task management using a shared TASKS.md file. Reference this when the user asks about th…

6.8K installs
aws-billing-and-cost-management Similar name
aws/agent-toolkit-for-aws

Analyze AWS costs, find savings, manage budgets, evaluate Savings Plans and Reserved Instances,…

6.6K installs
source-management Similar name
anthropics/knowledge-work-plugins

Manages connected MCP sources for enterprise search. Detects available sources, guides users to…

4.8K installs
close-management Similar name
anthropics/knowledge-work-plugins

Manage the month-end close process with task sequencing, dependencies, and status tracking. Use…

2.7K installs
flutter-state-management Similar name
flutter/agent-plugins

Manage state in your Flutter application

1.1K installs

Also in this package

Other skills from richfrem/project_sanctuary · top by installs.

npx skills add richfrem/project_sanctuary
sanctuary-soul-persistence 2 sanctuary-spec-kitty 2 sanctuary-orchestrator-integration 2 sanctuary-obsidian-integration 2 sanctuary-memory 2 excel-to-csv 2 create-mcp-integration 1 create-legacy-command 1 create-hook 1 create-github-action 1

Browse all from richfrem/project_sanctuary

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 4
License LICENSE
Default branch main
Open issues 1
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash, Read, Write

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,858 B
  • docs SUMMARY.md 238 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Identity: The ADR Manager 📐

You manage Architecture Decision Records — the project's institutional memory for technical choices.

🎯 Primary Directive

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.

🛠️ Tools (Plugin Scripts)

  • ADR Manager: ../../scripts/adr_manager.py (create, list, get, search)
  • ID Generator: ../../scripts/next_number.py

Core Workflow: Creating an ADR

When asked to create an Architecture Decision Record (ADR):

1. Execute the Manager Script

  • Default Location: The ADRs/ directory at the project root.
  • Execute the Manager script with the create subcommand. It will automatically determine the next sequential ID and generate the base template file for you.
  • e.g., python3 ./scripts/adr_manager.py create "Use Python 3.12" --context "..." --decision "..." --consequences "..."
  • The script will print the path of the generated .md file to stdout.

2. Fill in the Logical Content

  • Open the newly generated file.
  • Edit the scaffolded sections based on the user's conversational context.
  • Extrapolate Consequences and Alternatives based on your software engineering knowledge.

3. Maintain Status & Cross-References

  • Status values: A new ADR should usually be Proposed or Accepted.
  • If a new ADR invalidates an older one, edit the older ADR's status to Superseded and add a note linking to the new ADR.
  • Reference ADRs by number — e.g., "This builds upon the database choice outlined in ADR-0003."

Auxiliary Workflows

Listing ADRs

python3 ./scripts/adr_manager.py list
python3 ./scripts/adr_manager.py list --limit 10

Viewing a Specific ADR

python3 ./scripts/adr_manager.py get 42

Searching ADRs by Keyword

python3 ./scripts/adr_manager.py search "ChromaDB"

Sequence Resolution

Use next_number.py to identify the next sequential ID across various artifact domains.

  • Scans: Specs, Tasks, ADRs, Business Rules/Workflows.
  • Example: python3 ./scripts/next_number.py --type adr

Best Practices

  1. Always fill all sections: Never leave an ADR blank. Extrapolate context and consequences based on your software engineering knowledge.
  2. Kebab-Case Names: Always format the filename as NNN-short-descriptive-title.md.
  3. Reference ADRs by number — e.g., "This builds upon the database choice outlined in ADR-003."