CafeKit は assistant の operating system を入れる。
package は managed skills、agents、rules、scripts、hooks、statusline、runtime config、state synchronization を project に追加します。
30 packaged workflows and domain capabilities
13 specialist agents for planning, code, QA, docs, git, and deploy
Privacy, scope, state, usage, docs sync, and spec-state gates
Runtime configuration, paths, locale, usage, and model hints
Claude Code hook wiring and statusline command
Git, context, usage, task, and agent statusline
Hooks#
Claude Code は .claude/hooks/ の CommonJS hooks を使います。Codex CLI は .codex/hooks.json の project hooks と .codex/ の rules、scripts を使います。
| Hook | Purpose |
|---|---|
privacy-block.cjs | .env、keys、credentials、tokens など sensitive files に user approval を要求します。 |
inspect-block.cjs | .git、node_modules、build outputs、広すぎる glob scans を block します。 |
rules.cjs | workflow、skill routing、docs path、modularization reminders を inject します。 |
spec-state.cjs | active spec を見つけ、state sync tollgate を inject します。 |
docs-sync.cjs | missing/stale project docs を検出します。 |
state.cjs | session state と modified-file summaries を保存します。 |
agent.cjs | subagent に path、locale、rule context を渡します。 |
usage.cjs | statusline cache 用に Claude usage limits を fetch します。 |
Validators#
node .claude/scripts/validate-spec-output.cjs specs/<feature>
node .claude/scripts/validate-docs.cjs docs
node .claude/scripts/validate-docs-reconstruct.cjs docs/as-is/<scope>
node .claude/scripts/generate-skill-catalog.cjs --skills
validators は hard backstop です。prompt instructions は drift しますが、scripts は drift しないようにします。
State model#
plan.mdは C1 scope、acceptance criteria、exclusions、C2 decisions、task map を保持します。task-NN-*.mdは oneStatus:、outcome、ownership、dependencies、proof command、final inline## Receiptを保持します。
Controller は observed state と proof だけを sync します。Chat は source of truth ではなく、legacy packet は separate adapter を維持します。