lint

Lint Architecture Decision Records for completeness, evidence, clarity, and consistency.

4|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rvdbreemen/adr-kit --skill lint-rvdbreemen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/rvdbreemen/adr-kit/tree/main/skills/lint
Command: npx skills add https://github.com/rvdbreemen/adr-kit --skill lint-rvdbreemen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of linting Architecture Decision Records (ADRs) to ensure they meet compliance standards, validate status histories, and maintain consistency.

Core Features & Use Cases

  • ADR Linting: Automatically verify ADRs against predefined gates for completeness, evidence, clarity, and consistency.
  • Status History Audit: Validate the chronological accuracy and integrity of the ADR status history.
  • Configurable Rules: Apply project-specific linting rules and ignore older ADRs for a less strict assessment.
  • Use Case: For a software development team, use this Skill to ensure all ADRs are up to date and adhere to project standards before they are merged into the main codebase.

Quick Start

Run the 'adr-kit lint' command to check ADR compliance in the current directory.

Frequently Asked Questions about lint

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

FAQPage Schema
How do I lint Architecture Decision Records for compliance and consistency?

To lint Architecture Decision Records, run the 'adr-kit lint' command to automatically verify ADRs against predefined gates for completeness, evidence, clarity, and status history accuracy.

What is ADR status history validation and why does it matter?

ADR status history validation checks the chronological accuracy and integrity of status transitions in Architecture Decision Records. It ensures that the progression of decisions remains consistent and auditable.

Can I configure project-specific linting rules for ADRs?

Yes, you can configure project-specific linting rules for ADRs. This includes applying custom gates and ignoring older ADRs to perform a less strict assessment on legacy project records.

Do I need Python to run ADR linting checks?

Yes, you need Python installed because the ADR linting scripts require a Python environment to execute the 'adr-kit lint' command and validate your records.

What's the best way to ensure ADRs meet project standards before merging?

The best way to ensure ADRs meet project standards is running automated linting checks to verify completeness, evidence, and clarity before merging the records into the main codebase.