Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Spec of RecordNew to Visual Studio Code? Get it now.
Spec of Record

Spec of Record

Sebastian Rath

|
1 install
| (0) | Free
Shows which code comes from which clause of the spec, and whether they still agree.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Spec of Record for VS Code

Shows, inside the editor, which code comes from which clause, and whether they still agree.

  • Lenses above clauses (out/index.html:26-28, with a flag when something needs attention) and above @clause lines in code.
  • Hover on generated code shows the clauses behind the line and their state.
  • Gutter marks: red drift, amber review, blue recompile. Status bar counts them.
  • Ctrl+click on a {reference} in a spec file jumps to what it names.
  • With a spec file and its code side by side, the block under the cursor lights up its counterpart in the other editor (a clause lights its code, code lights its clauses). Nothing scrolls or opens by itself.
  • @clause comment lines are hidden (display only, the files never change). "Spec of Record: Toggle marker lines" flips it.
  • Syntax colors for files under sor/.

Everything comes from the sor tool: the JavaScript copy of its reading commands (markers --json, status --json, parts --json) that ships inside the extension and runs on the editor's own Node, so nothing else has to be installed. It never uses Python, and never a tool from the project. Settings: sor.hideMarkerLines, sor.livePreview. (sor.pythonPath and sor.toolPath are gone since 0.10.0; VS Code ignores them if they are still in your settings.) It starts only when the workspace holds a sor/SPECOFRECORD.md (or the older sor/CLAUSES.md). It never edits a spec or code file.

Test: npm test (grammar test, a check of the bundled tool, then a real VS Code on examples/solar-system). The bundled copy in tools/ is made from the repository's tools/js by sh plugins/sync-tools.sh; never edit it by hand.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft