Workflows
Command surface

risk に合う workflow を使う。

CafeKit は happy path だけではありません。ideation、implementation、debugging、hotfix、docs、review、sync、git、diagram workflows を含みます。

Spec-driven delivery path

The docs should always point back to this contract loop.

/hapo:specs

Turn intent into scope, evidence, requirements, design, and task packets.

/hapo:develop

Implement one approved task packet, not the whole chat memory.

/hapo:test

Run exact evidence commands and runtime checks.

/hapo:code-review

Review for spec compliance, regressions, security, and drift.

/hapo:sync

Update task_registry and task markdown only after proof, or audit drift.

Main delivery path は Core workflow で詳しく説明しています。このページは標準 feature path 以外の command selector として使います。

Core feature workflow#

CommandUse when
/hapo:specsrequirements、research、design、tasks、validation が必要。
/hapo:developspec または task file が approved で implementation ready。
/hapo:testcommands、build、tests、UI checks、runtime reachability の evidence が必要。
/hapo:code-reviewbugs、security、drift、missing proof の adversarial review。
/hapo:syncproof 後に task status、task_registry、task markdown を更新する、または drift audit/repair が必要。

Idea が曖昧、architecture が未決定、scope を pressure-test したい場合だけ、この path の前に /hapo:brainstorm を使います。

Bug and incident#

CommandUse when
/hapo:debugroot cause が不明。code change 前に evidence を作る diagnostic-first workflow。
/hapo:hotfixdiagnosis 後に小さく安全に bug を修正し regression checks を行う。

Docs and artifacts#

CommandUse when
/hapo:docs --initproject docs がない。
/hapo:docs --updatesource changes が docs refresh を必要とする。
/hapo:docs --reconstruct <scope>existing system の source-backed as-is docs が必要。
/hapo:generate-graph <request>architecture、flow、sequence、state diagram が必要。

Release#

CommandUse when
/hapo:git commitverified changes を focused conventional commit にする。
/hapo:git pushtests と review が clean で branch を publish できる。

OpenCode では /specs/develop/test/code-review のような prefix-free commands が使われます。