hf.enforce-plan-and-explore

You can enforce planning before editing Python source code by using a PreToolUse hook that warns when edits are attempted without prior exploration or a documented plan. This guardrail ensures deliberate code changes.

A PreToolUse guardrail for code edits is a hook that intercepts edit operations to check for prior exploration and planning. It specifically targets Python source edits while ignoring test and config files to maintain workflow discipline.

To stop repeated warnings for missing exploration during a coding session, the guardrail uses marker files and environment markers. It only warns once per session within a four-hour window to avoid interruptions.

No, the planning enforcement hook does not apply to test files and config files. It specifically targets Python source edits and skips non-relevant files to focus on core code changes.

Yes, you need jq and md5 installed because the guardrail implements its exploration and planning checks via marker files and environment markers that rely on these dependencies.

You should not use an automated planning guardrail for Python edits if your workflow requires rapid, undocumented changes outside the four-hour session window, as it enforces deliberate exploration before allowing source modifications.