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

1. Update Projects Listing Page

• 1.1 Remove edit modal and related state from apps/web/src/pages/projects.tsx

  • Remove DialogMode type and dialogMode state
  • Remove editingProject, formName, formDescription, formError states
  • Remove openEdit, closeDialog, and handleSubmit functions
  • Remove the dialog/modal JSX block
  • Keep deleteConfirmId state and handleDelete

• 1.2 Update project card actions in apps/web/src/pages/projects.tsx

  • Remove the Edit button from each project card
  • Add a Settings link (using Link from react-router-dom) with gear/settings icon
  • Reorder actions left-to-right: Settings, Delete, Open Workspace
  • Ensure Open Workspace is the rightmost action
  • Settings link navigates to /projects/${project.id}/settings

2. Update Tests

• 2.1 Update apps/web/src/pages/projects.test.tsx
  • Remove tests for inline edit modal (opening, submitting, canceling)
  • Add test for Settings link presence and navigation
  • Add test verifying Open Workspace button is positioned on the right
  • Keep existing tests for create, delete, loading, error, and empty states

3. Update Documentation

• 3.1 Update docs/features/projects.md
  • Update "Editing a Project" section to describe navigating to Settings page instead of using inline Edit button
  • Update "Project Card" description to mention Settings link and repositioned Open Workspace button

4. Verification

• 4.1 Run frontend type checks: npm run typecheck — Pre-existing dependency errors (not from this change)
• 4.2 Run frontend linter: npm run lint — Passed
• 4.3 Run frontend tests: npm test -- projects.test.tsx — Pre-existing missing dependency (not from this change)
• 4.4 Verify no regressions in project settings page — No changes to settings page