v0.18.0
[0.18.0] - 2026-07-14
Breaking Changes
- Spec-driven development is now installed by default. A plain
specship installprovisions the full surface — the/specship:specand/specship:checkdoors plus the "author a spec first" steering — alongside retrieval. Pass--no-sddfor a retrieval-only install (the previous default); the legacy--sddflag is still accepted. Existing installs are never silently changed on upgrade.
New Features
-
SpecShip now learns from what worked — with you in the loop. The reflection engine gained success crystallization: a completed multi-step workflow run becomes a reusable recipe proposal, and a shell command you kept correcting into a working form becomes a "use this form" rule proposal — alongside the existing waste detectors, all human-gated (preview → apply → undo). A new
/specship:learncommand (andspecship reflect --capture) crystallizes the current session's workflow on demand. -
The graph now remembers your work.
specship_exploresurfaces a "Prior work" section when past sessions edited the files you're exploring — date, what was asked, files touched, workflow runs in that window — computed deterministically from the local task history, never summarized by a model, and never from another project's sessions. -
spec-implement-mixed— frontier judgment, small-model execution. A new bundled workflow with the same steps and gates asspec-implement, but Sonnet runs the planning step while Haiku runs the mechanical ones (implement, link, coverage); the test run and approval gates verify the work externally. Most of the tokens at Haiku prices, with correctness coming from the machinery. The dashboard's Tips also now spot a Haiku/Sonnet session drowning in file re-reads and recommend escalating to a bigger model or this workflow. -
The agent is steered to the graph for ALL code work. The per-prompt nudge now covers implementing, fixing, and refactoring — not just "how does X work" questions — after adoption telemetry showed plan-execution and feature prompts were the heaviest file re-readers.
SPECSHIP_NO_STEERING=1still turns it off. -
Behavior switches can live in SpecShip settings files. Put env-var-named keys in
<repo>/.specship/settings.json(per-project, travels with the repo) or~/.specship/settings.json(machine-wide) — e.g.{"SPECSHIP_NO_STEERING": "1"}. Precedence: an actual environment variable > project file > machine file. Covers the steering, compaction, and model-tier switches. -
Environment variables are documented in one place — the README, the site's Configuration page (settings files +
env-block methods), and the generated CLI reference.