Where should my ADRs be located for this skill to work?

The skill specifically looks for ADR Markdown files within the docs/adrs/ directory of your repository.

What does this skill do for my ADRs?

It scans your ADR directory to ensure all cross-references (like 'supersedes' or 'extends') are valid, detects circular logic, and flags potential conflicts between different architectural decisions.

Does it support automatic fixing of broken links?

In interactive mode (without the --report-only flag), the skill can automatically update ADR statuses and add reciprocal links to fix common integrity issues.

How does the skill handle domain conflicts?

It groups ADRs by their domain field and flags instances where multiple ADRs marked as 'Accepted' exist in the same domain, suggesting a potential logical overlap or conflict.

Can I use this to audit documentation without changing files?

Yes, by using the --report-only flag, the skill will generate a detailed validation report without prompting you to make any changes to the ADR files.

ADR Integrity Validator

Name: ADR Integrity Validator
Author: laurigates

bylaurigates

•

Aprendizaje y Documentación

Ensures consistency and integrity across Architecture Decision Records by validating references, detecting circular dependencies, and identifying domain conflicts.

This skill automates the auditing and maintenance of Architecture Decision Records (ADRs) within a project's documentation. It parses Markdown frontmatter to verify that 'supersedes' and 'extends' relationships are reciprocal and valid, checks for circular dependencies in the decision graph, and identifies potential domain conflicts. Designed for teams managing long-term projects, it helps ensure that architectural history remains accurate, navigable, and logically sound through automated reporting and interactive remediation.

Características Principales

01Identifies potential domain-level conflicts among accepted architectural decisions

02Validates supersedes, extends, and related ADR references for reciprocal integrity

0310 GitHub stars

04Detects circular chains and self-references within the decision documentation graph

05Generates comprehensive validation reports with clear success, warning, and error indicators

06Offers interactive remediation to automatically update statuses and fix broken links

Casos de Uso

01Auditing architectural documentation integrity before a major software release

02Synchronizing documentation after refactoring sessions that invalidate previous decisions

03Standardizing ADR metadata and relationship structures across large, multi-domain repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins blueprint-adr-validate

For use in Claude.ai and ChatGPT

Download Skill