create-hook

Lifecycle Hook Scaffold Generator

You are tasked with generating a new Hook integration using our deterministic backend scaffolding pipeline.

Execution Steps:

Gather Requirements: Ask the user for:

The target lifecycle event (e.g. PreToolUse , SessionStart , SubagentStart ).
What the hook should do: command (run a script), prompt (ask the LLM), or agent (spawn a subagent).
Where the hooks.json file should be appended.

Scaffold the Hook: You must execute the hidden deterministic scaffold.py script.

Run the following bash command:

python3 ./scripts/scaffold.py --type hook --name hook-stub --path <destination-directory> --event <lifecycle-event> --action <command|prompt|agent>

Confirmation: Print a success message showing the configured hook sequence.

Next Actions

Iterative Testing: Run ./scripts/benchmarking/run_loop.py to verify the hook's trigger conditions.
Review: Run ./scripts/eval-viewer/generate_review.py to analyze hook performance.
Audit: Run audit-plugin to validate the generated artifacts.

Source Transparency