Unified Bolt Flow

specsmd v2 — intents, work items, and dynamic bolts under docs/specsmd

The unified bolt flow is specsmd v2: one skills-native flow for shaping work as intents and work items, then executing it in bolts that run data-defined recipes under a ceremony dial.

Specifications are the source of truth. Code is derived from them.

Start here

Quickstart

Install the plugin, capture an intent, complete a first bolt

Coming from v1

Terminology mapping for AI-DLC and FIRE. Orientation only — no migration tooling

Concepts

Bolt, recipe, ceremony dial, lenses, nlspec, memory model

Manual install

Copy skills into a tool that has no plugin marketplace

What you get

Intent → work item → bolt

Capture an outcome, slice it into behavioral work items, execute when you are ready. Draft bolts are optional.

Recipes, not bolt types

default, ddd, spike, and simple are data files. Add a project-local recipe by adding a file.

Ceremony dial

Complexity × autonomy bias → autopilot, confirm, or validate. Your choice at bolt start always wins.

Recommend, don't enforce

Skills never force a sequence. Scripts refuse illegal state changes only — missing evidence, unmet gating criteria.

Reference

Recipe reference

Shipped stages, gates, constraints, and how to add your own

Skills reference

Every skill, when to invoke it, and what it writes

Writing nlspecs

Observable behavior, Definition of Done, no mechanism

Legacy home

AI-DLC, FIRE, Ideation, and Simple — unchanged URLs

Install in one step

v2 ships as the specsmd plugin. There is no v2 npm CLI. One marketplace install is the complete flow.

/plugin install specsmd@specsmd

See the quickstart for marketplace setup, or the manual install path if your tool has no plugin marketplace.