実際の repo 向けの spec-driven AI coding runtime。
CafeKit は skills、agents、hooks、state checks、quality gates を repo に入れ、assistant が ad-hoc prompt に流れず idea から verified implementation まで進めるようにします。
CafeKit とは#
CafeKit は AI coding assistants のための repo-local runtime bundle です。現在の package は @haposoft/cafekit で、npx @haposoft/cafekit で導入します。
Claude Code と OpenCode の上に構造化された workflow を追加します。
The docs should always point back to this contract loop.
Turn intent into scope, evidence, requirements, design, and task packets.
Implement one approved task packet, not the whole chat memory.
Run exact evidence commands and runtime checks.
Review for spec compliance, regressions, security, and drift.
Update task_registry and task markdown only after proof, or audit drift.
SDD から始める#
CafeKit は specification-driven development を中心にしています。Idea は source-backed contract になってから code になります。まず visual guide の Spec-driven development から読んでください。
その後、Core workflow → Spec lifecycle → Skills の順に深く読めます。
インストールされるもの#
CafeKit は単なる文章テンプレートではなく、動作する runtime をインストールします。
29 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
現在の package には 30 skills、13 agents、Claude Code と OpenCode の installer support、そして spec/docs bundle の deterministic validators が含まれます。
読む順番#
初めてならこの順番がおすすめです。
すでに workflow を理解している場合は Skills、Agents、Reference に進んでください。
コア方針#
CafeKit は process を削って速くするのではなく、source-backed context、明確な task boundary、fresh verification、adversarial review、state sync によって assistant を安全にします。
Task files and scope_lock define what may change.
Exact commands and runtime proof must be fresh.
Critical findings block task completion.
spec.json and markdown state move together.