agile-4-create-adr

Scan Confluence and Jira to create a formal ADR with context, data model, API, and deployment considerations.

Updated May 16, 2026
One-click install
npx skills add https://github.com/cedricfarinazzo/agile-skills --skill agile-4-create-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agile-4-create-adr
Source: https://github.com/cedricfarinazzo/agile-skills/tree/main/agile-product/skills/agile-4-create-adr
Command: npx skills add https://github.com/cedricfarinazzo/agile-skills --skill agile-4-create-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs are often created late or inconsistently, making architectural decisions hard to trace. This Skill guides tech leads to scan existing docs, extract answers from PRD/Specs UI, interview for gaps, and produce a standards-compliant ADR in Confluence.

Core Features & Use Cases

  • ADR generation: Create a formal Architecture Decision Record as a child page of the project root in Confluence.
  • Documentation synthesis: Consolidates PRD, Specs UI, and Jira discussions into a single decision artifact with context, alternatives, and consequences.
  • Iterative updates: Append updates with timestamps and maintain change history for traceability.
  • Use Case: When starting a new initiative, run this skill to capture decisions about architecture style, tech stack, data model, and deployment considerations.

Quick Start

Run this skill after reviewing the PRD and Specs UI to generate an ADR draft under the project root in Confluence.

Frequently Asked Questions about agile-4-create-adr

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

FAQPage Schema
How do I generate an Architecture Decision Record from Confluence and Jira?

Generate an Architecture Decision Record by scanning Confluence and Jira discussions to extract decisions, consolidating PRD and Specs UI inputs into a formal ADR. This produces a standards-compliant Confluence page capturing context, alternatives, and consequences.

What is the best way to document architecture decisions traceably?

Document architecture decisions traceably by synthesizing PRD, Specs UI, and Jira discussions into a single ADR artifact. The consolidated record includes context, data models, API considerations, and deployment details as a child page under the project root in Confluence.

Can I create an ADR directly in Confluence using existing PRD and Specs UI documents?

Yes, you can create an ADR directly in Confluence using existing PRD and Specs UI documents. The process extracts existing decisions from these inputs and solicits user interviews for gaps, producing a formal ADR with change history for iterative updates.

How does an ADR handle context, data model, and deployment considerations?

An ADR handles context, data model, and deployment considerations by consolidating scanned documentation and interview inputs into a formal record. It structures these architectural elements within a Confluence child page to solidify decisions and maintain traceable change history.

When do I need to create an ADR for a product initiative?

Create an ADR for a product initiative when starting a new project requiring architecture decisions and traceable documentation. Running this after reviewing the PRD and Specs UI captures decisions about architecture style, tech stack, data model, and deployment considerations.

How to maintain ADR change history and append updates with timestamps?

Maintain ADR change history by appending updates with timestamps to the Confluence child page. This iterative update process ensures architectural decisions remain traceable over time, consolidating new context and alternatives as the product initiative evolves.