# 2026-06-12-completed-changes-archive/workspace-first-ui
dir: 2026-06-12-completed-changes-archive/workspace-first-ui

index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md

## role
Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction.
## files
- .openspec.yaml | Defines metadata for a completed project specification named "workspace-first-ui"
- design.md | Design document for a workspace-first UI refresh, detailing backend API/services and frontend components for file management, git operations, and tool instances scoped to workspaces. | dep: FastAPI, SQLAlchemy/AsyncSession, React, React Router, asyncio, subprocess, os
- proposal.md | Proposes a UI refresh to replace the old repository workspace with a workspace-first navigation model centered around persistent writable clones.
- spec.md | Product specification document defining a workspace-first UI refresh that replaces direct repository file browsing with workspace-centric navigation, new routes, and redesigned pages for projects and workspace details. | dep: React/Next.js (implied by .tsx, routing), REST API backend, database (existing workspaces table), TypeScript, ruff, eslint
- tasks.md | Project task tracking document for a workspace-first UI refresh, breaking work into 3 sequential PRs with backend endpoints, frontend workspace detail page, and projects page refresh with routing changes. | dep: markdown, pytest, ruff, TypeScript compiler, eslint, npm, git, python
## arch
Documentation-heavy package using sequential PR-based task decomposition (backend → workspace detail → projects page) with layered specification hierarchy (proposal → design → spec → tasks) and OpenSpec metadata tracking.
## tags
workspace, first, refresh, design, document, project, specification, .openspec
## symbols
-
## workflows
-
## dirty
-
