Hooks

SessionStart

Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-blackbox-capture.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-start-bootstrap.sh

UserPromptSubmit

Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-manual-test-grant.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/auto-approve-gate.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-rag-inject.sh

SubagentStart

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-subagent-start.sh

SubagentStop

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-blackbox-capture.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-subagent-stop.sh

Stop

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/friction-logger.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/enforce-violations.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-verify-before-claim.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-run-pending-tests.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-comms-output-gate.sh

PostToolUseFailure

• Matches.*bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-blackbox-capture.sh

PreCompact

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-precompact.sh

PostCompact

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-blackbox-capture.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-postcompact.sh

SessionEnd

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-session-end.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-pressure-audit.sh

CwdChanged

• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-blackbox-capture.sh
• bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-cwd-changed.sh

PreToolUse

• MatchesExitPlanModebash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-exit-plan.sh
• MatchesReadbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-read-junk-gate.sh
• MatchesReadbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-read-rag.sh
• MatchesGrep|Read|Globbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-debug-code-gate.sh
• MatchesWrite|Edit|NotebookEditbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-state-write-gate.sh
• MatchesWrite|Edit|NotebookEditbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-pre-write-dispatch.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/pre-validate-file.sh
• MatchesTaskbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-dispatch-discipline.sh
• MatchesBashbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-worktree-safety.sh
• MatchesBashbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-bash-write-gate.sh
• MatchesWritebash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-test-file.sh
• MatchesWritebash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-design-doc.sh
• MatchesWritebash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-memory-policy-guard.sh

PostToolUse

• MatchesBashbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/inject-tier-workflow.sh
• MatchesWebFetch|WebSearchbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-web-capture.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-file.shbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-output-compress.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-bible-authoring-push.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-handoff.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate-rules.sh
• MatchesWrite|Edit|NotebookEditbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-posttool-rag.sh
• MatchesWritebash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-quality-judge.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-mark-pending-test.sh
• MatchesWrite|Editbash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/writ-memory-capture.sh