Featured Leanpub Book
Clarity Forge : Local coding agent done right
An OpenSpec × Grill Mini Book
Monday morning. You typed "add multi-tenancy to the billing service" into Claude Code. Eight hours later: forty-three files touched. Half the tests yellow. You cannot explain to your tech lead what was decided, by whom, or against which constraint.
The code looks fine. The intent is gone.
The Clarity Forge is the antidote — a small, opinionated pipeline that forces every fuzzy idea through explicit spec, structured interrogation, and tailored artifacts before a single line of production code is written.
Six stages. Six copy-paste prompts. One iron rule:
The spec is the durable artifact. The code is the side effect.
Pairs the frontier-grade Architect (Opus, GPT-5, Sonnet 4.6+) with a local Contractor (Gemma, Qwen). Pairs OpenSpec's directory convention with the Grill skills that surface ambiguity before it metastasises into code.
A weekend read. A Monday-morning toolkit. Worked example included.
Stop vibe-coding. Start clarity-trading.
