diff --git a/design/pap-53-information-architecture/index.html b/design/pap-53-information-architecture/index.html index d46b419d832..cee784f6ff7 100644 --- a/design/pap-53-information-architecture/index.html +++ b/design/pap-53-information-architecture/index.html @@ -111,8 +111,8 @@ 3Agents list view 4Agents section states 5Project tile customize -

Open questions

- ?For reviewer +

Resolved decisions

+ ✓Board answers @@ -122,6 +122,7 @@

Information Architecture — left nav & related views

Low-fidelity wireframes for the proposed left-navigation restructure and the two new list views (Projects, Agents). Monochrome and structural only — color, spacing, and final iconography are intentionally not represented. Click any wireframe to zoom.

+ Revised v2 · per board feedback 5 screens Desktop + mobile Lo-fi · monochrome @@ -132,15 +133,18 @@
Overview

What this set covers

-

Six discrete changes to the main app's information architecture, all sketched below.

+

Revised after board review. Nav structure, ordering, and the open questions are now locked per the board's direction.

    -
  • Conference room — new placeholder nav item above "New task", chat-bubble icon (screen 1).
    • -
  • New Issue → New task — renamed; label uses the standard nav text color, not the muted treatment it has today (screen 1).
    • -
  • Artifacts — new item in the Work section (screen 1).
    • -
  • Projects as a Work nav item — opens an all-projects list view: per-row overview, task count, budget; row click opens today's project detail (screens 1 & 2).
    • -
  • Project tiles — colored squircle becomes a neutral gray rounded rectangle with a folder icon; color + icon are user-customizable (screens 1 & 5).
    • -
  • Agents section — show active agents only when any are running; otherwise show up to 5 recently-active with "See all" → agents list view with per-row key actions (screens 3 & 4).
    • +
  • Top level (no section label): Conference room, New Task, Dashboard, Inbox.
    • +
  • Work (exact order): Tasks, Routines, Goals, Workspaces, Artifacts, Projects.
    • +
  • Conference room — new placeholder top-level item, chat-bubble icon, empty page for now (screen 1).
    • +
  • New Issue → New Task — renamed; standard nav label color (screen 1).
    • +
  • Issues → Tasks — renamed globally across the frontend (nav item, page, all references).
    • +
  • Artifacts — new Work item; Projects — new Work item at the bottom of Work, opens the projects list view (screens 1 & 2).
    • +
  • Removed — the old collapsible PROJECTS section (per-project rows in the sidebar) is deleted (screen 1).
    • +
  • Project tiles — neutral gray rounded rectangle + folder icon; color-only customization this phase, folder icon fixed (screens 2 & 5).
    • +
  • Agents section — active agents only when any are running; otherwise up to 5 recently-active + "See all agents" → agents list view with per-row key actions (screens 3 & 4).
@@ -163,14 +167,15 @@

Annotations

-
Why this changes: Promotes the two highest-traffic destinations (Projects, a future Conference room) into stable nav, and makes the Work section the single home for cross-cutting views (Issues, Projects, Artifacts). On mobile the sidebar is a full-height drawer; the bottom tab bar is unchanged.
+
Why this changes: Locks the nav to the board's specified structure and order. Work becomes the single home for cross-cutting views; per-project rows leave the sidebar entirely (you reach a project via Projects → list → detail). On mobile the sidebar is a full-height drawer; the bottom tab bar is unchanged.
@@ -202,7 +207,7 @@
  • 2 — Overview = project description, one line, truncated.
  • 3 — Task count + budget + status per row.
    • -
    Why this changes: Gives projects a real index page instead of only the sidebar list. On mobile each row reflows to a card with the metrics on a second line. Note: task count and budget are not on the Project type today — they need wiring (see open questions).
    +
    Why this changes: Gives projects a real index page instead of only the sidebar list. On mobile each row reflows to a card with the metrics on a second line. Task count and budget are not on the Project type today — the board approved adding a lightweight count + budget lookup for these rows.
    @@ -258,28 +263,29 @@
    Screen 5 · Projects (detail)

    5.Project tile — customize icon & color

    -

    Default neutral tile and the picker opened by clicking it. Desktop-only overlay.

    -
    +

    Default neutral tile and the color picker opened by clicking it. Color-only this phase; the folder icon is fixed. Desktop-only overlay.

    +
    05-project-customize.svg1280×800
    - Project tile customize wireframe + Project tile color wireframe
    -
    Why this changes: Default tiles are neutral so the sidebar reads calmly; users opt into color/icon only where it helps them scan. The same tile + picker is reused in the sidebar PROJECTS section and the Projects list rows. project.color already exists; an icon field is new.
    +
    Why this changes: Per board direction, build color only first — every tile keeps a folder icon (custom-icon picker deferred). Default tiles are neutral gray. Since the per-project sidebar list is removed, tiles live in the Projects list rows and the project detail header, so the color control attaches to the project itself. project.color already exists — no new field needed this phase.
    -
    For reviewer
    -

    Open questions

    +
    Board answers
    +

    Resolved decisions

    +
    Nesting confirmed: Projects (nav) → projects list in the main pane → row → project detail. "See all agents" → agents list in the main pane → row → agent detail.
    diff --git a/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg b/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg index 860c92b6d88..2ce6b47dd55 100644 --- a/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg +++ b/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg @@ -15,54 +15,49 @@ Conference room - New task - - Dashboard - - Inbox + New Task + + Dashboard + + Inbox - WORK - - Issues - - - Projects - - Artifacts - - Routines - - Goals - - - PROJECTS - - - - Onboarding v3 - - - - - NUX hardening - + WORK + + Tasks + + Routines + + Goals + + Workspaces + + Artifacts + + + Projects - AGENTS - - ClaudeCoder - - 2 live - - QA-Bot - - 1 live + AGENTS + + ClaudeCoder + + 2 live + + QA-Bot + + 1 live + See all agents → + + + COMPANY + + Org · Skills · Costs · Activity · Settings Home - Issues + Tasks ＋ Agents Inbox @@ -71,7 +66,7 @@ 1 - - 5 + + 3 diff --git a/design/pap-53-information-architecture/wireframes/01-sidebar.svg b/design/pap-53-information-architecture/wireframes/01-sidebar.svg index fe469532697..f71bd859dac 100644 --- a/design/pap-53-information-architecture/wireframes/01-sidebar.svg +++ b/design/pap-53-information-architecture/wireframes/01-sidebar.svg @@ -11,20 +11,19 @@ - + - Conference room - + - New task + New Task @@ -34,85 +33,76 @@ Inbox - WORK - - - Issues - - - - - Projects - - - Artifacts + WORK + + + Tasks - - Routines + + Routines - - Goals - - - PROJECTS - + - - - - - Onboarding v3 - - - - - NUX hardening - - - - - Billing rework - + + Goals + + + Workspaces + + + Artifacts + + + + + Projects - AGENTS - + - + AGENTS + + - - ClaudeCoder - - 2 live + + ClaudeCoder + + 2 live - - QA-Bot - - 1 live + + QA-Bot + + 1 live + + See all agents → - COMPANY - - Org - - Settings + COMPANY + + Org + + Skills + + Costs + + Activity + + Settings - + Main content area - (Selected nav item renders here — e.g. the Projects list view) + (Selected nav item renders here — e.g. clicking Projects opens the projects list view) - - What changed in the left nav - 1 Conference room — NEW item above New task, chat-bubble icon - 2 New Issue → New task; label uses the standard nav color - 3 Projects — NEW Work nav item; opens the all-projects list view - 4 Artifacts — NEW item in the Work section - 5 Project tiles — gray rounded rectangle + folder icon (was a - colored squircle); color + icon are user-customizable - 6 Agents — active agents only; recently-active fallback (see 04) + + Left nav — final structure (per board direction) + 1 Conference room — NEW top-level item (chat bubble), placeholder page + 2 New Issue → New Task; standard nav label color + 3 Issues → Tasks — renamed globally across the frontend + 4 Artifacts — NEW Work item + 5 Projects — NEW Work item (bottom of Work); opens the projects list view + 6 REMOVED: the old collapsible PROJECTS section (per-project rows in nav) + 7 Agents — active only (or 5 recently active) + “See all agents” + Work order: Tasks · Routines · Goals · Workspaces · Artifacts · Projects @@ -123,15 +113,15 @@ 2 - 3 + + 3 - - 4 + + 4 - - 5 + 5 - - 6 + + 7 diff --git a/design/pap-53-information-architecture/wireframes/02-projects-list.svg b/design/pap-53-information-architecture/wireframes/02-projects-list.svg index 00ae70d38be..aa018b2941f 100644 --- a/design/pap-53-information-architecture/wireframes/02-projects-list.svg +++ b/design/pap-53-information-architecture/wireframes/02-projects-list.svg @@ -5,10 +5,10 @@ Paperclip App - - Projects - Work - Artifacts + WORK + Artifacts + + Projects diff --git a/design/pap-53-information-architecture/wireframes/03-agents-list.svg b/design/pap-53-information-architecture/wireframes/03-agents-list.svg index 74d61336a07..841a230856f 100644 --- a/design/pap-53-information-architecture/wireframes/03-agents-list.svg +++ b/design/pap-53-information-architecture/wireframes/03-agents-list.svg @@ -8,7 +8,7 @@ AGENTS ClaudeCoder · 2 live QA-Bot · 1 live - See all → + See all agents→ AGENTS diff --git a/design/pap-53-information-architecture/wireframes/04-agents-states.svg b/design/pap-53-information-architecture/wireframes/04-agents-states.svg index 8053093dce1..6b8f490a8ec 100644 --- a/design/pap-53-information-architecture/wireframes/04-agents-states.svg +++ b/design/pap-53-information-architecture/wireframes/04-agents-states.svg @@ -26,7 +26,7 @@ 1 live - See all → + See all agents → @@ -54,7 +54,7 @@ Researcher 1d ago - See all → + See all agents → diff --git a/design/pap-53-information-architecture/wireframes/05-project-customize.svg b/design/pap-53-information-architecture/wireframes/05-project-customize.svg index a379fabc6c7..8b49842014a 100644 --- a/design/pap-53-information-architecture/wireframes/05-project-customize.svg +++ b/design/pap-53-information-architecture/wireframes/05-project-customize.svg @@ -2,77 +2,73 @@ font-family="-apple-system, system-ui, sans-serif" fill="#fff" stroke="#000" stroke-width="1.5"> - Project tile — customize icon & color - Default is a neutral gray rounded rectangle with a folder icon. Clicking the tile opens a picker. + Project tile — change color (folder icon fixed) + Default is a neutral gray rounded rectangle with a folder icon. Color is user-customizable now; the icon stays a folder for this phase. - Default (neutral) + Default (neutral gray) Onboarding v3 - - After customizing (color + icon) + + After choosing a color (icon unchanged) - + - - + + - - + + - (swatch fill shown gray here — monochrome wireframe) + (swatch fills shown as grays — monochrome wireframe; real palette is color) - - Picker popover + + Color picker popover - - Customize project tile + + Project color - Color - - - - - - - - - + + Preview + + + + + folder icon is fixed - Icon - - - - - - - - - - - - - - ★ + + Color + + + + + + + + - - Reset to gray - Save + + + + Reset to gray + Save 5 - — Same tile + picker is reused in the sidebar PROJECTS section and the Projects list rows. - — Persisting color already exists (project.color). Icon needs a new project.icon field. + — Phase 1: color only. The icon grid (custom icons) is deferred; every tile shows a folder. + — Persisting color already exists (project.color). No new field needed for this phase. + — Tiles appear in the Projects list rows and the project detail header (the old sidebar + per-project list is removed), so the color control lives on the project itself.