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

guardian

Monitor adr-kit Architecture Decision Records with drift checks, stale detection, and linting.

4|1|Updated Apr 25, 2026
Search Tags:#compliance#health check#ADR#LLM analysis#ADR retirement
One-click install
npx skills add https://github.com/rvdbreemen/adr-kit --skill guardian-rvdbreemen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: guardian
Source: https://github.com/rvdbreemen/adr-kit/tree/main/skills/guardian
Command: npx skills add https://github.com/rvdbreemen/adr-kit --skill guardian-rvdbreemen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The guardian Skill provides ADR-set health sweeping for adr-kit, ensuring that all relevant Architecture Decision Records are up-to-date and in compliance.

Core Features & Use Cases

  • Health Sweep: Runs due health tiers, applying a mix of responses including drift check, stale ADR detection, and linting.
  • LLM-tier Check: Performs more thorough checks with a suggested ADR review using LLM technology.
  • Team Support: Includes local hooks for individual developers and a CI-cron sweep for team visibility.

Quick Start

Run the health sweep by typing 'adr-kit:guardian'.

Frequently Asked Questions about guardian

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

FAQPage Schema
How do I run health checks for Architecture Decision Records drift and staleness?▼

ADR health checks are executed by running the 'adr-kit:guardian' command, which triggers a sweep that applies drift checks, stale ADR detection, and linting across your Architecture Decision Records repository.

Can I use LLM analysis to review Architecture Decision Records for compliance?▼

Yes, LLM analysis is available through the LLM-tier check, which performs thorough reviews of your Architecture Decision Records using LLM technology to suggest improvements and verify compliance.

Does adr-kit support automated ADR compliance sweeps in CI pipelines?▼

Automated ADR compliance sweeps are supported in CI pipelines through a CI-cron sweep feature, which provides team visibility into Architecture Decision Records health, while local hooks support individual developers.

What is ADR drift detection and when do I need it for software architecture?▼

ADR drift detection identifies when your documented Architecture Decision Records no longer match your actual software architecture. It is needed when maintaining architectural decisions to prevent documentation and implementation divergence.

What is the best way to detect and retire stale Architecture Decision Records?▼

The best way to detect and retire stale ADRs is to run an automated health sweep using adr-kit, which identifies outdated records and applies linting to ensure your Architecture Decision Records set remains compliant and current.

Related Skills

Explore More Software Engineering Skills→
simonheimlichersimonheimlicher
1

architecting-python

Generate Architecture Decision Records for Python architecture decisions.

Community
Advanced
bretbouchardbretbouchard
2

workflow-reconciliation

Reconcile workflow state across sessions to prevent checkpoint drift.

Community
Advanced
alangebalangeb

code-review-workflow

Run pyscan, pyanalyze, ruff, and black to generate a unified markdown report.

Community
Intermediate
VictorHueniVictorHueni

util-docs-audit

Audit repository documentation for staleness, broken references, and deprecated API usage.

Community
Intermediate