1つの feature を verified loop に通す。
spec を作り、validate し、1つの task packet を実装し、test、review、proof 後の sync まで進めます。
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_files、task_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 の理由を詳しく確認できます。
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.