実際の 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 と Codex CLI の上に構造化された 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 process-first Status and inline Receipt 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 をインストールします。
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
現在の package には 18 core skills と 6 optional document/multimodal skills、13 agents、Claude Code と Codex CLI の 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 を安全にします。
Accepted C1 scope plus task Ownership define what may change.
Exact commands and runtime proof must be fresh.
Critical findings block task completion.
Task Status and inline Receipt move together.