Core workflow
Main workflow

Intent は reviewed contract を通って code になります。

C1 で scope、C2 で findings review、one flat task を implement、proof、C3 で user が close。

Main CafeKit workflow
01
/cf:specs

Specify

Create requirements, research, design, task packets, and validation gates before code starts.

02
Approve task packet

Lock scope

Use the accepted C1/C2 decisions, plan, and flat task as the implementation contract.

03
/cf:develop

Build

Implement one approved task at a time after task-aware inspection of real entrypoints.

04
/cf:test

Verify

Run exact commands, prove reachability, and reject fake green results such as zero-test passes.

05
/cf:code-review

Review

Check spec compliance, code quality, edge cases, security, and regression risk before closeout.

06
/cf:sync

Sync

Update task Status and its inline Receipt only after proof, or audit drift before continuing.

Main path#

/cf:brainstorm         # intent または architecture が未解決なら optional
  -> /cf:specs         # C1 -> plan.md + flat tasks -> adversarial review -> C2
  -> planning stop
  -> /cf:develop       # new explicit invocation; one unblocked task
  -> /cf:test          # smallest adequate real proof
  -> /cf:code-review   # correctness, security, regression, contract drift
  -> /cf:sync          # observed Status と inline Receipt のみ
  -> C3                  # user completion decision

Chat は source of truth ではありません。New work は specs/<feature>/plan.md と flat task-NN-*.md を使います。

Contract and execution#

plan.md は C1 scope、exclusions、acceptance criteria、dependencies、C2 decisions を記録します。各 task は one outcome、one Status:、ownership、dependencies、proof command、final inline ## Receipt を持ちます。

Develop は mutation 前に real entrypoints と callers を scout。Runtime-facing work は actual route、command、UI mount、worker、service、API boundary から reachable になるまで incomplete です。

Named technology や runtime choice を黙って置換しません。Scope change は plan と user decision に戻します。

Proof stack#

Contract

Plan, accepted decisions, and active task agree on scope.

Code

Runtime-facing work is wired into a real entrypoint or caller.

Evidence

The task records commands, outcomes, and runtime or artifact proof.

State

Task Status and inline Receipt are synchronized after verification.

Green command だけでは不十分です。Acceptance に関係する exact commands を実行し、zero tests と NO_TESTS は pass しません。Review finding は repair と reverify まで completion を block します。

State ownership#

State moves only when proof exists
pending

Task is known but not active yet.

in_progress

Task has been claimed and is being implemented or verified.

blocked

A concrete blocker is recorded and must be cleared before continuing.

done

Completion criteria and evidence are satisfied with real proof.

Controller だけが task Status と canonical Receipt を更新します。Sync は observed state を reconcile できますが execution、approval、completion を捏造できません。

Alternate routes#

SituationRoute
Evidence-backed answer/cf:ask
Scoped codebase discovery/cf:scout
Root cause unknown/cf:debug
Diagnosed bug repair/cf:fix
Existing system lacks reliable docs/cf:docs --reconstruct <scope>
Uncertain technical decision/cf:research
Explicit bounded numeric optimization/cf:loop

Claude Code は /cf:*、Codex CLI は native $cf-* skills。OpenCode commands は historical 0.16 notes のみです。