Spec Workspace
Spec Workspace helps you organize major changes in your project with a clear process — write proposal, design, list tasks, implement, then archive — before merging into the codebase.
Change structure
Each change is a folder containing proposal, design, tasks, and optional specs for each module.
| File | Role |
|---|---|
| proposal.md | The problem, solution, and reasoning |
| design.md | Detailed design: architecture, APIs, edge cases |
| tasks.md | Checkboxable task list for progress tracking |
| specs/ | (Optional) New or updated module specs |
Spec Viewer & Tasks
Open a "Spec" tab from the pane "+". Click a change to open the Spec Viewer with tabs: Proposal, Design, Tasks, Specs. The Tasks tab is where you check off progress. All changes are saved immediately to disk.
Apply & Verify
When ready to implement, use the apply slash command (/apply <name> or similar). The AI reads tasks.md, completes each task, and checks them off. Later, use /verify for another AI to independently review that the implementation matches the spec.
Archiving
When complete and verified, use /archive <name>. Spec ADE renames the folder to archive/YYYY-MM-DD-<name>/. The change moves from Active Changes to Archive — a historical reference.