Skip to content
Development
Hook

Hooks

What compound-v runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.

From plugin
compound-v
429 skills3 agents5 hooks

Claude Code

> /plugin marketplace add procoders/superpowers-v
> /plugin install superpowers-v@procoders

What fires, and when

Stop

  • "${CLAUDE_PLUGIN_ROOT}/hooks/stop.sh" || true

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.

  • "${CLAUDE_PLUGIN_ROOT}/hooks/prompt.sh" || true

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.

  • Matchesstartup|resume|clear|compact"${CLAUDE_PLUGIN_ROOT}/hooks/session.sh" || true

PreToolUse

  • MatchesWrite|Edit|MultiEdit|NotebookEdit"${CLAUDE_PLUGIN_ROOT}/hooks/guard.sh" || true

SubagentStop

  • "${CLAUDE_PLUGIN_ROOT}/hooks/subagent.sh" || true
Read hooks/hooks.json

Where it lives

  • hooks/guard.shRunsGitHub
    Read the script
    #!/usr/bin/env bash
    trap 'exit 0' EXIT
    root="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
    py="$(command -v python3)" || exit 0
    out="$("$py" -I -B "$root/scripts/compound-v.py" hook guard 2>/dev/null)" || exit 0
    [ -n "$out" ] && printf '%s\n' "$out"
    exit 0
    
  • hooks/prompt.shRunsGitHub
    Read the script
    #!/usr/bin/env bash
    trap 'exit 0' EXIT
    root="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
    py="$(command -v python3)" || exit 0
    out="$("$py" -I -B "$root/scripts/compound-v.py" hook prompt 2>/dev/null)" || exit 0
    [ -n "$out" ] && printf '%s\n' "$out"
    exit 0
    
  • hooks/session.shRunsGitHub
    Read the script
    #!/usr/bin/env bash
    trap 'exit 0' EXIT
    root="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
    py="$(command -v python3)" || exit 0
    out="$("$py" -I -B "$root/scripts/compound-v.py" hook session 2>/dev/null)" || exit 0
    [ -n "$out" ] && printf '%s\n' "$out"
    exit 0
    
  • hooks/stop.shRunsGitHub
    Read the script
    #!/usr/bin/env bash
    trap 'exit 0' EXIT
    root="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
    py="$(command -v python3)" || exit 0
    out="$("$py" -I -B "$root/scripts/compound-v.py" hook stop 2>/dev/null)" || exit 0
    [ -n "$out" ] && printf '%s\n' "$out"
    exit 0
    
  • hooks/subagent.shRunsGitHub
    Read the script
    #!/usr/bin/env bash
    trap 'exit 0' EXIT
    root="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
    py="$(command -v python3)" || exit 0
    "$py" -I -B "$root/scripts/compound-v.py" hook subagent >/dev/null 2>&1
    exit 0
    

Read the script before you install anything that runs on your machine. This is the one part of a plugin that acts without being asked.

@procoders
Ships withcompound-v

by ProCoders Give Claude Code a senior engineer's habits: it interviews the client first and proves the work before it says done.

429 skills3 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
42
Star history of procoders/superpowers-v on GitHub, a chart by star-history.com

More plugins that ship hooks.

superpowers

superpowers

A development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.

15 skills1 hook311k
@obra@obra
Install Plugin
ponytail

ponytail

A Claude Code plugin with skills for auditing a whole repo, reviewing a change, listing deferred shortcut comments, and showing measured savings and a quick command reference.

6 skills10 hooks188k
@dietrichgebert@dietrichgebert
Install Plugin
agent-skills

agent-skills

Walks a software change from a written spec through design, testing, code review, CI/CD, and release, applying the matching engineering skill at each stage. Useful for developers using Claude Code on full development workflows.

25 skills+3112k
@addyosmani@addyosmani
Install Plugin
planning-with-files

planning-with-files

Persistent file-based planning for AI coding agents on long-running, multi-step tasks. It keeps task_plan.md, findings.md and progress.md on disk, so work can resume after /clear or context compaction.

6 skills+228k
@othmanadi@othmanadi
Install Plugin
gsd-core

gsd-core

A spec-driven development workflow for Claude Code that guides a project through planning, phases, milestone audits and fixes. Includes skills to generate tests from UAT criteria and to audit completed work.

72 skills+311k
@open-gsd@open-gsd
Install Plugin
superpowers-zh

superpowers-zh

Chinese-language skill pack for Claude Code that adds workflow guidance for brainstorming, TDD, debugging, and code review, plus Chinese conventions for commits, documentation, and domestic Git platforms like Gitee and Coding.net.

21 skills1 hook8.5k
@jnmetacode@jnmetacode
Install Plugin
socraticode

socraticode

Gives Claude Code semantic search, dependency graph and architecture context over a codebase, so an AI assistant can explore and understand a project's code. Includes skills for indexing a project and managing its file watching.

2 skills+33.4k
@giancarloerra@giancarloerra
Install Plugin
cocoindex-code

cocoindex-code

A lightweight code search engine that uses AST-based semantic search with local embeddings and incremental indexing. It helps Claude Code users find code faster and more efficiently.

1 skill1 MCP+13k
@cocoindex-io@cocoindex-io
Install Plugin

Questions about the hooks in compound-v.

Which coding agents can use the hooks in compound-v?
The hooks in compound-v install in Claude Code and Cursor: each runs Claude Code hooks from .claude/settings.json, so copy the hooks there.