git:20260906.71b0371 to git:20260906.658356c

10 added, 0 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/` and ask your human to submit it upstream, following

the [Bug Reporting Guide](../BUG_REPORTING.md) (it covers the diagnostic

script, report contents, and the upstream issue tracker). That directory is

inside the working tree, so the report survives a container restart, and it

is gitignored, so it never reaches review. A path outside the repository is

refused by `project_containment`.

- **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).