adr

Generate numbered Architecture Decision Records as Markdown files.

3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/peel/fiddle --skill adr-peel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/peel/fiddle/tree/main/skills/adr
Command: npx skills add https://github.com/peel/fiddle --skill adr-peel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation of Architecture Decision Records (ADRs), ensuring that critical design choices are formally documented with their context, decisions, and consequences.

Core Features & Use Cases

  • Automated Numbering: Automatically assigns the next sequential number to new ADRs.
  • Structured Documentation: Enforces a consistent format for ADRs, including Context, Decision, and Consequences.
  • Use Case: When a team decides to switch from one database technology to another, they can use this skill to quickly generate a new ADR documenting the reasons for the change and its implications.

Quick Start

Use the adr skill to create a new architecture decision record for using AlloyDB over CloudSQL.

Frequently Asked Questions about adr

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

FAQPage Schema
What is an architecture decision record and when do I need to create one?

An architecture decision record (ADR) documents critical design choices, capturing their context, decisions, and consequences. You need to create an ADR whenever your team makes a significant technical decision, such as switching database technologies, to ensure formal documentation of the rationale and implications.

How do I generate an ADR file with context, decision, and consequences sections?

To generate an ADR file, you use the skill to prompt for essential details like context, decision, and consequences. It automates the formatting of these inputs into a structured Markdown file, adhering to specific filename conventions and supporting the creation of the target directory if it does not exist.

Can I automatically number architecture decision records sequentially in my project directory?

Yes, you can automatically number architecture decision records sequentially. The skill assigns the next sequential number to new ADRs automatically, ensuring consistent ordering and tracking of technical decisions within your specified directory structure.

Does the ADR generation process support creating a new directory structure if it does not exist?

Yes, the ADR generation process supports creating a new directory structure if it does not exist. When you generate an architecture decision record, the skill will automatically create the target directory to ensure the Markdown file is saved in the correct location.

What is the best way to document a decision to switch from one database technology to another?

The best way to document a database technology switch is to generate an architecture decision record. This records the context, decision, and consequences of the change, ensuring your team has a formal, structured Markdown document outlining the reasons and implications for the technology migration.