Skip to content
Spec{0}

Ship your first card

A card is the unit of work in Spec0. It carries a requirement, a design, an ordered task list, and verifications. Nothing ships until the verifications clear.

This page is the shortest path from “empty project” to “first card on the board done.”

Author the card

Two routes — pick whichever fits how this card is forming in your head.

Route A — You write it

  1. In the project, click New card, or press C.
  2. Pick a kind: feature for new behavior, bugfix for broken existing behavior.
  3. Give it a title and write the requirement. Keep it concrete — what should be true when this card is done.
  4. Sketch the design in the next tab. Two or three sentences is enough at the start.
  5. Add a few tasks (one per logical step).
  6. Add at least one verification (e.g. “run pnpm check and paste the output”, “attach a screenshot of the changed screen”). The verification is the proof; without one, you can’t approve.
  7. Save the card. It lands in Drafts.

Route B — An agent writes it

If you already have a connected agent (see Connect your first agent), you can brief it in plain language and let it author the card via MCP. This is how most cards get written in practice — the back-and-forth is faster than typing into form fields.

  1. In the agent’s chat, describe the work — kind, what should be true when it’s done, rough shape of the change. Example: “Create a feature card for a project-wide search box. Hits the existing search index. Three or four tasks; verification is a screenshot of the results panel.”
  2. The agent calls spec0_create_card, then spec0_add_task and spec0_add_verification for each item. Templates (spec0.requirements, spec0.design, spec0.tasks) shape the wording.
  3. The card lands in Drafts in your board. Open it, read the spec, tighten the parts that need it, then continue.

The card is yours once it lands. The agent doesn’t claim what it just authored unless you move it to Todo.

Hand it off

Drag the card to Inbox (still yours to plan), then to Todo when you’re ready for an agent to pick it up. Or save directly into Inbox or Todo from the new-card view.

Watch the agent work

A connected agent calls spec0_list_claimable, picks the card, and claims it. The card moves to Doing and binds to that agent’s session. You see progress updates and recorded commits as they happen.

Review and approve

When the agent submits, the card lands in Review. Read its notes, check the verification proof, look at the recorded commits.

  • Click Approve if you’re happy — the card moves to Done.
  • Click Send back if it needs changes — the card returns to the queue as a Revision card with your feedback attached.

That’s the full loop. Repeat as many times as you like; every agent you connect can run this in parallel on different cards.