Skills
.Work. You
Rest

adr-suggest

Community

Prompt for ADR documentation at critical decision points.

Software Engineering#architecture#ADR#decision-making#decision documentation#suggestion
Authorrjschie
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps users capture architectural decisions (ADRs) by suggesting documentation at key decision-making moments, ensuring important decisions are not overlooked.

Core Features & Use Cases

  • Decision Detection: Identifies ADR-worthy decisions based on criteria like reversibility, context, and trade-offs.
  • User Nudges: Suggests running /adr <slug> to document decisions, enhancing decision-making practices.
  • Use Case: After a heated discussion about a new feature, the Skill suggests documenting the decision to standardize on a specific approach.

Quick Start

Use the adr-suggest skill during a planning session to capture architectural decisions.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: adr-suggest
Download link: https://github.com/rjschie/dotfiles/archive/main.zip#adr-suggest

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.