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

Ready to run

npx skills add https://github.com/rvdbreemen/adr-kit --skill guardian-rvdbreemen

💬 Prompt for ChatGPT / Claude Chat▼

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.