chore: update project maps for tool container home directory artifacts

openspec/.pi-map.index.md

@@ -2,7 +2,7 @@
 dir: openspec
 
 ## role
-Defines the OpenSpec methodology and configuration for managing living documentation, requirements, and task tracking within a Docker-based coding agent platform.
+Defines and configures the OpenSpec methodology for structured living documentation of requirements, specifications, and task tracking within a Docker-based coding agent management platform.
 ## parent
 index: ./.pi-map.index.md
 map: ./.pi-map.md

openspec/.pi-map.md

@@ -4,12 +4,12 @@ dir: openspec
 index: openspec/.pi-map.index.md
 
 ## role
-Defines the OpenSpec methodology and configuration for managing living documentation, requirements, and task tracking within a Docker-based coding agent platform.
+Defines and configures the OpenSpec methodology for structured living documentation of requirements, specifications, and task tracking within a Docker-based coding agent management platform.
 ## files
 - README.md | Documents the OpenSpec methodology for managing software requirements, specifications, and task tracking as living documentation within a project repository. | dep: OpenSpec CLI (@fission-ai/openspec), Docker, SQLAlchemy, Alembic, Authentik, React, TypeScript, Tailwind, Traefik, Jinja2, xterm.js, pytest, mypy, ruff, npm
 - config.yaml | Configuration file defining project metadata, technology stack, and software development discipline rules for a Docker-based coding agent management platform | dep: FastAPI, React, Vite, PostgreSQL, SQLAlchemy, Redis, Alembic, pytest, Docker Compose, Traefik, Authentik
 ## arch
-Documentation-as-code pattern with YAML-driven configuration, embedding specifications directly in the repository rather than external tools, supporting automated agent workflows.
+Documentation-as-code pattern with YAML-driven configuration separating project metadata, technology stack definitions, and software development discipline rules from implementation code.
 ## tags
 software, project, docker, sqlalchemy, alembic, authentik, react, traefik
 ## symbols

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

@@ -2,7 +2,7 @@
 dir: openspec/designs
 
 ## role
-Contains design documents specifying architectural decisions and feature specifications for the OpenSpec containerized development environment platform.
+Design document repository for architectural specifications and technical planning of containerized development environment features.
 ## parent
 index: openspec/.pi-map.index.md
 map: openspec/.pi-map.md
@@ -13,6 +13,7 @@ map: openspec/.pi-map.md
 - home-path-expansion.md
 - mount-specificity-ordering.md
 - terminal-responsiveness.md
+- tool-container-home-directory.md
 - tool-definition-manifest.md
 ## links
 index: openspec/designs/.pi-map.index.md

openspec/designs/.pi-map.md

@@ -4,17 +4,18 @@ 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.
+Design document repository for architectural specifications and technical planning of containerized development environment features.
 ## 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-container-home-directory.md | Proposes a design for standardizing tool container home directories to `/home/user` with configurable paths, meaningful repo mounts, and backward-compatible `/workspace` symlinks. | dep: ToolType model, manifest schema, Alembic, Docker/dockerfile, compose, config-profile mounts, git mounts, entrypoint permission fixer, home-path-expansion
 - 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.
+Markdown-based RFC-style design documents covering configuration systems, container filesystem layout, terminal I/O architecture, and Docker toolchain generation with emphasis on backward compatibility and incremental feature rollout.
 ## tags
-py, docker, design, mount, path, mounts, document, config
+home, py, docker, tool, design, path, mounts, mount
 ## symbols
 -
 ## workflows

openspec/tasks/.pi-map.index.md

@@ -2,7 +2,7 @@
 dir: openspec/tasks
 
 ## role
-Contains technical specification documents tracking planned features and architectural improvements for the container development environment platform.
+Technical specification and task tracking directory for planned engineering improvements across the project's container runtime, workspace management, and developer tooling systems.
 ## parent
 index: openspec/.pi-map.index.md
 map: openspec/.pi-map.md

openspec/tasks/.pi-map.md

@@ -4,17 +4,17 @@ dir: openspec/tasks
 index: openspec/tasks/.pi-map.index.md
 
 ## role
-Contains technical specification documents tracking planned features and architectural improvements for the container development environment platform.
+Technical specification and task tracking directory for planned engineering improvements across the project's container runtime, workspace management, and developer tooling systems.
 ## files
 - config-profile-multi-repo-mounts.md | Technical specification for refactoring git mount configuration to support multiple repository mappings per mount instead of single source/target pairs | dep: git, docker compose, react/typescript, pytest, npm, fastapi
-- home-path-expansion.md | Specification document for implementing ~ and $HOME expansion in container mount paths across backend services | dep: config_profile_resolver, manifest_compiler, tool_instances, pytest, npm
+- home-path-expansion.md | Defines a technical implementation plan for adding configurable home/workspace directory support to tool containers in an API service. | dep: SQLAlchemy/Alembic, Docker, Docker Compose, Jinja2 templating, pytest, npm/frontend tooling
 - mount-specificity-ordering.md | Tracks completion status of a project task for implementing mount specificity ordering in Docker volume handling | dep: docker.py, pytest, tsc
 - terminal-responsiveness.md | A technical specification document outlining 7 pending tasks to improve web terminal performance through asyncio-native I/O, binary WebSocket frames, WebGL rendering, flow control, and comprehensive benchmarking. | dep: asyncio, WebSocket, xterm-addon-webgl, docker, pytest
 - tool-definition-manifest.md | A project task specification document defining a multi-PR system for implementing a Tool Definition Manifest System with backend manifest compilation, frontend workshop UI, and legacy migration support. | dep: SQLAlchemy, Alembic, Docker, Docker Compose, FastAPI/REST API, React/TypeScript frontend
 ## arch
-Markdown-based task tracking system using specification-driven development with documents covering backend services (mount handling, path expansion), frontend systems (WebGL terminal rendering), and cross-cutting concerns (async I/O, manifest systems).
+Markdown-based living documentation pattern using standalone specification files that each capture a discrete technical initiative with implementation plans, completion tracking, and cross-referencing between backend API changes, frontend UI work, and infrastructure migrations.
 ## tags
-mount, specification, pytest, docker, manifest, multi, document, implementing
+mount, docker, pytest, tool, manifest, technical, specification, support
 ## symbols
 -
 ## workflows