# workspace-first-ui
dir: workspace-first-ui

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

## role
Design and planning documentation 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
Markdown-based documentation architecture using a four-layer specification hierarchy (proposal → design → spec → tasks) to progressively decompose a major UI/UX refactoring into implementable work units, with clear separation between product definition, technical design, and project management concerns.
## tags
workspace, first, refresh, design, document, react, tasks, backend
## symbols
-
## workflows
-
## dirty
-