[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_28":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58},"routes/_store+/_readers+/email_author.$slug/route",{"_9":10,"_11":-5},"book",{"_12":13,"_14":15,"_16":17,"_18":19,"_20":21,"_22":23},"currentUser","id","Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6Qm9va1Byb2R1Y3QvNzkyNzk","title","Clarity Forge : Local coding agent done right","state","published","contactAuthorMethod","email","aboutText","

The Clarity Forge: Local AI, Done Right

The market is drowning in skill packs, plugin bundles, MCP servers, and \"ultimate\" prompt collections. They sell well for the same reason ab-roller infomercials sell well: they look like the thing that will fix you. They are not the thing that will fix you.

What fixes you is a small set of artifacts that capture intent before code, and a small set of prompts that move work between those artifacts predictably. Everything else is decoration.

The Clarity Forge is six stages and six prompts. That is the whole pipeline. You can run it on a weekend toy. You can run it on a 200k-LOC microservice. The artifacts scale; the discipline does not change.

What You Get

The six-stage pipeline — OpenSpec Bootstrap → Grill-Me → Grill-With-Docs → ADR Grill → Tailored Emission → Dispatch → Verify-or-Escalate.
Six copy-paste glue prompts — the connective tissue between stages, deliberately spare so the work lives in the artifacts, not the prompts.
The hybrid Architect / Contractor split — frontier model (Opus, GPT-5, Sonnet 4.6+) writes the plan; open-weight local model (Gemma 4, Qwen 3) executes against it.
Deep dives on the two highest-leverage schemas — intent-driven (Gherkin specs + ADRs) and spec-driven-with-adr (standard specs + ADRs).
A worked example — passkey login, end to end, with a real ADR draft.
An anti-pattern catalog — the shortcuts that look like the forge but quietly destroy it.
A printable one-page reference card.

Who It Is For

Engineers who use Claude Code, Cursor, Codex, or any coding agent on real production codebases.
Tech leads tired of explaining to stakeholders why eight hours of agent execution produced code nobody can defend.
Teams who want to run local open-weight models for execution without giving up frontier-grade reasoning for planning.
Anyone who has felt the quiet erosion of confidence that comes from shipping AI-generated code with no audit trail of why it was decided.

This is a field guide, not a manifesto. Every prompt is runnable. Every stage produces a versionable artifact. You can be running the pipeline on a real change by Monday morning.

Companion to The Clarity Engineer

This mini book is the working pipeline. The full framework — clarity trading, world models, intent documentation, agent identity, networked agentic organizations — lives in the parent book:

📖 The Clarity Engineer: Code Is the Side Effect by Volodymyr Pavlyshyn — Leanpub · also on Amazon.

The Clarity Engineer names the discipline. The Clarity Forge gives you the working version on a single page.

About the Author

Volodymyr Pavlyshyn writes and builds at the intersection of agent orchestration, AI engineering discipline, and the durable artifacts that make software teams legible to themselves. He is the author of The Clarity Engineer and the maintainer of the OpenSpec schema family that this book documents.

","authors",[24],{"_12":25,"_26":27,"_28":29},"Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6UHJvZHVjdEF1dGhvci84NDg0Nw","name","Volodymyr Pavlyshyn","user",{"_30":31},"avatar",{"_32":33,"_34":35,"_36":37},"url","https://d39qdlcrvnra4b.cloudfront.net/avatars/211223/medium/552391298_4018935778371189_3873749716184464813_n.jpg?1758620373","styleName","medium","exists",true,"shoppingCartId","shoppingCart",{"_12":71,"_72":73,"_74":37,"_75":76,"_77":78,"_79":80,"_81":37},"locale","en","readerTheme","light","constants",{"_69":70},"publishers",{"_65":66,"_67":68},"learnerOrganizations",[],"needsLocaleCookieSync",false,"announcements",{"_59":60,"_61":-5},"sentryEnvironment","production","sentryRelease","660879bd1b39a24c7d76a108e4c4fa14e02ebd8c","announcement_store",{"_62":52,"_63":64},"announcement_authors","flag","text","

Kick off your book project, get started with GhostAI, get better at marketing, or spend the day doing all three! Free live workshops on Zoom. Saturday, June 27, 2026.

\n","companies",[],"universities",[],"paypalClientId","AX53Cwz8jR6rVVzzZiZNWWXl0dGagi-GZrjG-S3Ua14E5nrKMn7DxDQ730O4R8LusLPp49ALn6aRVaEy","no-cart","count",0,"free","updatedAt","","paymentGateway","STRIPE","cartItems",[],"loading"]

Email the Author