adr-compliance-check

Validate PRs against ADR redlines for port purity and drift-guard wiring.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Linnanli/xClaw --skill adr-compliance-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-compliance-check
Source: https://github.com/Linnanli/xClaw/tree/main/skills/adr-compliance-check
Command: npx skills add https://github.com/Linnanli/xClaw --skill adr-compliance-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Addresses ADR redline violations by enforcing verbatim port purity, drift-guard wiring, and PR description citations to maintain architectural discipline before merges.

Core Features & Use Cases

  • Verbatim port purity checks for ADR-aligned crates and interfaces.
  • Drift-guard wiring validation to ensure changes connect to ADR references and CI checks.
  • PR description verification requiring ADR/issue citations and consistent PR structure.
  • .ironclaw literal ban enforcement and starlark pin consistency.
  • Provides actionable remediation guidance and blocks merging when violations are detected.

Quick Start

Review the current Git changes and PR description against ADR redlines to determine whether the patch should be blocked.

Frequently Asked Questions about adr-compliance-check

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

FAQPage Schema
How do I enforce ADR compliance in PR reviews before merging?

ADR compliance in PR reviews is enforced by validating verbatim port purity, drift-guard wiring, and mandatory ADR citations in PR descriptions to block redline violations before merging.

What is verbatim port purity and how does it relate to architecture governance?

Verbatim port purity ensures ADR-aligned crates and interfaces remain unmodified during code changes. It enforces architecture governance by detecting and blocking unauthorized structural drift in specified paths.

How do I check if a PR description includes required ADR citations?

PR description verification checks for explicit ADR or issue citations within the PR text. This ensures changes maintain architectural discipline and provide safe, auditable merge references.

Can I use this to ban specific string literals like .ironclaw in git commits?

Yes, literal ban enforcement blocks specific strings like .ironclaw from being introduced in changes. It also validates starlark pin constraints to maintain CI workflow consistency.

What's the best way to prevent architecture drift in ADR-related CI workflows?

Preventing architecture drift requires validating drift-guard wiring to ensure changes connect to ADR references and CI checks. This blocks unauthorized modifications and provides actionable remediation guidance.

Do I need git and starlark configurations to validate ADR redlines?

Git and starlark configurations are necessary to validate ADR redlines. The process checks starlark pin constraints, reviews git changes, and ensures PR structure aligns with ADR requirements.