The first sixty seconds

Captured from an empty directory against a scratch database. Every block below is real output from the command above it.

An empty directory. Nothing is configured yet.

$ commission
commission — the execution layer for software delivery

You describe what needs to happen. Agents claim the work, record evidence as
they go, and Commission refuses to call anything done until the evidence is there.
You are asked only for the judgment calls.

Nothing is set up in this directory yet.

  commission init <name>     create a project and bind this repo to it

Then hand commission a plan and let agents work it:

  commission apply -f plan.json      create a whole task graph at once
  commission next --claim            what an agent should do next, claimed atomically
  commission board                   where everything stands

  commission --help                  every command, grouped by what you are doing

One command sets up a project and binds the repo to it.

$ commission init acme --name Acme
created project acme (Acme)
this repo is bound to it — bare commission commands target 'acme' here

next:
  commission apply -f plan.json    create a whole task graph at once
  commission add "..."             or one task to start with
  commission next --claim          what to work on, claimed atomically

Running it again is safe, and still says what to do next.

$ commission init acme
project acme already exists (Acme)
this repo is bound to it — bare commission commands target 'acme' here

next:
  commission apply -f plan.json    create a whole task graph at once
  commission add "..."             or one task to start with
  commission next --claim          what to work on, claimed atomically

Bare commission now answers with position instead of orientation.

$ commission
Acme (acme) — 0/0 done, 0 open

no tasks yet.

  commission apply -f plan.json   create a whole task graph at once
  commission add "..."            or one task to start with
  commission inbox                what needs your judgment
  commission --help               every command

Add a task.

$ commission add "Ship the webhook receiver" -c "signature verified"
created acme-1 · Ship the webhook receiver

And it tells you the one thing to run.

$ commission
Acme (acme) — 0/1 done, 1 open

next up: acme-1  Ship the webhook receiver

  commission next --claim         start on it
  commission inbox                what needs your judgment
  commission --help               every command

This page is docs/evidence/first-run.md in the Commission repository, rendered in place — the site keeps no copy of it. It is generated by scripts/capture-first-run.ts, so it is exhaustive, and editing it by hand is reverted by the next run.