This is the grep-friendly entry point for agents working on the workspace reimplementation.
Useful search terms:
workspace reimplementation
workspace poc
workspace-poc
workspace reference guide
workspace roadmap
fresh agent
start here
Read these files in order:
WORKSPACE_REIMPLEMENTATION_DIRECTION.mdopenspec/changes/workspace-reimplementation-roadmap/README.mdopenspec/changes/workspace-reimplementation-roadmap/POC_REFERENCE_GUIDE.md- The proposal for the next implementation slice
The POC reference commit is:
workspace-poc @ 79a45ac043f414e63d13e08b9da83b135cb20a39
Use the POC as research material. Do not merge it into an implementation branch. Do not preserve its architecture unless a slice proposal or design explicitly decides to do so.
Implement these flat OpenSpec changes in order:
workspace-foundationworkspace-create-and-register-reposworkspace-open-agent-contextworkspace-change-planningworkspace-apply-repo-sliceworkspace-verify-and-archive
workspace-reimplementation-roadmap is the continuity and reference container for the plan.
For the slice you are about to implement, inspect the pinned POC commit using POC_REFERENCE_GUIDE.md, then write down:
POC findings for <slice>:
User behavior to preserve:
- ...
Tests or examples worth translating:
- ...
Implementation shortcuts to avoid:
- ...
Open design questions:
- ...
Capture durable findings in the relevant OpenSpec artifact so future sessions do not depend on chat history.