クイックスタート
First run

1つの feature を verified loop に通す。

spec を作り、validate し、1つの task packet を実装し、test、review、proof 後の sync まで進めます。

CafeKit が初めてですか? このページは workflow を知っている方向けのリファレンスです。ゼロから始める場合はステップ式チュートリアルをご利用ください — インストール前から最初の verified feature まで案内します。

1. Install CafeKit#

npx @haposoft/cafekit

Idea が specs に入れるほど明確でない場合だけ、先に /hapo:brainstorm で scope と architecture を明確にします。Main delivery run は specs から始まります。

2. Spec を作る#

/hapo:specs Build a meeting transcript extension with AI summaries

CafeKit は次を生成します。

specs/<feature>/
├── spec.json
├── requirements.md
├── research.md
├── design.md
└── tasks/task-R0-01-*.md

3. Code 前に validate#

/hapo:specs --validate <feature>

requirements、design、task files、task_filestask_registry の整合性を確認します。

4. 1つの task packet を実装#

/hapo:develop <feature> tasks/task-R0-01-project-scaffold.md

task-by-task が最も安全な default です。diff が小さく、evidence も検証しやすくなります。

5. Test and review#

/hapo:test --full
/hapo:code-review --pending

NO_TESTS は success ではありません。implementation、evidence、tests、review、state sync が揃って初めて task は done になります。

6. Proof 後に sync#

/hapo:sync <feature> task-R0-01-project-scaffold.md done

この command は spec.json.task_registry と matching task markdown を更新します。State が不整合に見える場合は、推測せず /hapo:sync audit <feature> を実行します。

Core workflow で各 gate の理由を詳しく確認できます。

Scope

Task files and scope_lock define what may change.

Evidence

Exact commands and runtime proof must be fresh.

Review

Critical findings block task completion.

Sync

spec.json and markdown state move together.