adr

Record architecture decisions into structured markdown files via command-line input.

25|5|Updated May 9, 2026
One-click install
npx skills add https://github.com/kamp-us/phoenix --skill adr-kamp-us
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/kamp-us/phoenix/tree/main/claude-plugins/kampus-pipeline/skills/adr
Command: npx skills add https://github.com/kamp-us/phoenix --skill adr-kamp-us

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of recording architecture decisions, ensuring they are systematically documented and easily accessible.

Core Features & Use Cases

  • Automated Decision Recording: Triggered by specific phrases or after a technical preference is stated, the skill records decisions into a structured format.
  • Structured Documentation: Decisions are stored in a .decisions/ directory with unique identifiers and metadata.
  • Use Case: When a technical team reaches a consensus on a design decision, use the /adr command to record it and ensure it's properly documented.

Quick Start

When a design decision is made, say "/adr" followed by the decision details.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I automate architecture decision recording in a codebase?▼

To automate architecture decision recording, trigger the tool via a command-line interface to save decisions into a structured markdown file within a designated directory. This ensures technical preferences are systematically documented and easily accessible for development teams.

What is the best way to document technical design decisions in markdown?▼

Documenting technical design decisions in markdown is best handled by storing them in a structured .decisions directory with unique identifiers and metadata. This automated approach ensures consensus on architecture preferences is systematically captured and easily retrievable.

When do I need to record architecture decisions for software development?▼

You need to record architecture decisions when a technical team reaches a consensus on a design choice. Using a command-line interface to trigger the recording process ensures the decision is properly documented in a structured markdown file for future reference.

Does this architecture decision recording tool work with command-line interfaces?▼

Yes, this architecture decision recording tool requires the use of a command-line interface for interaction. You trigger the recording process by entering a slash command followed by the specific decision details to store them in a structured directory.

How are documented architecture decisions structured within the codebase?▼

Documented architecture decisions are structured by storing them as markdown files within a designated .decisions directory. Each recorded decision is assigned unique identifiers and metadata to ensure the documentation remains organized and easily accessible.

Can I trigger decision documentation automatically after stating a technical preference?▼

Yes, you can trigger decision documentation automatically by stating a technical preference and entering a slash command. The tool records the details into a structured markdown file within a designated directory, ensuring the architecture decision is properly documented.