spec.md — VS Code / Cursor extension (v1.1.0)
spec.md v3 panel for .spec.md/: drafts → active → Review Gate → archive, with A-B-C docs and /spec.md.* Cursor skills.
Quick start
- Install this extension (
godrix.deepspec — marketplace name spec.md).
- Open a workspace and run spec.md: Initialize.
- Scaffolds
.spec.md/ v3 (templates, hooks, tracking, manifest).
- Installs orchestrator + 11 command skills under
.cursor/skills/.
- Sends
/spec.md.init to chat for AGENTS.md discovery.
- spec.md: New Task →
/spec.md.create-task in chat.
- Use panel actions: Approve, Complete, Revise, Review, Map codebase, Diagram, Interview, or Discard.
Execution Plan UI (v1.1)
Active and review tasks show progress as slug (2/5) in the tree and control panel. Steps are parsed from ## Execution Plan in APPROACH.md and reconciled with ## Execution Log in COMPLETION_REPORT.md. Optional ARCHITECTURE.md opens in Review with Mermaid rendering.
spec.md v3 scaffold
Initialize creates (idempotent — existing files are kept):
.spec.md/
├── AGENTS.md
├── memory.md
├── manifest.json
├── tracking.json
├── templates/ # v3 A-B-C templates
├── hooks/ # list, track, repair, validate
└── specs/{drafts,active,archive}/
Plus .cursor/skills/spec.md/ and .cursor/skills/spec.md.*/.
Settings
| Key |
Default |
Description |
spec.md.enabled |
true |
Enable the spec.md panel. |
spec.md.reviewPanelColumn |
active |
Review webview column. |
spec.md.cli.preferNpx |
true |
Try npx spec.md@3.0.0 init cursor-agent before bundled scaffold. |
spec.md.skill.sourceUrl |
GitHub spec.md/ |
Orchestrator skill folder. |
spec.md.skill.commandsSourceUrl |
GitHub spec/commands/ |
Command skills source. |
spec.md.skill.autoCheckEnabled |
true |
Auto-check skill updates. |
Commands
| Command |
Action |
spec.md.initialize |
Scaffold v3 + install skills + chat init |
spec.md.createTask |
New task form → chat |
spec.md.approveTask |
/spec.md.approve-task in chat |
spec.md.completeTask |
/spec.md.complete-task in chat |
spec.md.listTasks |
Run list hook (or chat fallback) |
spec.md.repairTracking |
/spec.md.repair in chat |
spec.md.checkSkillUpdate |
Update skills from GitHub |
UI
Single activity-bar webview with tabs: Specs (pipeline + memory), Skill (versions/updates), Guide (v3 workflow).
Development
npm install
npm run compile
Press F5 to launch the Extension Development Host.
Requires spec.md v3 on GitHub for remote skill/command downloads.
