Spec-first series
AI blocks in the code. You sculpt it.

Code like you are Michelangelo.

Spend your time where it matters most.

Give your agents a spec they can rough in. Concentrate on the details only you can make perfect.

See how
Coding without a spec

Without a spec, you are the spec.

The build runs one thought at a time — and all of it runs through you.

The minutia

Detail by detail, the thread slips.

Every piece of intent gets dictated live, every step waits on you. Deep enough in the weeds, the original idea gets harder to see from where you're standing.

The rough work

Hours go to blocking in, not finishing.

The agent can generate fast — but with nothing written down, your session goes to steering the basics into place, prompt by prompt.

The trade

Low-value effort crowds out the rest.

The interaction that has to feel right, the edge case that decides trust — still waiting, while you supervise scaffolding.

The expensive part isn't the agent's time. It's yours.

Start with the rough form

Get the idea on the page before the build starts.

Start with a spec. Brainstorm the idea with Claude — or whatever agent you work with — and use the /spec-it skill to turn the conversation into a document to load into DecisionGraph. Decompose it into the epics and stories your coding agent builds from, on a branch of your production code.

A mockup built in another tool requires re-engineering. A prototype built on your production code is made of real parts — your components, your schema, your constraints. Once approved, the structural work is already done. You start by reviewing and refining a working model, not building one from scratch — and nobody has to rebuild it somewhere else later.

Your code stays safe while you work. Nothing goes to waste.

Spec

Write it down.

Behavior, data, rules, edges — the intent, framing the complete idea, before the agent starts guessing.

Mockup

Show it.

A UI sketch or a marked-up screenshot — how it should look, when pictures say it better than words.

A spec isn't ceremony. It's your thinking, made visible.
Nobody told Michelangelo the clay model was slowing him down.
Spend your time where it counts

Your time goes to the details that decide the outcome.

Every build has them: the interaction that has to feel right. The edge case that decides whether anyone trusts the product. The screen it will be judged by.

With the form already blocked in, the important details are where your focus lives. Not because you're disciplined — because the rough work stopped consuming your attention.

The spec didn't take you out of the work. It moved you to the part of the work that needs your judgment the most.

Economy of motion, end to end

The form is blocked in.
The rest is yours.

Spec in. Prototype out. Your code safe on its branch. DecisionGraph runs the rough work — so every hour you spend is a finishing stroke.