Files
paseo/EXECUTION_PLAN_ITERATION_3_WORKSPACE_HEADER_TABS_RESTORE.md
T

2.3 KiB
Raw Blame History

Iteration 3 Execution Plan — Paseo Orchestrated

Principles

  • Work happens in an isolated git worktree and merges back to main once verified.
  • Do not restart or touch the daemon on localhost:6767.
  • Use the repo’s existing Playwright global setup (isolated daemon/metro) for E2E.
  • Pass all gates before merging:
    • Typecheck
    • Vitest
    • Playwright E2E
    • Manual agent-browser verification

Agent Delegation (Paseo)

Implementation agent (1)

  • Agent: Codex
  • Mode: full-access
  • Worktree: iter3-workspace-header-tabs-restore
  • Mission:
    • Fix New tab dropdown visibility (on-screen, correct pattern)
    • Restore workspace header structure + explorer toggle + agent kebab menu
    • Add terminal close (X) from workspace tab strip
    • Add/adjust Playwright E2E specs for the above
    • Run verification commands before declaring done

Reviewer (optional, if needed)

  • Only used if implementation is large/risky or tests expose subtle regressions.
  • Codex or Claude Sonnet as a second-pass reviewer for UI regressions.

Merge Strategy

  1. Agent commits all changes in the worktree.
  2. Orchestrator reviews the diff on the worktree.
  3. Run gates locally on the worktree:
    • npm run typecheck
    • npm run test --workspace=@getpaseo/app
    • npm run test:e2e --workspace=@getpaseo/app
  4. Manual agent-browser verification:
    • Desktop viewport: New tab menu visible + explorer toggle + kebab menu
    • Mobile viewport: explorer icon uses git/folder, toggles right sidebar, left sidebar unaffected
  5. Merge worktree back into main with a fast-forward merge if possible; otherwise merge commit.

Verification Checklist (strict)

  • New tab menu opens and is visible (desktop)
  • Selecting Agent tab routes to draft agent flow scoped to workspace
  • Selecting Terminal tab creates terminal and focuses it
  • Terminal tabs show X; closing kills terminal and removes tab
  • Workspace header shows branch name
  • Workspace header has explorer toggle with correct icon behavior
  • Agent kebab menu exists when Agent tab active
  • Right sidebar opens/closes via header and mobile swipe gesture
  • Left sidebar gestures unchanged
  • npm run typecheck ✅
  • npm run test --workspace=@getpaseo/app ✅
  • npm run test:e2e --workspace=@getpaseo/app ✅