Skip to content

Your first workflow

This walks an idea from nothing to merged code using steer skills. Each step links to its full reference.

The commands are optional

You don't have to type the /steer:* commands below. Just tell Claude what you want in plain language ("set up this repo", "capture this idea", "let's build it") and the router rule has Claude pick and run the right skill, announcing each step. The explicit commands are shown so you can see what's happening — and reach for one directly when you already know it.

flowchart LR
    A[Idea] -->|/steer:issues capture| B[Issue]
    B -->|/steer:spec| C[Draft spec]
    C -->|/steer:spec approve| D[Approved spec]
    D -->|/steer:issues decompose| E[Work items]
    E -->|/steer:work start| F[Implementation]
    F -->|/steer:work finish| G[PR]

1. Set up the repo

Run /steer:setup — it detects whether this is a brand-new repo or an existing app and routes accordingly (to /steer:init or /steer:adopt). Either way you end up with a /spec spine and the bundled scaffold (CI, mise.toml, compose.yaml, PR template).

The bootstrap PR is the bootstrap gate — it brings the repo under the standards and opens spec-first work on main. It is not productionization: a greenfield bootstrap ships scaffold and an empty spec spine, with no app to harden yet. Productionization is a later, per-app event — the /steer:build v0 handoff or /steer:adopt, where real code is triaged into /spec/PRODUCTIONIZATION.md before a production deploy.

For a solo greenfield repo (one person is both PO and dev, no MVP yet), /steer:init can instead start in solo trunk mode: the bootstrap and early features land directly on main with no PR, until you graduate to the PR flow with /steer:protect.

2. Capture the idea

/steer:issues capture

Captures a product idea as an issue without losing open questions. See Workflows → Issues.

3. Shape and approve a spec

/steer:spec
/steer:spec approve <feature-id>

Think the feature through, shape acceptance criteria, and record the approval evidence. See Workflows → Spec.

4. Decompose into work

/steer:issues decompose

Breaks the approved spec into tracked work items.

5. Implement and finish

/steer:work start #123
/steer:work finish #123

Implements the issue and lands a PR. Commits happen autonomously, but pushing is gated — see the Authorization model.

What's next