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.