skills.rest
daddia
daddiaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

plan-adr

Identify architectural decisions requiring ADRs and produce a prioritized plan.

1|Updated Apr 25, 2026
Search Tags:#planning#architecture#documentation#adr#decision#plan#stakeholders
One-click install
npx skills add https://github.com/daddia/space --skill plan-adr-daddia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-adr
Source: https://github.com/daddia/space/tree/main/.agents/skills/plan-adr
Command: npx skills add https://github.com/daddia/space --skill plan-adr-daddia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan-ADR identifies the consequential design decisions that require Architecture Decision Records (ADRs) and organizes them into a prioritized plan for drafting.

Core Features & Use Cases

  • Identifies high-impact architectural decisions across epics and domains.
  • Produces a prioritized ADR plan that guides stakeholders and accelerates design work.
  • Integrates with ADR templates and existing repository workflows to streamline drafting.

Quick Start

Run plan-adr on the current epic to generate a prioritized ADR plan for drafting.

Frequently Asked Questions about plan-adr

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

FAQPage Schema
How do I identify which architectural decisions need ADRs?▼

To identify architectural decisions needing ADRs, analyze project or domain epics to detect ambiguities, new technology, or integration choices that impact architecture. This process outputs a structured list of required Architecture Decision Records for stakeholders.

How do I prioritize Architecture Decision Records for drafting?▼

ADR prioritization is achieved by evaluating detected ambiguities and integration choices across domain epics to assemble a structured, prioritized plan. This guides stakeholders and accelerates design work by ordering ADRs by impact.

When do I need to create an Architecture Decision Record plan?▼

You need an ADR plan when your project epic introduces new technology, integration choices, or architectural ambiguities. Planning ensures consequential design decisions are documented and prioritized before drafting begins.

Can I use existing repository workflows for ADR planning?▼

ADR planning integrates with existing repository workflows and templates by consuming a solution.md file as input. It produces an adr-plan.md deliverable that streamlines drafting within your established documentation environment.

What is the best way to document architectural decisions for stakeholders?▼

The best way to document decisions for stakeholders is generating a prioritized ADR plan that identifies consequential design choices across epics. This structured approach accelerates design work and guides the drafting process.

Related Skills

Explore More Software Engineering Skills→
daddiadaddia
1

write-tech-stack

Document technology stack choices and trade-offs into tech-stack.md from product.md and solution.md.

Community
Advanced
vudovnvudovn
8.1k

architecture

Creates ADR-based decision records and provides pattern guidance for software architecture projects.

Community
Advanced
mikrojsmikrojs
11

documentation-and-adrs

Organizes and archives architectural decisions and project documentation in Markdown files with structured ADR templates.

Official
Basic
TheSoftwareHouseTheSoftwareHouse
282

task-quality-review

Analyze Gate 1 task lists for gaps and generate accept/reject suggestions.

Official
Advanced