# 2026-05-19-tool-instances
dir: 2026-05-19-tool-instances

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

## role
Defines the architecture and requirements for a Docker-based containerized development environment management system that provisions isolated tool instances per repository with lifecycle management.
## files
- design.md | Design document specifying a Docker-based tool instance system for launching and managing development environments per repository with lifecycle management and frontend integration. | dep: Docker, Docker Compose, SQLAlchemy/Base, React/useAtom, AppShell, GitRepository, ToolType, Project, User
- proposal.md | Proposes a system for managing Docker-based development tool instances with persistent sessions linked to repositories | dep: Docker Compose, Docker API, GitRepository, ToolType, database
- tasks.md | Project task tracking document for implementing Docker-based tool instance management with backend API, frontend UI, and lifecycle operations | dep: FastAPI, SQLAlchemy, Alembic, Docker, React/TypeScript, Jotai, docker-compose
## arch
Event-driven microservices architecture with REST API backend, frontend UI, and Docker container orchestration using session persistence, lifecycle state machines, and repository-scoped resource isolation.
## tags
docker, design, tool, document, instance, system, managing, development
## symbols
-
## workflows
-
## dirty
-