Why I Shipped Two Artifact Mechanisms In My VS Code Extension — Not One

A specification is more than text. It comes with a wireframe, the regulatory PDF it answers to, the API contract it has to honour, the stakeholder slide deck someone negotiated against. For a long time, none of that lived in my spec tree. The Markdown files were git-tracked; the evidence behind them rotted in Confluence, in shared drives, in pasted-and-lost screenshots in chat. This week I shipped a fix in v0.9.7 of the VS Code extension I maintain. The shape of the fix is the part I want to wr...