# openspec/designs
dir: openspec/designs

index: openspec/designs/.pi-map.index.md

## role
Contains design documents specifying architectural decisions and feature specifications for the OpenSpec containerized development environment platform.
## files
- config-profile-multi-repo-mounts.md | Design document for extending git mount configuration to support multiple source-to-target mappings per repository in a config profile system. | dep: JSONB, Python, TypeScript, React, os.path, glob expansion, config profile API, tool instances API
- home-path-expansion.md | Design document for implementing `~` and `$HOME` expansion in container mount paths based on manifest user configuration | dep: config_profile_resolver.py, manifest_compiler.py, tool_instances.py, os
- mount-specificity-ordering.md | Defines a design for sorting Docker volume mounts by target path depth to ensure more specific mounts take precedence, with duplicate detection warnings. | dep: docker.py, manifest_compiler.py, tool_instances.py, collections.Counter, logging
- terminal-responsiveness.md | Design document for a high-performance web terminal rewrite using asyncio-native I/O, binary WebSocket frames, output batching, flow control, and WebGL rendering. | dep: asyncio, pty, os, time, collections.deque, xterm.js, xterm-addon-webgl, WebSocket, docker, JSON
- tool-definition-manifest.md | Defines a system for creating, validating, and compiling tool definition manifests into Dockerfiles, Docker Compose files, and entrypoint scripts for containerized development environments. | dep: Docker, PostgreSQL, Python (json, hashlib, shlex, yaml, subprocess), JSON Schema, deb/nodesource package repositories
## arch
Markdown-based design document collection using iterative specification pattern; each document follows a structured RFC-style format with problem statement, design, and implementation considerations covering container orchestration, filesystem mounts, terminal I/O, and tool manifest compilation.
## tags
py, docker, design, mount, path, mounts, document, config
## symbols
-
## workflows
-
## dirty
-
