Files

T

HartmutandClaude Sonnet 4.6 f80808482d chore: restore .claude commands, agents, helpers & skills (lost in 1df208d)

Restores the entire .claude/ infrastructure that was accidentally deleted
in commit 1df208d ('feat(timeline): add pulse animation for in-flight drag
mutations'). Recovered via git checkout 1df208d^.

Restored:
- .claude/commands/ (gitlooper, sparc/, github/, automation/, monitoring/,
  optimization/, hooks/, plan, implement, research, review, perf, visualaudit)
- .claude/agents/ (core/, github/, sparc/, v3/, swarm/, templates/, ...)
- .claude/helpers/ (41 scripts incl. hook-handler.cjs, statusline.cjs)
- .claude/skills/ (20 skills incl. sparc-methodology, github-*, v3-*)
- .claude/settings.json (hooks configuration)

Also updated all CapaKraken → Nexus references in affected command files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-08-15 11:43:52 +02:00

2.0 KiB

Raw Blame History

Setting Up ruv-swarm Hooks

Quick Start

1. Initialize with Hooks

npx claude-flow init --hooks

This automatically creates:

.claude/settings.json with hook configurations
Hook command documentation
Default hook handlers

2. Test Hook Functionality

# Test pre-edit hook
npx claude-flow hook pre-edit --file test.js

# Test session summary
npx claude-flow hook session-end --summary

3. Customize Hooks

Edit .claude/settings.json to customize:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "^Write$",
        "hooks": [
          {
            "type": "command",
            "command": "npx claude-flow hook pre-write --file '${tool.params.file_path}'"
          }
        ]
      }
    ]
  }
}

Hook Response Format

Hooks return JSON with:

continue: Whether to proceed (true/false)
reason: Explanation for decision
metadata: Additional context

Example blocking response:

{
  "continue": false,
  "reason": "Protected file - manual review required",
  "metadata": {
    "file": ".env.production",
    "protection_level": "high"
  }
}

Performance Tips

Keep hooks lightweight (< 100ms)
Use caching for repeated operations
Batch related operations
Run non-critical hooks asynchronously

Debugging Hooks

# Enable debug output
export CLAUDE_FLOW_DEBUG=true

# Test specific hook
npx claude-flow hook pre-edit --file app.js --debug

Common Patterns

Auto-Format on Save

Already configured by default for common file types.

Protected File Detection

{
  "matcher": "^(Write|Edit)$",
  "hooks": [
    {
      "type": "command",
      "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
    }
  ]
}

Automatic Testing

{
  "matcher": "^Write$",
  "hooks": [
    {
      "type": "command",
      "command": "test -f '${tool.params.file_path%.js}.test.js' && npm test '${tool.params.file_path%.js}.test.js'"
    }
  ]
}

2.0 KiB Raw Blame History