Use the workflow that matches the risk.
CafeKit ships more than the happy path. It includes ideation, implementation, debugging, hotfixing, docs, review, sync, git, and visual diagram workflows.
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 task_registry and task markdown only after proof, or audit drift.
The main delivery path is explained in depth in Core workflow. Use this page as the command selector when the work is not the standard feature path.
Core feature workflow#
| Command | Use when |
|---|---|
/hapo:specs | You need requirements, research, design, tasks, and validation. |
/hapo:develop | A spec or task file is approved and ready for implementation. |
/hapo:test | You need evidence from exact commands, build checks, tests, UI checks, or runtime reachability. |
/hapo:code-review | You need adversarial review for bugs, security, scope drift, and missing proof. |
/hapo:sync | Task status, task_registry, and task markdown must move after proof, or drift needs audit. |
Use /hapo:brainstorm before this path only when the idea is unclear, architectural choices are open, or scope needs pressure-testing.
Bug and incident workflow#
| Command | Use when |
|---|---|
/hapo:debug | Root cause is unknown. It is diagnostic-first and should produce evidence before code changes. |
/hapo:hotfix | A bug must be fixed after diagnosis, with smallest safe change and regression checks. |
Documentation and artifacts#
| Command | Use when |
|---|---|
/hapo:docs --init | Project docs are missing. |
/hapo:docs --update | Source changed enough that broader docs should refresh. |
/hapo:docs --reconstruct <scope> | You need source-backed as-is docs for an existing system. |
/hapo:generate-graph <request> | Architecture, flow, sequence, or state diagrams would help. |
Release workflow#
| Command | Use when |
|---|---|
/hapo:git commit | Verified changes are ready for a focused conventional commit. |
/hapo:git push | Tests and review are clean enough to publish the branch. |
OpenCode installs equivalent prefix-free commands such as /specs, /develop, /test, and /code-review.