Skip to content
TakoAPI
Back to skills

wip-file-guard

by parkertoddbrooks

Coding Agents & IDEs
561Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Hook that blocks destructive edits to protected identity files.

Description

What This Skill Does

A hook that intercepts Write and Edit operations on protected identity files before they execute. Write is always blocked on protected files; Edit is blocked when it removes more than 2 net lines. Works with Claude Code CLI and OpenClaw.

Unlike prompt-based instructions that get erased during context compaction, this hook enforces file protection at the tool call level regardless of agent state.

When to Use It

  • Prevent Claude from overwriting CLAUDE.md during a long session
  • Keep MEMORY.md intact after context compaction resets agent behavior
  • Block accidental deletion of SOUL.md or IDENTITY.md mid-task
  • Protect journal or daily log files from bulk replacement
  • Enforce append-only edits to shared context files in multi-agent setups

Example Workflow

INPUT

User asks: 'Rewrite CLAUDE.md with updated instructions'

AGENT
  1. 1

    Agent issues a Write call targeting CLAUDE.md

  2. 2

    Hook intercepts the PreToolUse event and checks the filename against the protected list

  3. 3

    Hook denies the Write operation and returns a message instructing the agent to use Edit instead

  4. 4

    Agent retries with an Edit call

  5. 5

    Hook checks net line removal; if under 2 lines removed, the edit proceeds

OUTPUT

Edit is allowed or blocked based on net line change, and CLAUDE.md is never fully overwritten

Installation

clawhub install parkertoddbrooks/wip-file-guard

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links