# openspec/proposals
dir: openspec/proposals

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

## role
Contains architectural design proposals for extending and improving the OpenSpec project's container tooling, configuration, and terminal performance capabilities.
## files
- config-profile-multi-repo-mounts.md | Proposes a backward-compatible extension to Config Profiles' git_mounts to support multiple source/target mappings per repository clone, enabling efficient monorepo directory mounting.
- home-path-expansion.md | Proposes expanding `~` and `$HOME` in container mount target paths to the appropriate home directory based on tool manifest user configuration during Docker Compose generation. | dep: Docker Compose, tool manifest, Dockerfile generation, git mounts
- mount-specificity-ordering.md | Proposes sorting Docker Compose volume mounts by target path depth to prevent broader mounts from hiding more specific ones | dep: Docker Compose, manifest_compiler.py, tool_instances.py
- streamline-tool-container-definitions.md | Proposes a declarative YAML manifest system to replace hand-written Dockerfiles and Compose files for defining tool containers, with automatic compilation into Docker/Compose artifacts and compatibility with existing ConfigProfile mounts. | dep: Docker, Docker Compose, YAML/JSON parsing, database (PostgreSQL implied by JSONB), Python (implied by syntax examples), Node.js/npm, apt, git
- terminal-responsiveness.md | Proposes architectural improvements to reduce web terminal latency and increase rendering performance through asyncio I/O, WebGL rendering, and WebSocket optimizations. | dep: docker, asyncio, WebSocket, WebGL, PTY, Docker Engine API
## arch
Markdown-based RFC/proposal pattern using individual specification documents for distinct feature proposals, covering Docker Compose generation, volume mounting semantics, YAML-driven declarative container definitions, and async I/O/WebSocket optimizations.
## tags
mounts, proposes, docker, home, tool, compose, config, target
## symbols
-
## workflows
-
## dirty
-