diff --git a/design/pap-53-information-architecture/index.html b/design/pap-53-information-architecture/index.html new file mode 100644 index 00000000000..d46b419d832 --- /dev/null +++ b/design/pap-53-information-architecture/index.html @@ -0,0 +1,325 @@ + + + + + +PAP-53 — Information Architecture wireframes + + + +
+
+ + PAP-53 · Information Architecture
Jump to a screen
+ +
+ +
+ +
+
+
PAP-53 · Wireframes
+

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.

+
+ 5 screens + Desktop + mobile + Lo-fi · monochrome + Plan: PAP-53 plan doc +
+
+ +
+
Overview
+

What this set covers

+

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

+
+
    +
  • 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).
  • +
+
+
+ + +
+
Screen 1 · Navigation
+

1.Left navigation (redesigned)

+

The full sidebar with every nav change applied. Numbered callouts map to the change list.

+
+
+
01-sidebar.svg1280×800 · desktop
+ Left navigation desktop wireframe +
+
+
mobile375×812
+ Left navigation mobile wireframe +
+
+
+

Annotations

+
    +
  • 1 — Conference room: new item above New task, chat-bubble icon.
  • +
  • 2 — New Issue → New task; standard nav label color.
  • +
  • 3 — Projects: new Work nav item, opens the list view.
  • +
  • 4 — Artifacts: new Work item.
  • +
  • 5 — Project tiles: gray rounded rectangle + folder icon.
  • +
  • 6 — Agents section adapts to active/recent (screen 4).
  • +
+
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.
+
+
+
+
+ + +
+
Screen 2 · Projects
+

2.Projects list view

+

Opened from the new "Projects" Work nav item. Each project is a row with an at-a-glance summary; clicking a row opens today's project detail view unchanged.

+
+
+
02-projects-list.svg1280×800 · desktop
+ Projects list desktop wireframe +
+
+
mobile375×812
+ Projects list mobile wireframe +
+
+
+
Reference — today's project detailfrom PAP-53
+ Current project detail view +
+
+

Annotations

+
    +
  • 1 — Gray folder tile (same primitive as the sidebar).
  • +
  • 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).
+
+
+
+
+ + +
+
Screen 3 · Agents
+

3.Agents list view ("See all")

+

Opened from "See all" in the Agents sidebar section. Each row carries the key actions from the agent detail page; clicking a row opens today's agent detail unchanged.

+
+
+
03-agents-list.svg1280×800 · desktop
+ Agents list desktop wireframe +
+
+
mobile375×812
+ Agents list mobile wireframe +
+
+
+
Reference — detail page key actionsfrom PAP-53
+ Agent detail key actions +
+
+

Annotations

+
    +
  • 1 — Identity: icon, name, role, budget spent/limit, last active.
  • +
  • 2 — Key actions inline: Assign Task, Run Heartbeat, Pause/Resume, status, ⋯.
  • +
  • 3 — Entry point: "See all" link in the sidebar Agents section.
  • +
+
Why this changes: Surfaces the actions you'd otherwise have to open each agent to reach. On mobile the action buttons wrap to a second line within the card. Pause vs Resume toggles on the agent's current status.
+
+
+
+
+ + +
+
Screen 4 · Agents (diagnostic)
+

4.Agents section — active vs. recently-active

+

How the sidebar Agents section chooses what to show. Desktop-only diagnostic.

+
+
04-agents-states.svg1280×800
+ Agents section states wireframe +
+
+
Rule: If any agent has a live run → show only those (state A). If none are running → show up to 5 recently-active agents sorted by last heartbeat, plus "See all" (state B). "See all" always opens the full agents list view (screen 3).
+
+
+ + +
+
Screen 5 · Projects (detail)
+

5.Project tile — customize icon & color

+

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

+
+
05-project-customize.svg1280×800
+ Project tile customize 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.
+
+
+ +
+
For reviewer
+

Open questions

+
+
    +
  • Terminology — The issue calls items "tasks (formerly issues)". Do you want the Issues nav item / page renamed to Tasks globally, or only the "New task" button + the "Tasks" count on project rows for now?
  • +
  • Conference room — Placeholder only: it appears in nav but routes to an empty page for now. Confirm that's the intended scope.
  • +
  • Projects: dual presence — Keep both the new "Projects" Work nav item (→ list view) and the existing collapsible PROJECTS section (individual projects)? The wireframes assume yes.
  • +
  • Row data — Task count and budget aren't on the Project type today. OK to add a lightweight count/budget lookup for the list rows (slightly more backend work)?
  • +
  • Project icon — Customizable icon needs a new project.icon field + picker. Confirm we should build icon customization now vs. color-only first.
  • +
  • Ordering within Work — Proposed order: Issues, Projects, Artifacts, Routines, Goals. Adjust freely.
  • +
+
+
+ + +
+
+ + + + + + diff --git a/design/pap-53-information-architecture/screenshots/agent-detail-ref.png b/design/pap-53-information-architecture/screenshots/agent-detail-ref.png new file mode 100644 index 00000000000..869690bdc83 Binary files /dev/null and b/design/pap-53-information-architecture/screenshots/agent-detail-ref.png differ diff --git a/design/pap-53-information-architecture/screenshots/project-detail-ref.png b/design/pap-53-information-architecture/screenshots/project-detail-ref.png new file mode 100644 index 00000000000..6afa42821bc Binary files /dev/null and b/design/pap-53-information-architecture/screenshots/project-detail-ref.png differ diff --git a/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg b/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg new file mode 100644 index 00000000000..860c92b6d88 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/01-sidebar-mobile.svg @@ -0,0 +1,77 @@ + + + + + Paperclip App + × + + + + + + + + Conference room + + + New task + + Dashboard + + Inbox + + + WORK + + Issues + + + Projects + + Artifacts + + Routines + + Goals + + + PROJECTS + + + + Onboarding v3 + + + + + NUX hardening + + + + AGENTS + + ClaudeCoder + + 2 live + + QA-Bot + + 1 live + + + + Home + Issues + + + Agents + Inbox + + + + + 1 + + 5 + + diff --git a/design/pap-53-information-architecture/wireframes/01-sidebar.svg b/design/pap-53-information-architecture/wireframes/01-sidebar.svg new file mode 100644 index 00000000000..fe469532697 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/01-sidebar.svg @@ -0,0 +1,137 @@ + + + + + + + + Paperclip App + + + + + + + + + + + + Conference room + + + + + + New task + + + + Dashboard + + + Inbox + + + WORK + + + Issues + + + + + Projects + + + Artifacts + + + Routines + + + Goals + + + PROJECTS + + + + + + + Onboarding v3 + + + + + NUX hardening + + + + + Billing rework + + + + AGENTS + + + + + + ClaudeCoder + + 2 live + + + + QA-Bot + + 1 live + + + + COMPANY + + Org + + Settings + + + Main content area + + (Selected nav item renders here — e.g. 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) + + + + + + 1 + + + 2 + + 3 + + + 4 + + + 5 + + + 6 + + diff --git a/design/pap-53-information-architecture/wireframes/02-projects-list-mobile.svg b/design/pap-53-information-architecture/wireframes/02-projects-list-mobile.svg new file mode 100644 index 00000000000..6341542ab54 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/02-projects-list-mobile.svg @@ -0,0 +1,58 @@ + + + + + ≡ + Projects + + + + + + Sort: Name + + + + + Add + + + + + + + + Onboarding v3 + Revamp first-run onboarding. + 24 tasks · $1,200/mo · Active + + + + + + NUX hardening + Stabilize BoardChat + QA. + 11 tasks · No budget · Active + + + + + + Billing rework + Per-project spend tracking. + 7 tasks · $500/mo · Paused + + + + + Home + Issues + + + Agents + Inbox + + + + 2 + + diff --git a/design/pap-53-information-architecture/wireframes/02-projects-list.svg b/design/pap-53-information-architecture/wireframes/02-projects-list.svg new file mode 100644 index 00000000000..00ae70d38be --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/02-projects-list.svg @@ -0,0 +1,96 @@ + + + + + + Paperclip App + + Projects + Work + Artifacts + + + + PROJECTS + Projects + + + + + Sort: Name + + + + + Add project + + + + + + Project + Tasks + Budget + Status + + + + + + + + + Onboarding v3 + Revamp the first-run onboarding and CEO chat flow. + 24 + $1,200 / mo + Active + + + + + + + + NUX hardening + Stabilize BoardChat, fix end-to-end QA failures. + 11 + — + Active + + + + + + + + Billing rework + Migrate budgets and per-project spend tracking. + 7 + $500 / mo + Paused + + + + + + + + Docs site + Public documentation and changelog. + 3 + — + Active + + + + + + + 1 + + 2 + + 3 + + diff --git a/design/pap-53-information-architecture/wireframes/03-agents-list-mobile.svg b/design/pap-53-information-architecture/wireframes/03-agents-list-mobile.svg new file mode 100644 index 00000000000..15ae85e7e97 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/03-agents-list-mobile.svg @@ -0,0 +1,50 @@ + + + + ≡ + All agents + + + + + Filter: All status + + + + + + + ClaudeCoder + Software Engineer · 2 live + $42 / $200 mo · active 2m ago + + Assign + ▷ Heartbeat + ❙❙ Pause + + + + + + + Designer + Product Design · paused + $0 / $80 mo · active 3d ago + + Assign + ▷ Heartbeat + ▷ Resume + + + + + Home + Issues + + + Agents + Inbox + + + + 2 + + diff --git a/design/pap-53-information-architecture/wireframes/03-agents-list.svg b/design/pap-53-information-architecture/wireframes/03-agents-list.svg new file mode 100644 index 00000000000..74d61336a07 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/03-agents-list.svg @@ -0,0 +1,91 @@ + + + + + + Paperclip App + AGENTS + ClaudeCoder · 2 live + QA-Bot · 1 live + See all → + + + AGENTS + All agents + + + + Filter: All status + + + + + New agent + + + + + + + + ClaudeCoder + Software Engineer · $42 / $200 mo · active 2m ago + + + 2 live + + + Assign Task + ▷ Run Heartbeat + ❙❙ Pause + active + ⋯ + + + + + + QA-Bot + Quality Assurance · $18 / $100 mo · active 5m ago + + 1 live + + Assign Task + ▷ Run Heartbeat + ❙❙ Pause + active + ⋯ + + + + + + Designer + Product Design · $0 / $80 mo · active 3d ago + + Assign Task + ▷ Run Heartbeat + ▷ Resume + paused + ⋯ + + + + + + CTO + Chief Technology Officer · $61 / $300 mo · active 1h ago + + Assign Task + ▷ Run Heartbeat + ❙❙ Pause + active + ⋯ + + + + + + 1 + + 2 + + 3 + + diff --git a/design/pap-53-information-architecture/wireframes/04-agents-states.svg b/design/pap-53-information-architecture/wireframes/04-agents-states.svg new file mode 100644 index 00000000000..8053093dce1 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/04-agents-states.svg @@ -0,0 +1,87 @@ + + + + Agents section — two states + The AGENTS sidebar section adapts to whether any agents are currently running. + + + A · Active agents present + Show only the agents with live runs. + + + AGENTS + + + + + ClaudeCoder + + 2 live + + QA-Bot + + 1 live + + CTO + + 1 live + + See all → + + + + B · No active agents + Fall back to recently-active, capped at 5, with “See all”. + + + AGENTS + + + Recently active + + + ClaudeCoder + 2m ago + + QA-Bot + 9m ago + + CTO + 1h ago + + Designer + 3h ago + + Researcher + 1d ago + + See all → + + + + + + + See all opens + + + + All agents (list view → 03) + + + Agent name + key actions + Assign · Heartbeat · Pause · ⋯ + + + Agent name + key actions + Assign · Heartbeat · Resume · ⋯ + + + Row click → agent detail page + (unchanged from today) + + + + + Recently-active fallback: max 5 rows, sorted by last heartbeat, then “See all”. + + diff --git a/design/pap-53-information-architecture/wireframes/05-project-customize.svg b/design/pap-53-information-architecture/wireframes/05-project-customize.svg new file mode 100644 index 00000000000..a379fabc6c7 --- /dev/null +++ b/design/pap-53-information-architecture/wireframes/05-project-customize.svg @@ -0,0 +1,78 @@ + + + + Project tile — customize icon & color + Default is a neutral gray rounded rectangle with a folder icon. Clicking the tile opens a picker. + + + Default (neutral) + + + + + Onboarding v3 + + + After customizing (color + icon) + + + + + + + + + + + + + (swatch fill shown gray here — monochrome wireframe) + + + Picker popover + + + Customize project tile + + + Color + + + + + + + + + + + Icon + + + + + + + + + + + + + + ★ + + + + 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. + +