headquarter/openspec/changes/archive/2026-05-22-add-project-settings-page/proposal.md

Why

The current projects listing page mixes project management actions (create, edit, delete) with workspace navigation, leading to a cluttered UI. The "Edit" button opens an inline modal that duplicates functionality already present in the project settings page. Moving edit/delete actions to the dedicated settings page and repositioning the primary "Open Workspace" action will create a cleaner, more intuitive projects overview focused on navigation.

What Changes

• Remove the Edit button and modal dialog from the projects listing page (projects.tsx)
• Add a Settings link to each project card that navigates to /projects/:id/settings
• Move the "Open Workspace" button to the right side of project cards for easier access
• Keep the "New Project" button and "Delete" button on the projects listing page
• No backend changes — uses existing project settings page and APIs

Capabilities

New Capabilities

• (none — uses existing project-management and frontend-foundation capabilities)

Modified Capabilities

• project-management: Update UI flow — project editing is now accessed via settings page instead of inline modal
• frontend-foundation: Update projects list page layout and navigation pattern

Impact

• apps/web/src/pages/projects.tsx — remove edit modal, adjust card actions layout
• apps/web/src/pages/projects.test.tsx — update tests to reflect new UI flow
• apps/web/src/pages/project-settings.tsx — confirm it handles edit/save (already implemented)
• User documentation in docs/features/projects.md — update editing instructions