hook-enforcement-audit

Audits Claude Code hook enforcement settings and identifies advisory-only gaps.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Nerfherder16/BrickLayer --skill hook-enforcement-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-enforcement-audit
Source: https://github.com/Nerfherder16/BrickLayer/tree/main/.claude/skills/hook-enforcement-audit
Command: npx skills add https://github.com/Nerfherder16/BrickLayer --skill hook-enforcement-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a Claude Code hook system (settings.json + hook .js files) to identify where enforcement infrastructure is built but deliberately softened to advisory-only.

Core Features & Use Cases

  • Build inventory of hooks from settings.json; identify event → hook file pairs and whether the file exists
  • Classify each hook's authority (hard block, advisory, advisory+flag, inject, pass-through) and map enforcement vs advisory
  • Check receipt/state patterns (e.g., masonry-state.json) to determine if compliance is tracked or stale
  • Generate findings tables and actionable remediation steps for gaps, with prioritized tiers
  • Produce deployment prerequisites and enablement guidance for enforcement flags if prerequisites are met

Quick Start

Run the hook-enforcement-audit against your Claude Code setup to identify advisory vs enforcement gaps

Frequently Asked Questions about hook-enforcement-audit

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

FAQPage Schema
How do I audit Claude Code hooks to find advisory-only enforcement gaps?

To audit Claude Code hooks for enforcement gaps, analyze settings.json entries and registered hook files to classify authority levels, distinguishing hard block behavior from advisory-only configurations. The audit generates findings tables with prioritized remediation steps to restore enforcement coverage.

What is the difference between hard block and advisory hooks in Claude Code settings?

Hard block hooks actively prevent operations, while advisory hooks only warn or flag without stopping execution. The hook-enforcement audit classifies each hook's authority by analyzing settings.json and hook files to surface where infrastructure was deliberately softened to advisory-only.

How do I check if Claude Code compliance state receipts are stale?

Check compliance state receipts by analyzing state files like masonry-state.json within your Claude Code deployment. The audit examines receipt patterns to determine if compliance tracking is active or stale, identifying gaps in enforcement coverage.

Can I use this hook audit for Claude Code deployments managed with settings.json?

Yes, the hook audit applies to Claude Code deployments relying on settings.json and hook .js files. It is designed for developers auditing security, config managers, and platform operators seeking to verify enforcement coverage and identify advisory-only gaps.

How do I remediate hook enforcement gaps found in Claude Code?

Remediate hook enforcement gaps by following the prioritized remediation steps generated by the audit. The audit produces deployment prerequisites and enablement guidance for enforcement flags when prerequisites are met, ensuring advisory hooks transition to hard block enforcement.