git:20260910.637bc0e to git:20260914.b5284d3

4 added, 7 removed. Audit A to A.

# DO NOT EDIT - Hooks Daemon Internal Source Code

**IF YOU ARE WORKING ON A PROJECT THAT HAS HOOKS DAEMON INSTALLED — YOU MUST

NOT EDIT ANYTHING IN THIS FOLDER.**

This is the daemon's own source code: an upstream dependency, not part of your

project. Editing files here breaks your installation, is overwritten on the

next daemon update, and creates conflicts that prevent future upgrades.

**Unless this repository IS the daemon.** In self-install (dogfood) mode the

daemon's source and the project are the same checkout, so there is no upstream

to be overwritten by and editing here is the normal way to work — see

[SELF_INSTALL.md](../CLAUDE/SELF_INSTALL.md). The heading above is addressed to

a CLIENT project that installed the daemon under `.claude/hooks-daemon/`; it is

not a claim that these files are untouchable everywhere. Check which case you

are in before concluding an instruction to edit `src/` is a mistake: two

sub-agents working on daemon source have now read this page as forbidding their

assigned task, and one classified it as injected content.

## Do This Instead

- **Custom handler behaviour** — create project-level handlers in YOUR repo

(`.claude/hooks-daemon/bin/hooks-daemon init-project-handlers` scaffolds

them; they are auto-discovered). See

[Project-Level Handlers Guide](../CLAUDE/PROJECT_HANDLERS.md).

- - **Found a bug** — do NOT fix it here. Write a report to

- `untracked/scratch/` (inside the working tree, so it survives a container

- restart; gitignored, so it never reaches review) and ask your human to

- submit it upstream, following the

- [Bug Reporting Guide](../BUG_REPORTING.md). Why that directory rather than

- a temp path, and what `project_containment` does and does not catch, is

- the handler's own guidance: `bin/hooks-daemon explain-handler project_containment`.

+ - **Found a bug** — do NOT fix it here. Use the `hooks-daemon` skill with args

+ `issue-report`, or read the [Bug Reporting Guide](../BUG_REPORTING.md);

+ working notes go under `untracked/scratch/` (see

+ `explain-handler project_containment` for why not a temp path).

- **Change handler configuration** — edit your project's

`.claude/hooks-daemon.yaml` (that IS yours: enable/disable handlers, set

priorities and options).

- **Understand how something works** — read the docs, not the source:

[ARCHITECTURE.md](../CLAUDE/ARCHITECTURE.md),

[HANDLER_DEVELOPMENT.md](../CLAUDE/HANDLER_DEVELOPMENT.md),

[PROJECT_HANDLERS.md](../CLAUDE/PROJECT_HANDLERS.md),

[DEBUGGING_HOOKS.md](../CLAUDE/DEBUGGING_HOOKS.md).