skills.rest
rvdbreemen
rvdbreemenCOMMUNITY
Explore all skills by this author →
GitHub

retire

Audit Architecture Decision Records for staleness, technology removal, and supersession.

4|1|Updated Apr 25, 2026
Search Tags:#adr#audit#code governance#retirement#architecture decision records
One-click install
npx skills add https://github.com/rvdbreemen/adr-kit --skill retire
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: retire
Source: https://github.com/rvdbreemen/adr-kit/tree/main/skills/retire
Command: npx skills add https://github.com/rvdbreemen/adr-kit --skill retire

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of auditing and recommending retirement for Accepted Architecture Decision Records (ADRs), reducing manual effort and ensuring up-to-date documentation.

Core Features & Use Cases

  • Automated Audit: Performs a deterministic audit of ADRs based on staleness, technology removal, supersession, and enforcement policy signals.
  • Ranked Candidates: Provides a ranked list of ADR candidates for possible retirement for human review.
  • Read-Only: Never modifies ADRs, ensuring preservation of original records.
  • Use Case: Ideal for projects where ADRs need to be periodically reviewed for relevance and updated in line with current architectural practices.

Quick Start

Run the 'retire' skill on your ADR directory to get a list of candidates for retirement.

Frequently Asked Questions about retire

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

FAQPage Schema
How do I identify out-of-date Architecture Decision Records for retirement?▼

To find ADRs for retirement, run an automated audit that scans ADR directories for staleness, technology removal, supersession, and enforcement policy signals, generating a ranked list of candidates for human review.

What signals indicate that an ADR should be retired?▼

Staleness, technology removal, supersession by newer Architecture Decision Records, and enforcement policy violations are the specific signals audited to identify and rank ADR retirement candidates.

Does auditing ADRs for retirement modify the original architecture decision records?▼

No, the ADR retirement audit operates strictly in read-only mode, ensuring the preservation of original architecture decision records while producing a ranked list of candidates for human review.

What is the best way to streamline an ADR audit process?▼

The best way to streamline an ADR audit process is to automate the review of Accepted Architecture Decision Records using deterministic signals like staleness, technology removal, and supersession, which reduces manual effort and outputs a ranked list of retirement candidates.

Do I need a specific directory structure to audit ADRs for retirement?▼

Yes, you need access to ADR directories containing your architecture decision records; the audit requires access to ADR directories to scan and evaluate records against retirement signals without modifying them.

Related Skills

Explore More Software Engineering Skills→
arbiterForgearbiterForge
139

decision-lifecycle

Author and track numbered, dated architecture decision records with user attribution.

Official
Advanced
jellydnjellydn
114

adr

Create, organize, and maintain Architecture Decision Records using a standard template.

Community
Basic
LSDIPPOLLCLSDIPPOLLC

linear-adr

Create and manage Architecture Decision Records as Linear issues with linked documents.

Official
Intermediate
SebastienDegodezSebastienDegodez
8

architecture-decisions

Create, review, and manage architecture decision records with templates and status tracking.

Community
Advanced