audit-rules

Audits global and project rules for conflicts and generates a findings report.

2|Updated Dec 20, 2020
One-click install
npx skills add https://github.com/buvis/home --skill audit-rules-buvis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-rules
Source: https://github.com/buvis/home/tree/main/.claude/skills/audit-rules
Command: npx skills add https://github.com/buvis/home --skill audit-rules-buvis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits rule definitions across global and project scopes to uncover contradictions, redundancies, shadowing, and staleness, and outputs a structured report to support governance and compliance.

Core Features & Use Cases

  • Collect global rule files (and CLAUDE.md) to map the baseline guidance that applies across the system.
  • Collect project-level overrides to identify where rules diverge, shadow, or stale-reference the global guidance.
  • Analyze collected rules for contradictions, redundancy, and staleness across scopes, and generate a prioritized findings report with file-level context and suggested fixes.
  • Enable governance reviews and CI checks to maintain consistency and traceability of rule guidance.

Quick Start

Run the audit-rules workflow to scan all global and project rules and generate a findings report.

Frequently Asked Questions about audit-rules

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

FAQPage Schema
How do I detect conflicts between global rules and project overrides?▼

Detect conflicts between global rules and project overrides by running an audit that scans global rule files, CLAUDE.md documents, and project-level settings to surface contradictions, redundancies, shadowing, and staleness across scopes.

What causes shadowing and staleness in CLAUDE.md rule definitions?▼

Shadowing and staleness in CLAUDE.md rule definitions occur when project-level overrides diverge from or contain outdated references to the global baseline guidance, causing inconsistencies in applied rule behavior across different scopes.

Can I integrate rule guidance audits into CI reviews for governance?▼

Yes, you can integrate rule guidance audits into CI reviews for governance by generating a structured findings report that details affected files, prioritized inconsistencies, and suggested fixes suitable for automated policy checks.

How do I generate a prioritized findings report for rule inconsistencies?▼

Generate a prioritized findings report for rule inconsistencies by analyzing collected global and project rules for contradictions and redundancy, producing a structured output with file-level context and suggested fixes.

Does rule auditing work without external dependencies or components?▼

Yes, rule auditing works without external dependencies or components, relying solely on the existing global rule files, project overrides, and CLAUDE.md documents present in your environment to map and analyze guidance.