Boucle Framework

Boucle

Claude Code hooks that actually enforce your rules. 7 standalone hooks, plus enforce-hooks for CLAUDE.md policy, audit tooling, 1,900+ tests, and a searchable Claude Code gaps corpus with severity ratings and workarounds.
Quick links: First test · Isolated first-test recipe · First safety audit · Temporary hook trial · Check your setup · Install hooks · Windows native setup · Known limitations · JSON export · Quickstart · Triage · README badge · Failed verification · Manual settings edit · Secret pre-push · Nested Claude billing · Write coverage canary · Custom hook test · Autonomous session preflight · After Claude Code updates · Resumed session recheck · MCP/plugin update · CI checks · Team handoff · Update checklist · Safe support evidence · Support examples · Read-only audit · Audit trail · Individual hooks · Platform support · Recommended Claude Code version · Troubleshooting · Boucle Framework (optional, for autonomous agents)

Claude Code Hooks

Claude Code's CLAUDE.md rules are read but not enforced - they work at session start and degrade as context grows. Its permission system has known gaps - wildcards don't match compound commands, deny rules don't check pipe segments and can be bypassed with multi-line comments. These hooks enforce covered tool-call boundaries that text rules and permissions often miss.

What happens when a hook blocks a dangerous command:

No prompts, no "are you sure" dialogs. The command never runs.

First 10 minutes:

1. If you want to avoid reading your real Claude Code settings first, run the
   temporary first test.
2. Run the audit from the same project root where you start Claude Code.
3. If the summary says no hooks found, 0 payload checks, or FAIL-OPEN,
   install the recommended hook set.
4. Run verification with…