← ClaudeAtlas

bootstrap-hookslisted

Use when installing better-dev into a host so sessions and dispatched workers automatically notice the practices are present - wiring the SessionStart and SubagentStart awareness hooks, or adapting them for a non-Claude-Code host.
yoelgal/agent-tools · ★ 1 · AI & Automation · score 65
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