Architectural Decision Record
Use when documenting an important architecture or technology decision with context, constraints, alternatives, trade-offs, evidence, ownership, status, and a durable review path.
Install
npx skills add sandbaseai/workbuddy-skill --skill architectural-decision-recordgit clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/architectural-decision-record ~/.claude/skills/architectural-decision-recordPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Architectural Decision Record ## Purpose and boundary Create a durable record for a consequential architecture, platform, data, security, or workflow decision. An ADR captures why a choice was made, what it costs, what evidence supports it, and when it should be revisited. It is not an implementation plan, a design specification, or proof that the chosen option has already been approved. Default to an authorized draft in `docs/adr/`; do not modify application code, silently create architecture policy, expose private discussions, or mark a proposal accepted without the actual decision owner. Preserve uncertainty and label inferred reasoning. Never copy secrets or private customer information into an ADR. ## Decision contract Before writing, identify: - one decision question and the consequence of delaying it; - context, constraints, goals, non-goals, scope, and affected systems/people; - decision owner, authors, reviewers, date, target revision, and expiry/review trigger; - observed evidence, assumptions, unknowns, and confidence for each important claim; - alternatives considered, evaluation criteria, rejected rationale, and decision boundaries; - status: Proposed, Accepted, Rejected, Superseded, or Deprecated; - consequences, migration/rollback implications, validation signals, and follow-up owners. If the decision question or owner cannot be determined, create a clearly marked framing draft or
Details
- Skill name
architectural-decision-record- Repository
- sandbaseai/workbuddy-skill
- Path
skills/architectural-decision-record/SKILL.md- License
- MIT
- Repo updated
- 8 September 2026
FAQ
What does the Architectural Decision Record skill do?
Use when documenting an important architecture or technology decision with context, constraints, alternatives, trade-offs, evidence, ownership, status, and a durable review path.
How do I install the Architectural Decision Record skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill architectural-decision-record. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Architectural Decision Record popular?
It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.
Related skills
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Architecture Blueprint Generator
9sandbaseai/workbuddy-skill
Use when analyzing an authorized codebase to produce an evidence-backed architecture blueprint, dependency map, diagrams, implementation patterns, and evolution guidance.
API Resilience Engineering
9sandbaseai/workbuddy-skill
Use when designing, implementing, reviewing, testing, or diagnosing API timeouts, retries, idempotency, rate limits, concurrency limits, circuit breakers, bulkheads, backpressure, load shedding, or ambiguous outcomes.
Architecture Decision
9sandbaseai/workbuddy-skill
Use when a technical choice changes system boundaries, contracts, quality attributes, data, or operations and has meaningful reversal cost.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.