HartmutandClaude Sonnet 4.6
f80808482d
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>
120 lines
2.0 KiB
Markdown
120 lines
2.0 KiB
Markdown
# Setting Up ruv-swarm Hooks
|
|
|
|
## Quick Start
|
|
|
|
### 1. Initialize with Hooks
|
|
|
|
```bash
|
|
npx claude-flow init --hooks
|
|
```
|
|
|
|
This automatically creates:
|
|
|
|
- `.claude/settings.json` with hook configurations
|
|
- Hook command documentation
|
|
- Default hook handlers
|
|
|
|
### 2. Test Hook Functionality
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```json
|
|
{
|
|
"matcher": "^(Write|Edit)$",
|
|
"hooks": [
|
|
{
|
|
"type": "command",
|
|
"command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### Automatic Testing
|
|
|
|
```json
|
|
{
|
|
"matcher": "^Write$",
|
|
"hooks": [
|
|
{
|
|
"type": "command",
|
|
"command": "test -f '${tool.params.file_path%.js}.test.js' && npm test '${tool.params.file_path%.js}.test.js'"
|
|
}
|
|
]
|
|
}
|
|
```
|