# openspec/changes/workspace-first-ui
dir: openspec/changes/workspace-first-ui

index: openspec/changes/workspace-first-ui/.pi-map.index.md

## role
Product specification and design documentation package for a workspace-first UI refresh project that reorients the application around persistent writable workspaces rather than direct repository browsing.
## 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-driven specification architecture using sequential PR-based task breakdown (backend → workspace detail page → projects page/routing), with layered design documents progressing from proposal → product spec → technical design → implementation tasks.
## tags
workspace, first, refresh, design, document, project, specification, .openspec
## symbols
-
## workflows
-
## dirty
-