adr-workflow

Manage Architecture Decision Record workflows for Athena schema and architectural changes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ADR Workflow Skill ensures that any proposed or requested change to Athena's schema, behavior, or architecture follows the proper ADR (Architecture Decision Record) process, preventing unauthorized or unreviewed changes.

Core Features & Use Cases

  • Process Guidance: Provides step-by-step guidance for drafting, reviewing, and accepting ADRs.
  • Status Tracking: Monitors the status of ADRs (Draft, Review, Accepted).
  • Documentation Compliance: Ensures that documentation is in Nygard format and follows house rules.
  • Prevents Unauthorized Code: Bars implementation without an accepted ADR.

Quick Start

Start a new ADR draft for adding a new endpoint by running adr draft "Adding new endpoint to API" in Athena.

Frequently Asked Questions about adr-workflow

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

FAQPage Schema
How do I enforce an ADR process for architectural changes before implementation begins?

To enforce an ADR process for architectural changes, you direct users through drafting, reviewing, and accepting Architecture Decision Records before any implementation begins, preventing unauthorized or unreviewed code from being written.

What is the ADR workflow for schema and behavioral changes in Athena?

The ADR workflow for Athena schema changes is a process that ensures proposed modifications follow proper documentation, drafting, and review stages, ultimately requiring an accepted ADR before allowing implementation.

How do I draft a new Architecture Decision Record in Nygard format?

To draft a new Architecture Decision Record in Nygard format, you start the process by creating a draft title, ensuring the subsequent documentation follows house rules and tracks status through Draft, Review, and Accepted stages.

Can I implement code changes without an accepted ADR?

No, you cannot implement code changes without an accepted ADR, because the workflow bars unauthorized code by strictly enforcing that an Architecture Decision Record reaches Accepted status before any implementation begins.

What are the limitations of relying on an ADR workflow for change management?

A limitation of relying on an ADR workflow for change management is that it bars implementation until the ADR process is fully accepted, which can delay urgent schema or architectural changes requiring immediate deployment.