adr

Manage Architecture Decision Records in Confluence with automated numbering and status tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the management of Architecture Decision Records (ADRs) within Confluence, ensuring a consistent and efficient process for documenting architectural choices.

Core Features & Use Cases

  • Create New ADRs: Generate new ADRs from a predefined template, automatically numbering them and setting initial properties.
  • Update Existing ADRs: Modify existing ADRs, including status changes and content revisions.
  • Generate Status Reports: Compile a report of all ADRs and their current statuses.
  • Sync Emojis: Automatically update Confluence page emojis to reflect the ADR status.
  • Review ADRs: Facilitate architectural quality reviews by delegating review tasks to a sub-agent.

Quick Start

Use the adr skill to create a new ADR with the title "Implement Caching Layer" and status "Draft".

Frequently Asked Questions about adr

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

FAQPage Schema
How do I manage Architecture Decision Records in Confluence?

You can manage Architecture Decision Records in Confluence by using this Skill to automate ADR creation, updating, status reporting, and emoji synchronization. It requires integration with the atlassian skill to perform Confluence operations.

Can I automatically number new Architecture Decision Records and set their initial status?

Yes, you can automatically number new Architecture Decision Records and set initial properties by generating them from a predefined template. This ensures consistent numbering and initial status tracking across all records.

How do I generate a status report for all Architecture Decision Records?

You generate a status report for all Architecture Decision Records by compiling a report of existing ADRs and their current statuses. This provides a comprehensive overview of all architectural decisions and their lifecycle stages.

Do I need the atlassian skill to update ADR statuses and sync emojis in Confluence?

Yes, you need the atlassian skill integration to update ADR statuses and sync emojis in Confluence. The Skill depends on this integration to automate ADR lifecycle tasks including status tracking and emoji synchronization.

What is the best way to review Architecture Decision Records for architectural quality?

The best way to review Architecture Decision Records for architectural quality is by delegating review tasks to a sub-agent. This facilitates structured architectural quality reviews of your documented decisions.

How does emoji synchronization work for Architecture Decision Records?

Emoji synchronization automatically updates Confluence page emojis to reflect the current ADR status. This provides a visual indicator of each Architecture Decision Record's lifecycle stage directly within Confluence.