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

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

## role
Design and planning documents for a workspace-first UI refresh that restructures the application around persistent writable workspaces rather than direct repository browsing.
## files
- 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 | A task planning document that breaks down a "Workspace-First UI Refresh" project into three sequential PRs with detailed backend/frontend tasks, acceptance criteria, and verification steps. | dep: FastAPI, React, TypeScript, pytest, ruff, eslint, tsc, git, workspace-files API, workspace-git API, workspace-instances API
## arch
Specification-driven development with phased PR-based delivery (backend API/services first, then frontend routes/pages, then polish), separating product requirements (spec.md), technical design (design.md), project proposal (proposal.md), and implementation tasks (tasks.md).
## tags
workspace, first, refresh, design, document, react, tasks, backend
## symbols
-
## workflows
-
## dirty
-