skills.rest
gaberger
gabergerCOMMUNITY
Explore all skills by this author →
GitHub

hex-adr-status

Scan docs/adrs to extract statuses, references, and dates for ADR health reports.

4|Updated Mar 16, 2026
Search Tags:#architecture#codebase#adr#governance#lifecycle#adrs#decision-records
One-click install
npx skills add https://github.com/gaberger/hex --skill hex-adr-status
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hex-adr-status
Source: https://github.com/gaberger/hex/tree/main/.claude/skills/hex-adr-status
Command: npx skills add https://github.com/gaberger/hex --skill hex-adr-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR lifecycles can drift, causing stale or conflicting decisions that slow progress and introduce risk.

Core Features & Use Cases

  • Read ADR files from docs/adrs, parse statuses and references, and compile a health report.
  • Flag stale, abandoned, or conflicting ADRs, and surface numbering gaps or missing references to enforce consistency.
  • Suggest remediation actions and potential renumbering or archival tasks to restore clarity in the ADR set.

Quick Start

Run hex adr status to generate an ADR health report and identify stale, abandoned, or conflicting decisions.

Frequently Asked Questions about hex-adr-status

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

FAQPage Schema
How do I check the health of my architecture decision records?▼

To check architecture decision records health, run a status scan on the docs/adrs directory to extract statuses, references, and dates. This generates a report flagging stale, abandoned, or conflicting ADRs to help you prioritize fixes.

What causes stale or conflicting ADRs in a codebase?▼

Stale or conflicting ADRs occur when architecture decision records lifecycles drift over time. Scanning docs/adrs identifies missing references, numbering gaps, and abandoned decisions that introduce risk and slow progress.

Can I detect missing references and numbering gaps in my ADR documentation?▼

Yes, you can detect missing references and numbering gaps by validating ADR integrity. Scanning the docs/adrs directory checks for consistency with accepted decisions and surfaces structural inconsistencies in your architecture decision records.

How do I remediate abandoned architecture decision records?▼

To remediate abandoned architecture decision records, generate a health report to identify stale or conflicting files. The report suggests remediation actions, potential renumbering, and archival tasks to restore clarity in the ADR set.

Does ADR health monitoring work for repositories without an established governance workflow?▼

ADR health monitoring is designed for repositories with existing ADR workflows. It requires architecture decision records stored in a docs/adrs directory to scan statuses, references, and dates for governance and lifecycle validation.

Related Skills

Explore More Software Engineering Skills→
joestumpjoestump
30

prime

Load ADR and openspec documents into conversational context with semantic topic filtering.

Community
Intermediate
zthanoszthanos

Architecture Decision Records

Generate, evaluate, patch, and recheck Architecture Decision Records from requirements and diagrams.

Community
Advanced
ghalacticghalactic
2

adr-skill

Create, maintain, and review Architecture Decision Records in a repository.

Official
Intermediate
chaimtchaimt

architect-analyze

Detect drift and quality gaps between ADRs and Architecture Description.

Community
Advanced