# working-copies
dir: working-copies

index: working-copies/.pi-map.index.md

## role
This package contains design documents and implementation planning for a workspace-based repository access system that replaces direct repository mounting/cloning with isolated, persistent, writable git working copies shared across tool instances.
## files
- 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 | A project task breakdown document defining a phased implementation plan for adding workspace-based tool instances to a full-stack application, including backend foundation, backend integration, frontend core, and frontend integration PRs with detailed tasks, acceptance criteria, and verification steps. | dep: Alembic, FastAPI, SQLAlchemy, React, TypeScript, Git, Docker Compose, pytest, ruff, ESLint, npm
## arch
Design-driven documentation package using phased specification approach (exploration → proposal → design → spec → tasks) to transition from a dual-mode (mount/clone) architecture to a unified workspace entity model with full-stack implementation planning.
## tags
workspace, tool, instances, git, design, replace, document, repository
## symbols
-
## workflows
-
## dirty
-