adr

Create and manage Architecture Decision Records for technical decisions.

Updated May 6, 2026
One-click install
npx skills add https://github.com/crgarcia12/compy --skill adr-crgarcia12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/crgarcia12/compy/tree/main/.github/skills/adr
Command: npx skills add https://github.com/crgarcia12/compy --skill adr-crgarcia12

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill unit streamlines the generation and management of Architecture Decision Records (ADRs) for effective documentation and traceability of significant technical decisions.

Core Features & Use Cases

  • ADR Generation: Capture context, rationale, and consequences of technical decisions.
  • Workflow Integration: Supports both greenfield and brownfield workflows at every major decision point.
  • Reference Tracking: Integrates with other artifacts throughout the pipeline for traceability.

Quick Start

Create a new ADR to document the decision "Use PostgreSQL with Prisma ORM" in the spec2cloud pipeline.

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 why do I need it in my software development workflow?

To create an architecture decision record, capture the specific technical decision, such as a database or framework choice. The ADR skill generates the record by documenting context, rationale, and consequences, integrating it into the spec2cloud pipeline for traceability.

Can I document architecture decisions for existing brownfield projects, or is it only for new greenfield development?

You can document architecture decisions for both brownfield and greenfield workflows. The ADR skill supports capturing and documenting significant technical decisions at major decision points throughout the existing development lifecycle, not just new projects.

How does an architecture decision record integrate with other technical documentation and artifacts?

An architecture decision record integrates with other artifacts throughout the pipeline by tracking references. This integration provides traceability across the software development workflow, linking the documented technical decisions to related spec2cloud pipeline components.

What's the best way to manage technical decisions and ensure traceability across a software project?

The best way to manage technical decisions is using architecture decision records (ADRs) to capture context and consequences. This approach provides traceability and decision justification by integrating recorded artifacts throughout the entire development pipeline.