CafeKit runtime検証可能な AI coding のために
ad-hoc prompt を、spec、task boundary、verification gate、state sync を持つ delivery flow に変えます。Claude Code を優先し、OpenCode もサポートします。
npx @haposoft/cafekit最初の prompt から verified release まで
CafeKit は repo に operating layer を追加します。spec 作成、task packet 分割、1 task ずつの実装、test/review、state sync、既存 stack への release handoff までをつなぎます。
runtime を repo にインストール
Claude Code または OpenCode project に CafeKit を bootstrap します。application code は変更しません。
skills、agents、hooks、rules、statusline、workflow context を `.claude` または `.opencode` に配置します。
version metadata と ownership manifest を記録し、次回 install でも user edits を preserve します。
長い prompt 依存ではなく、repo を spec-driven command surface に移行します。
project root で `npx @haposoft/cafekit` を実行します。
repo は project-local runtime で `hapo:*` workflows を実行できる状態になります。
差別化ポイント
CafeKit は長い prompt で agent を賢く見せるのではなく、state、artifacts、gates を持つ runtime に agent を置き、見せかけの進捗を防ぎます。
CafeKit なし
毎回の session で context、scope、進め方を説明し直す必要がある
最初の coding pass 後に spec と implementation がずれやすい
build、test、runtime proof が不足していても task が done に見える
docs が最後に回され、部分更新または未更新になりやすい
CafeKit あり
spec が validation、task registry、readiness gate を持つ artifact になる
completion criteria と Evidence を持つ task packet 単位で実装が進む
quality gate が fake progress を止めてから state を done に sync する
docs checkpoint は release 直前ではなく verified task ごとに実行される
CafeKit が repo にインストールするもの
installer は `.claude` または `.opencode` に workflow/runtime infrastructure だけを追加します。実際の feature workflow を始めるまで app code は変更されません。
.claude/skills
question、brainstorm、specs、develop、test、review、docs、sync、git の command surface を作る skills。
.claude/hooks
state/spec drift の reminder、sensitive read の block、session context injection、usage update を担う hooks。
.claude/agents
inspect、spec、develop、test、review、docs、git、deployment handoff を担う subagents。
.claude/rules
scope、spec state、quality gate、docs sync、Git handoff を揃える operating rules。
アプリ本体のコード
install 中は変更されません。CafeKit が app code を触るのは、明確な implementation task を渡した後だけです。
runtime をインストールし、最初の flow を実行
CafeKit をインストールし、validated spec を作成し、Evidence 付き task を実装してから Git handoff 前に test/review します。
# 1. CafeKit をインストール$ npx @haposoft/cafekit# 2. spec を作成して validate$ /hapo:specs Build a user authentication system$ /hapo:specs --validate user-authentication# 3. task packet を1つずつ実装$ /hapo:develop user-authentication task-R0-02-auth-setup-dual-mode.md# 4. candidate を test/review$ /hapo:test --full$ /hapo:code-review --pending# 5. commit, push, release handoff$ /hapo:git commit$ /hapo:git push$ vercel --prod
CafeKit が初めてですか？
未導入の repo から、spec、task、verification receipt を持つ最初の feature まで進めます。
各ステップ後に残る real Artifacts
CafeKit は files、registry、receipt を残し、reviewer が ready な task と evidence 不足の task を判断できるようにします。
ドキュメントを見るphase、validation status、task registry、readiness gate の machine state。
objective、scope boundary、completion criteria、Evidence commands を持つ task packet。
merge、Git handoff、release の準備ができているかを示す structured verdict。
お問い合わせ
プロジェクトについてお知らせいただくか、ご質問をお寄せください。通常1営業日以内にご返信いたします。