Files
Codewalkers/docs/wireframes/plan-tab.md
Lukas May 89db580ca4 docs: Add ASCII wireframe mockups for all frontend pages
Covers: app layout, initiatives list, initiative detail (4 tabs),
agents page, inbox, settings (health + projects), and all dialogs.
2026-03-02 17:28:14 +09:00

9.8 KiB

Plan Tab (?tab=plan)

Two-column layout: phase sidebar (260px) + phase detail panel.

Default State (phases exist, one selected)

+============================================================================+
|  < Back                                                                    |
|  Auth System Overhaul    [ACTIVE]  [YOLO]  [git] main  [P] backend       |
|  [ Content ]  [*Plan*]  [ Execution ]  [ Review ]                        |
+============================================================================+
|              |                                                             |
|  PHASES [+][detail]  Phase 2: Implement OAuth           [READY]     [...] |
|              |                                                             |
|  +--------+ |  +--------------------------------------------------------+ |
|  | 1. DB  | |  |                                                        | |
|  | Schema | |  |  Implement the OAuth 2.0 authorization code flow       | |
|  | [DONE] | |  |  with PKCE extension for public clients.               | |
|  | 3/3    | |  |                                                        | |
|  +--------+ |  |  Support Google, GitHub, and Microsoft as identity      | |
|  +--------+ |  |  providers with configurable scopes.                    | |
|  | 2. OAuth| |  |                                                        | |
|  | Flow   | |  +--------------------------------------------------------+ |
|  |*[READY]*| |                                                             |
|  | 0 tasks| |  Dependencies                                               |
|  | dep: 1 | |  [+ Add dependency v]                                       |
|  +--------+ |  * Phase 1: DB Schema [DONE]        [x]                     |
|  +--------+ |                                                              |
|  | 3. UI  | |  Tasks (0/5)                                                 |
|  | [PEND] | |  ├── Set up OAuth routes          [PENDING]           [x]   |
|  | 5 tasks| |  ├── Implement PKCE flow          [PENDING]           [x]   |
|  | dep:1,2| |  ├── Google provider adapter       [RUNNING] agent-1  [x]   |
|  +--------+ |  ├── GitHub provider adapter       [BLOCKED]          [x]   |
|              |  |   blocked by: Google provider adapter                    |
|   260px      |  └── Microsoft provider adapter   [PENDING]           [x]   |
|              |                                                             |
+============================================================================+

Phase Sidebar

+------------+
| PHASES [+][sparkles]   <-- [+] adds phase, [sparkles] details all phases
|            |
| +--------+ |
| | 1      | |    Phase number
| | DB     | |    Phase name (truncated)
| | Schema | |
| | [DONE] | |    StatusBadge (small)
| | 3/3    | |    "X/Y tasks" count
| +--------+ |
| +--------+ |
| |*2     *| |    * = active/selected (left blue border + accent bg)
| | OAuth  | |
| | Flow   | |
| |[READY] | |
| | 0 tasks| |    "Needs decomposition" if 0 tasks
| | dep: 1 | |    "depends on: Phase X" (if dependencies)
| +--------+ |
|            |
| [New phase name___]   <-- inline input when adding
|            |
+------------+

Phase Actions (sidebar header)

  PHASES  [Detailing (2)]  [+]  [Detail All]
           ^^^^^^^^^^^^^^        ^^^^^^^^^^^
           spinner when agents   sparkles icon
           are detailing         disabled if no eligible phases

Phase Detail Panel

Header

+------------------------------------------------------------------------+
|  Phase 2: Implement OAuth Flow            [READY]  [git] branch  [...] |
|                                                         |          |
|                                                    branch badge    v
|                                                               +--------+
|                                                               | Delete |
|                                                               | Phase  |
|                                                               +--------+
+------------------------------------------------------------------------+
  • Phase name is editable (click to toggle inline input)
  • [...] dropdown: Delete Phase

When No Tasks and No Agent Running

+------------------------------------------------------------------------+
|  Phase 2: Implement OAuth Flow            [READY]  [ Detail Tasks ]    |
+------------------------------------------------------------------------+

Detailing In Progress

+------------------------------------------------------------------------+
|  Phase 2: Implement OAuth Flow            [READY]  [spinner] Detailing |
+------------------------------------------------------------------------+

Pending Review Banner

+------------------------------------------------------------------------+
|  [!] This phase is pending review. Go to the Review tab to review.     |
+------------------------------------------------------------------------+

Phase Content Editor

+------------------------------------------------------------------------+
|  Implement the OAuth 2.0 authorization code flow with PKCE             |
|  extension for public clients.                                         |
|                                                                        |
|  Support Google, GitHub, and Microsoft as identity providers            |
|  with configurable scopes.                                             |
+------------------------------------------------------------------------+

Tiptap editor, auto-saves via usePhaseAutoSave.

Dependencies Section

  Dependencies
  [+ Add dependency v]     <-- dropdown of other phases
  * Phase 1: DB Schema  [DONE]  [x]    <-- status dot + remove button
  * Phase 4: Testing    [PENDING] [x]

ChangeSet Banner (after detail agent completes)

+------------------------------------------------------------------------+
|  [v] 5 tasks created                                   [>] expand      |
|                                                                        |
|     + task   "Set up OAuth routes"                                     |
|     + task   "Implement PKCE flow"                                     |
|     + task   "Google provider adapter"                                 |
|     + task   "GitHub provider adapter"                                 |
|     + task   "Microsoft provider adapter"                              |
|                                                                        |
|                                      [ Revert ]  [ Dismiss ]          |
+------------------------------------------------------------------------+

Tasks Section

  Tasks (3/5)

  ├── Set up OAuth routes       [PENDING]                          [x]
  ├── Implement PKCE flow       [PENDING]                          [x]
  ├── Google provider adapter   [RUNNING]  agent: blue-fox-7       [x]
  ├── GitHub provider adapter   [BLOCKED]                          [x]
  |   blocked by: Google provider adapter
  └── Microsoft provider adapter [PENDING]                         [x]
  • Tree connectors: ├── for middle items, └── for last
  • Agent name links to /inbox when assigned
  • Delete [x] appears on hover (Shift+click bypasses confirm)
  • <DependencyIndicator> shown below blocked tasks
  • Clicking a task row opens <TaskDetailModal>

Empty State (no phases)

+============================================================================+
|              |                                                             |
|  PHASES [+]  |                                                             |
|              |         No phases yet                                       |
|              |                                                             |
|              |         [spinner] Planning phases...                        |
|              |            -- or --                                          |
|              |         [sparkles Plan Phases]  or  [ Add Phase ]           |
|              |                                                             |
+============================================================================+

Task Detail Modal (overlay)

+----------------------------------------------------------+
|  Set up OAuth routes                              [x]    |
|                                                          |
|  Status      [PENDING]     |  Priority    normal         |
|  Phase       2. OAuth Flow |  Type        execute        |
|  Agent       (none)        |                             |
|                                                          |
|  Description                                             |
|  Create Express routes for /auth/login, /auth/callback,  |
|  and /auth/logout with proper middleware chain.           |
|                                                          |
|  Dependencies                                            |
|  * DB Schema Migration  [DONE]                           |
|                                                          |
|  Blocks                                                  |
|  * GitHub provider adapter  [BLOCKED]                    |
|                                                          |
|                    [ Queue Task ]  [ Stop Task ]         |
+----------------------------------------------------------+

Source

  • packages/web/src/components/ExecutionTab.tsx
  • packages/web/src/components/execution/PhaseSidebarItem.tsx
  • packages/web/src/components/execution/PhaseDetailPanel.tsx
  • packages/web/src/components/execution/PhaseActions.tsx
  • packages/web/src/components/execution/PlanSection.tsx
  • packages/web/src/components/TaskRow.tsx
  • packages/web/src/components/TaskDetailModal.tsx