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

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

## role
Archive of completed design and specification documents for implementing workspace-based git working copies to replace direct repository mounting in tool instances.
## files
- .openspec.yaml | Defines metadata for a completed project named "working-copies" with start and completion dates
- 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, React/TypeScript, Git, asyncio, uuid, datetime
- explore.md | Proposes a "Working Copy" (Workspace) entity architecture to replace direct repository mounting/cloning in tool instances, enabling persistent writable clones shared across multiple tool instances. | dep: GitRepository, ToolInstance, database/ORM, container compose generation, filesystem mount/bind-mount, UI/sidebar navigation
- proposal.md | Proposes a workspace-based architecture to replace mount/clone modes for tool instances with persistent, writable local repository clones
- spec.md | Technical specification document defining a workspace-based architecture for persistent, writable Git repository clones that replace mount/clone modes for tool instances. | dep: Git, PostgreSQL, REST API, Python, TypeScript, React/frontend framework, container runtime
- tasks.md | Tracks implementation tasks for a workspace-based tool instance feature across 4 sequential PRs, covering backend foundation, backend integration, frontend core, and frontend integration with acceptance criteria and verification steps. | dep: Alembic, FastAPI, SQLAlchemy models, GitService, WorkspaceManager, pytest, ruff, TypeScript, React hooks/components, React Router, ESLint, npm, Docker compose templates
## arch
Documentation-driven specification with layered architecture (exploration → proposal → design → spec → tasks) defining a workspace entity pattern with persistent writable git clones shared across isolated tool instances, replacing mount/clone modes.
## tags
tool, workspace, instances, replace, repository, git, working, design
## symbols
-
## workflows
-
## dirty
-
