A comprehensive tool for creating, tracking, and linting Architecture Decision Records (ADR) to maintain a transparent and searchable history of technical decisions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-adr
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-adr using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Architecture Decision Records (ADR) Manager?
The ADR skill is designed to streamline the documentation of significant technical choices within a software project. By leveraging Openclaw Skills, developers can ensure that the rationale behind every architectural shift is captured, from database selections to microservices migrations. This skill enforces the MADR (Markdown Architectural Decision Records) format, ensuring that documentation remains consistent, professional, and easy to navigate for both current team members and future stakeholders.
Architecture Decision Records (ADR) Manager Use Cases
- Documenting major architectural shifts such as migrating from local caching to Redis.
- Maintaining a historical log of system design choices for team onboarding and audits.
- Justifying technical debt or specific technology stacks to stakeholders.
- Tracking the lifecycle of decisions from proposal to acceptance or supersession.
How Architecture Decision Records (ADR) Manager Works
- Initialize a new architecture record using a standardized template with the create command.
- Fill in the context, decision drivers, and consequences in the generated Markdown file.
- Track the progress of decisions using status transitions like proposed, accepted, or superseded.
- Generate an automated index to maintain a high-level overview of all project decisions.
- Run linting checks to ensure all records comply with the required sections and formatting standards.
Architecture Decision Records (ADR) Manager Setup
To get started with this skill, ensure you have the scripts ready in your environment and configure your directory preferences.
# Create a new ADR
python3 scripts/main.py create "Adopt Redis for Caching"
# List all existing decisions
python3 scripts/main.py list
# Check for formatting errors
python3 scripts/main.py lint
Architecture Decision Records (ADR) Manager Data Schema & Taxonomy
The skill organizes architectural data within a structured directory using Markdown for content and JSON for configuration.
| Component | Description |
|---|---|
docs/adr/ |
The default directory for storing individual ADR files. |
index.md |
A generated summary of all decisions and their current statuses. |
.adr.json |
Configures the template, required sections, and storage path. |
scripts/main.py |
The core entry point for managing the ADR lifecycle. |
Architecture Decision Records (ADR) Manager Advanced Features
- CI/CD integration for automated linting of pull requests containing architectural changes.
- Automated index generation to keep project documentation in sync with file changes.
- Support for linking superseded decisions to their newer replacements for better traceability.
- Custom template support to adapt the ADR format to specific organizational needs.
SKILL.md
Loading
Related Openclaw Skills
Coding Agent
A powerful meta-agent skill that delegates complex development tasks to specialized AI agents like Codex and Claude Code using background bash processes.
ClawTipShopTester
A specialized AI writing assistant and payment integration tester for the Openclaw ecosystem.
Session Recall
Session Recall empowers AI agents to autonomously reconstruct conversation context from transcripts, cross-channel logs, and memory files.
Reelsmith
Reelsmith transforms topics, news, or articles into complete short-form vertical video packages optimized for social media platforms.
Performance Analysis & Optimization
A comprehensive performance profiling and analysis tool designed to identify code bottlenecks and provide actionable optimization recommendations.
Debugging Assistant
A comprehensive debugging companion that automates log analysis, suggests strategic breakpoints, and maps execution flows to identify root causes.
Featured*
