# archive/2026-06-12-active-changes-archive/working-copies
dir: archive/2026-06-12-active-changes-archive/working-copies

index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md

## role
Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies.
## files
- .openspec.yaml | Defines metadata for a completed project named "working-copies" with timeline tracking
- design.md | Design document for implementing workspace-based tool instances that replace direct repository mounting with isolated git working copies | dep: FastAPI, SQLAlchemy, Alembic, Docker Compose, Git, React/TypeScript, asyncio subprocess
- explore.md | Design document proposing "Working Copies" (named "Workspace") as persistent writable clones of repositories to replace direct repo mounting/cloning in tool instances | dep: GitRepository, ToolInstance, Project, User, database, compose generation, filesystem mount system
- proposal.md | Proposes a new "Workspace" entity to replace the confusing mount/clone mode dichotomy for tool instances, enabling persistent writable repository clones that multiple tools can share.
- spec.md | Technical specification for implementing persistent workspace-based tool instances that replace mount/clone modes with explicit Git repository workspaces | dep: Git, PostgreSQL, REST API, React/TypeScript frontend, Docker containers, Python backend
- tasks.md | Project task tracking document for implementing workspace-based tool instances across backend and frontend in a multi-PR phased approach | dep: Alembic, FastAPI, SQLAlchemy, React, TypeScript, pytest, ruff, ESLint, Git, Docker Compose
## arch
Design-driven documentation package containing phased technical specifications (proposal → design → exploration → spec → tasks) for a Workspace entity abstraction, with YAML metadata tracking and multi-PR implementation planning across backend/frontend systems.
## tags
workspace, tool, instances, git, design, replace, project, working
## symbols
-
## workflows
-
## dirty
-
