bootstrap-hookslisted
Install: claude install-skill yoelgal/agent-tools
# Bootstrap awareness hooks
A skill only helps if the agent knows it's there. better-dev leaves a discovery block in the
project's `CLAUDE.md` (or `AGENTS.md`) for exactly that, but a fresh session - or a subagent spun up
mid-task - may start before it reads that file. These hooks close the gap: on session start, and
again when a worker is dispatched, they emit a short note that better-dev's practices are installed
here and where the project's overrides live. One job: **keep the agent aware that better-dev is
present, without ever blocking it.**
They add awareness only. They never gate a session, never fail loudly, and stay silent in any repo
that doesn't have better-dev installed.
## What ships
Two extensionless bash scripts and a manifest, all under `hooks/`:
- `bd-session-start` - fires on session `startup`, `resume`, `clear`, and `compact`. If the working
directory sits inside a repo with a `.better-dev/` scaffold, it emits a one-paragraph pointer to
the better-dev discovery block and, when the project has one, to `.better-dev/overrides.md` so the
agent reads project overrides before applying any built-in default. It also appends a one-line
update nudge when the installed better-dev clone (its plugin root) is behind its origin - a
best-effort `git fetch` bounded to 2 seconds, well inside the hook's own 5-second host timeout, so a
slow remote can cost the nudge but never starve the awareness note the hook exists to deliver. It
degrades to a silent no-op