# openspec/changes/archive/2026-05-19-tool-instances
dir: openspec/changes/archive/2026-05-19-tool-instances

index: openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md

## role
Design documentation package for a Docker-based tool instance management system enabling per-repository development environments with lifecycle and session integration.
## files
- design.md | Design document specifying a system for managing Docker-based tool instances (e.g., VS Code servers) per Git repository with lifecycle management, status tracking, and frontend session integration. | dep: Docker Compose, SQLAlchemy/Base model, React/TypeScript (jotai atoms), FastAPI/REST backend, GitRepository, ToolType, Project, User models
- proposal.md | Design document for implementing a tool instance management system with Docker-based sessions linked to repositories | dep: Docker Compose, Docker API, GitRepository, ToolType, app shell/navigation
- tasks.md | Project task tracking document for implementing a Docker-based tool instance management system with backend API and frontend UI | dep: Docker, Alembic, FastAPI/REST API, React/TypeScript frontend, SQLAlchemy ORM, Jinja2 templating, atomic state management
## arch
Specification-driven architecture with separated design documents (design.md for system spec, proposal.md for implementation plan, tasks.md for project tracking) covering backend API, frontend UI, Docker orchestration, and Git repository linkage.
## tags
design, docker, document, system, tool, management, tracking, frontend
## symbols
-
## workflows
-
## dirty
-