adr

Create and manage Architecture Decision Records within the spec2cloud pipeline.

Updated Mar 30, 2026

Search Tags:#architecture #technical documentation #spec2cloud #project integrity #decision management

Ready to run

npx skills add https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield --skill adr-emeaappgbb

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield/tree/main/.github/skills/adr
Command: npx skills add https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield --skill adr-emeaappgbb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spec2cloud, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill aids in generating and managing Architecture Decision Records (ADRs), ensuring every significant technical decision is meticulously documented and traceable.

Core Features & Use Cases

ADR Creation: Automatically create ADRs with structured information.
Decision Tracking: Maintain a history of all significant technical decisions.
Project Traceability: Facilitate easy access to decision contexts and rationale.
Use Case: When developing a new feature, automatically create an ADR to document the technology choice, infrastructure decisions, and migration strategies.

Quick Start

Use the adr skill to create an ADR for the new database migration decision.

Frequently Asked Questions about adr

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

FAQPage Schema

How do I document technical decisions to maintain project traceability?▼

Architecture Decision Records document technical decisions to maintain project traceability by capturing context, rationale, and consequences within the spec2cloud pipeline. This ensures historical reference for infrastructure choices and migration strategies.

What is the best way to track architecture decisions for a new feature?▼

Tracking architecture decisions for a new feature is best handled by creating an Architecture Decision Record to document the technology choice, infrastructure decisions, and migration strategies, ensuring every significant technical decision is meticulously documented and traceable.

How do I automate Architecture Decision Record creation in a pipeline?▼

Automating Architecture Decision Record creation in a pipeline is achieved by using the adr skill within the spec2cloud environment to automatically generate structured ADRs capturing decision context, rationale, and consequences.

Do I need a specific environment to manage ADRs and decision history?▼

Yes, you need the spec2cloud environment to properly integrate and manage ADRs and decision history. The spec2cloud dependency is required to capture context, rationale, and consequences of technical decisions for traceability.

Why use structured ADRs instead of general technical documentation for project integrity?▼

Structured ADRs provide specific project integrity by ensuring every significant technical decision is meticulously documented and traceable, whereas general technical documentation lacks the automated decision tracking and historical reference context needed for project traceability.

What limitations exist when integrating decision management with spec2cloud?▼

A key limitation is the strict dependency on the spec2cloud environment for proper integration; without this pipeline setup, the automated creation and management of Architecture Decision Records and decision tracking will not function correctly.