skills.rest
dariuszparys
dariuszparysCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr

Identify architectural decisions and prompt ADR creation.

12|4|Updated Dec 2, 2025
Search Tags:#architecture#documentation#decisions#adr#governance#software-design#architecture-decisions
One-click install
npx skills add https://github.com/dariuszparys/claude-code-toolkit --skill adr-dariuszparys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/dariuszparys/claude-code-toolkit/tree/main/plugins/adr/skills
Command: npx skills add https://github.com/dariuszparys/claude-code-toolkit --skill adr-dariuszparys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs help teams capture architectural decisions to ensure traceability and rationale for future maintenance.

Core Features & Use Cases

  • Suggest ADRs after significant architectural changes.
  • Provide a concise rationale template and recommendations for when to create ADRs.
  • Help teams maintain a centralized decision history for governance.

Quick Start

Create an ADR for the latest architectural decision by running /adr:create.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I know when to create an architecture decision record?▼

Create an architecture decision record when a change affects multiple components, introduces new patterns, or involves significant trade-offs and future maintenance across modules and layers.

What is the best way to document architectural decisions for software governance?▼

Documenting architectural decisions through structured records ensures traceability and rationale for future maintenance, helping teams maintain a centralized decision history for governance.

How do I capture rationale and context for a significant architectural change?▼

You capture rationale and context by prompting ADR creation, which provides a concise template that ensures ADR-worthy context, rationale, and the final decision outcome are recorded.

Does this ADR tool require any specific dependencies to document software design decisions?▼

No specific dependencies or components are required to use this tool for documenting software design decisions, making it easy to integrate into your existing workflow.

What are the limitations of prompting ADR creation for architectural governance?▼

The scope is limited to decisions affecting multiple components or introducing new patterns, meaning minor localized changes may not trigger an ADR prompt and require manual evaluation.

Related Skills

Explore More Software Engineering Skills→
tillysosotillysoso

adr-drafting

Draft new Architecture Decision Records as standards-compliant Markdown files.

Community
Advanced
TiraelTirael

adr-authoring

Create and maintain Architecture Decision Records with a minimal template.

Community
Intermediate
phoenicisfphoenicisf

architecture

Document architectural decisions using ADR templates with context and trade-offs.

Community
Advanced
tmchowtmchow
22

iterative:tech-planning

Create an executable technical plan from a PRD or requirements.

Community
Advanced