KeiSeiKit-1.0/settings-snippet.json
KeiSei84 3e0be312f8 feat(install): first-run /onboard nudge + normalize null hook matchers (#38)
1. SessionStart hook first-run-onboard.sh: on first Claude Code session after
   install, nudges user/Claude to run `/onboard ~/Projects/*` (scan stack +
   create a project-specialist agent per project; delegates to /new-agent).
   Fires once (marker), then silent. Wired in settings-snippet under SessionStart.
2. lib-summary next-steps: lead with /onboard ~/Projects/*, then /new-agent.
3. lib-hooks merge: normalize null/absent matcher → "" (Claude Code /doctor
   rejects null; pre-kit hooks often lack a matcher field).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 19:38:22 +08:00

296 lines
9.1 KiB
JSON

{
"_comment": "Merge these entries into your ~/.claude/settings.json under the matching keys. If you already have PostToolUse/PreToolUse/Stop arrays, append the objects below to them instead of overwriting. install.sh --activate-hooks automates the merge and de-dupes by hooks[].command. statusLine (the KeiSei tamagotchi) is set ONLY when you have none — an existing statusLine is never clobbered.",
"statusLine": {
"type": "command",
"command": "~/.claude/scripts/keisei-pet.sh",
"padding": 0
},
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/assemble-agents.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/site-wysiwyd-check.sh",
"statusMessage": "site-wysiwyd drift check..."
},
{
"type": "command",
"command": "~/.claude/hooks/post-write-check.sh",
"statusMessage": "post-write checks..."
},
{
"type": "command",
"command": "~/.claude/scripts/keisei-pet-update.sh lang"
}
]
},
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/milestone-commit-hook.sh",
"statusMessage": "milestone self-audit check (RULE 0.14)..."
},
{
"type": "command",
"command": "~/.claude/hooks/post-commit-audit.sh",
"statusMessage": "post-commit audit..."
}
]
},
{
"matcher": "Agent",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/task-timer.sh",
"statusMessage": "task duration tracker (RULE 0.18)..."
},
{
"type": "command",
"command": "~/.claude/hooks/agent-fork-done.sh",
"statusMessage": "agent-fork-done — close ledger lifecycle..."
},
{
"type": "command",
"command": "~/.claude/hooks/agent-stub-scan.sh",
"statusMessage": "STATUS-TRUTH marker scan (RULE 0.16)..."
},
{
"type": "command",
"command": "~/.claude/hooks/agent-event-done.sh"
}
]
},
{
"matcher": "ExitPlanMode",
"hooks": [
{
"type": "command",
"command": "~/.claude/scripts/keisei-pet-update.sh plan"
}
]
},
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/error-spike-detector.sh",
"statusMessage": "error-spike rolling window (RULE 0.14)..."
},
{
"type": "command",
"command": "~/.claude/hooks/agent-heartbeat-tick.sh"
}
]
}
],
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/assemble-validate.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/agent-capability-check.sh",
"statusMessage": "agent-capability-check (Agent Substrate v1, phase 4)..."
},
{
"type": "command",
"command": "~/.claude/hooks/destructive-guard.sh",
"statusMessage": "destructive-op guard..."
},
{
"type": "command",
"command": "~/.claude/hooks/block-dangerous.sh",
"statusMessage": "dangerous-command block..."
},
{
"type": "command",
"command": "~/.claude/hooks/safety-guard.sh",
"statusMessage": "safety-guard..."
},
{
"type": "command",
"command": "~/.claude/hooks/disk-headroom-check.sh",
"statusMessage": "disk headroom (RULE 0.17)..."
},
{
"type": "command",
"command": "~/.claude/hooks/no-python-without-approval.sh",
"statusMessage": "rust-first python gate (RULE 0.2)..."
},
{
"type": "command",
"command": "~/.claude/hooks/no-github-push.sh",
"statusMessage": "no-github-push guard (RULE 0.1)..."
},
{
"type": "command",
"command": "CMD=$(cat | jq -r '.tool_input.command // empty'); echo \"$CMD\" | grep -qiE 'git push.*github|gh repo (create|push|sync)' && ~/.claude/scripts/keisei-pet-update.sh github_block; exit 0"
}
]
},
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/no-hand-edit-agents.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/agent-capability-check.sh",
"statusMessage": "agent-capability-check (Agent Substrate v1, phase 4)..."
},
{
"type": "command",
"command": "~/.claude/hooks/numeric-claims-guard.sh",
"statusMessage": "numeric-claims-guard (RULE 0.18)..."
},
{
"type": "command",
"command": "~/.claude/hooks/citation-verify.sh",
"statusMessage": "citation-verify (RULE 0.4)..."
},
{
"type": "command",
"command": "~/.claude/hooks/secrets-pre-guard.sh",
"statusMessage": "secrets-pre-guard (RULE 0.8)..."
}
]
},
{
"matcher": "Read",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/tomd-preread.sh",
"statusMessage": "tomd pre-read auto-convert check..."
}
]
},
{
"matcher": "Agent",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/agent-fork-logger.sh",
"statusMessage": "agent-fork-logger (RULE 0.12)..."
},
{
"type": "command",
"command": "~/.claude/hooks/orchestrator-dirty-check.sh",
"statusMessage": "orchestrator-dirty-check (RULE 0.13)..."
},
{
"type": "command",
"command": "~/.claude/hooks/orchestrator-branch-check.sh",
"statusMessage": "orchestrator branch ownership (RULE 0.13)..."
},
{
"type": "command",
"command": "~/.claude/hooks/task-timer.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/agent-event-spawn.sh"
}
]
}
],
"UserPromptSubmit": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/recurrence-suggest.sh",
"statusMessage": "recurrence-escalate suggester (RULE 0.10)..."
},
{
"type": "command",
"command": "~/.claude/hooks/rust-first.sh",
"statusMessage": "rust-first reminder (RULE 0.2)..."
},
{
"type": "command",
"command": "~/.claude/hooks/no-downgrade.sh",
"statusMessage": "no-downgrade reminder (RULE -1)..."
},
{
"type": "command",
"command": "~/.claude/hooks/alignment-check.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/chat-numeric-prewarn.sh",
"statusMessage": "chat-numeric-prewarn (RULE 0.18)..."
},
{
"type": "command",
"command": "~/.claude/scripts/keisei-pet-update.sh prompt"
}
]
}
],
"Stop": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/session-end-dump.sh",
"statusMessage": "session-end trace dump (RULE 0.14)..."
},
{
"type": "command",
"command": "~/.claude/hooks/stop-verify.sh",
"statusMessage": "stop-verify (uncommitted/Modal-running warning)..."
},
{
"type": "command",
"command": "~/.claude/hooks/task-timer.sh"
},
{
"type": "command",
"command": "~/.claude/hooks/extract-task-durations.sh",
"statusMessage": "extract-task-durations — pull async durations from notifications..."
},
{
"type": "command",
"command": "~/.claude/hooks/chat-numeric-postflag.sh",
"statusMessage": "chat-numeric-postflag (RULE 0.18)..."
},
{
"type": "command",
"command": "~/.claude/scripts/keisei-pet-update.sh sleep"
}
]
}
],
"SessionStart": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/first-run-onboard.sh",
"statusMessage": "KeiSeiKit first-run onboard nudge..."
}
]
}
]
}
}