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.