Information Architecture

Entities

The core objects a person deals with to close their jobs. Screens display entities; entities grow out of jobs, not out of a competitor's menu. Nine core entities, plus objects held under question.

Under question (no entity, no screen): household / shared view JH1, Gmail scan and screenshot import v2, AI assistant JH2, budgets, credit score, investments, bill negotiation (all explicitly cut). A scope note: the free tier is uncapped on both subscription count (per D3) and bank connections (July 2026 product decision), over the older CLAUDE.md "up to 10" and "up to 2 bank accounts" lines.

Sitemap

Sixteen screens across six clusters, derived from the entities and from what each person is trying to do. Every screen names the job it serves. Amber marks Emma's primary path. Empty, error, and loading are states, shown in the flows, not screens.

Navigation

A four-item bottom tab bar (thumb reach on a phone), deliberately small so the product stays calm. Each tab is an entry into one job cluster.

History and Trends does not get a tab (it is Pro-gated, and a mostly-locked tab would break calm). Upgrade is not a tab either; it appears at the gate, in context.

Flows

How the personas actually move, with decision points, states, and honest dead ends, not just the happy path. Rectangles are screens matching the sitemap; diamonds are decisions; stadium nodes are states and outcomes.

flowchart TD
  classDef state fill:#fff7e6,stroke:#d9a441,color:#5c4813;
  classDef success fill:#e9f5ee,stroke:#3f9c68,color:#1e4d33;
  classDef dead fill:#fdeaea,stroke:#c96a6a,color:#6b2b2b;

  Welcome["Welcome / Value Intro"] --> PathQ{"Bank or privacy path?"}
  PathQ -->|Privacy| AddSub["Add Subscription"]
  PathQ -->|Bank| ConnectBank["Connect Bank"]
  ConnectBank --> SyncLoad(["Loading: syncing your bank"])
  SyncLoad --> ConnOK{"Connection succeeded?"}
  ConnOK -->|no| ConnErr(["Error: could not connect"])
  ConnErr --> RetryQ{"Try again?"}
  RetryQ -->|yes| ConnectBank
  RetryQ -->|no| FallbackQ{"Use the manual path instead?"}
  FallbackQ -->|yes| AddSub
  FallbackQ -->|no| StuckExit(["Dead end: leaves without any list"])
  ConnOK -->|yes| FoundQ{"Any recurring charges found?"}
  FoundQ -->|no| NoneEmpty(["Empty: no recurring charges found"])
  NoneEmpty --> AddSub
  FoundQ -->|yes| Reveal["Guided Reveal"]
  AddSub --> Reveal
  Reveal --> Home["Home / Subscription List"]
  Home --> Success(["Success: sees all charges calmly"])

  class SyncLoad,ConnErr,NoneEmpty state
  class Success success
  class StuckExit dead
      

flowchart TD
  classDef state fill:#fff7e6,stroke:#d9a441,color:#5c4813;
  classDef success fill:#e9f5ee,stroke:#3f9c68,color:#1e4d33;
  classDef dead fill:#fdeaea,stroke:#c96a6a,color:#6b2b2b;

  Welcome2["Welcome / Value Intro"] --> PathQ2{"Bank or privacy path?"}
  PathQ2 -->|Bank| BankRef(["Bank path: see Flow A"])
  PathQ2 -->|Privacy| AddSub2["Add Subscription"]
  AddSub2 --> PresetLoad(["Loading: preset library"])
  PresetLoad --> PresetOK{"Preset library loaded?"}
  PresetOK -->|no| LibErr(["Error: presets unavailable"])
  LibErr --> ManualCustom(["Step: add a custom subscription by hand"])
  PresetOK -->|yes| SearchQ{"Service in the presets?"}
  SearchQ -->|yes| AddFromPreset(["Step: add from a preset, prefilled"])
  SearchQ -->|no| ManualCustom
  AddFromPreset --> MoreQ{"Add another?"}
  ManualCustom --> MoreQ
  MoreQ -->|yes| AddSub2
  MoreQ -->|no| EnoughQ{"Anything added yet?"}
  EnoughQ -->|no| EmptyReveal(["Empty: nothing to reveal yet"])
  EmptyReveal --> AbandonRisk(["Dead end: abandons half-done, manual entry trap"])
  EnoughQ -->|yes| Reveal2["Guided Reveal"]
  Reveal2 --> Home2["Home / Subscription List"]
  Home2 --> Success2(["Success: private list, no bank"])

  class PresetLoad,LibErr,EmptyReveal state
  class Success2 success
  class AbandonRisk dead
      

flowchart TD
  classDef state fill:#fff7e6,stroke:#d9a441,color:#5c4813;
  classDef success fill:#e9f5ee,stroke:#3f9c68,color:#1e4d33;
  classDef dead fill:#fdeaea,stroke:#c96a6a,color:#6b2b2b;

  Home3["Home / Subscription List"] --> Detail3["Subscription Detail"]
  Detail3 --> CancelQ{"Cancel this one?"}
  CancelQ -->|no| Home3
  CancelQ -->|yes| Guide["Cancel Guide"]
  Guide --> DepthQ{"Free basic steps or Pro full guide?"}
  DepthQ -->|"Basic, free"| BasicSteps(["Step: basic instruction, link plus steps"])
  DepthQ -->|"Wants full guide"| Upgrade3["Upgrade / Tendd Pro"]
  Upgrade3 --> PayQ{"Upgrade now?"}
  PayQ -->|no| BasicSteps
  PayQ -->|yes| FullGuide(["Step: full guide plus direct link"])
  BasicSteps --> DoneQ{"Managed to cancel?"}
  FullGuide --> DoneQ
  DoneQ -->|yes| Win["Cancel Win Moment"]
  DoneQ -->|"no, blocked by retention flow"| BlockedErr(["Error: stuck in the service dark pattern"])
  BlockedErr --> HelpQ{"In-app help offered?"}
  HelpQ -->|no| StuckCancel(["Dead end: gives up, no in-app next step"])
  HelpQ -->|yes| Guide
  Win --> ShareQ{"Share the win?"}
  ShareQ -->|yes| Share["Share Snapshot"]
  ShareQ -->|no| Success3(["Success: saved money, calm"])
  Share --> Success3

  class BlockedErr state
  class Success3 success
  class StuckCancel dead
      

flowchart TD
  classDef state fill:#fff7e6,stroke:#d9a441,color:#5c4813;
  classDef success fill:#e9f5ee,stroke:#3f9c68,color:#1e4d33;
  classDef dead fill:#fdeaea,stroke:#c96a6a,color:#6b2b2b;

  Notif(["Event: notification, price change or payment failed"]) --> Alerts["Alerts / Activity"]
  Alerts --> AnyQ{"Any alerts to show?"}
  AnyQ -->|"load failed"| AlertErr(["Error: could not load alerts"])
  AlertErr --> RetryA{"Retry?"}
  RetryA -->|yes| Alerts
  RetryA -->|no| HomeA["Home / Subscription List"]
  AnyQ -->|no| AllClear(["Empty: all clear"])
  AllClear --> HomeA
  AnyQ -->|yes| TypeQ{"Alert type?"}
  TypeQ -->|"Trial ending or unusual, Pro"| UpgradeA["Upgrade / Tendd Pro"]
  TypeQ -->|"Price change or payment failed, free"| DetailA["Subscription Detail"]
  UpgradeA --> HomeA
  DetailA --> NeedQ{"Price change or payment failure?"}
  NeedQ -->|"price change"| ActQ{"Keep or cancel?"}
  ActQ -->|keep| SuccessA(["Success: caught it early, nothing to do"])
  ActQ -->|cancel| GuideA["Cancel Guide"]
  NeedQ -->|"payment failure"| FixQ{"Is the fix inside the app?"}
  FixQ -->|"yes"| SuccessA
  FixQ -->|"no, at the bank or merchant"| NoNext(["Dead end: no in-app next step for a failed payment"])

  class AlertErr,AllClear state
  class SuccessA success
  class NoNext dead
      

Coverage matrix

Jobs against screens. A checkmark means the screen genuinely helps close that job. A gate that only unlocks a job does not count. The orphan column is highlighted.

Outcome: zero orphan jobs, one orphan screen. Every job has a home. The only column with no checkmark is Upgrade / Tendd Pro, which traces to decisions D3 and D4, not to a job. It is retained by design as a contextual gate over the Pro surfaces, not removed. Key: Wel Welcome, Pth Path Choice, Bnk Connect Bank, Add Add Subscription, Rev Guided Reveal, Hom Home, Det Subscription Detail, Alr Alerts, Gde Cancel Guide, Win Cancel Win, Shr Share Snapshot, His History and Trends, Upg Upgrade, Con Connections, Prv Data and Privacy, Set Settings.

Critique

Four defect classes, most dangerous first. Fixes are proposals for Prompt 2, not applied here. All dead-end and missing-state fixes are states and copy on existing screens, so the 16-screen inventory does not change.

1. Dead ends

2. Missing states

3. Excess depth

No violation. First-session J-MAIN sits at exactly 3 taps, at the ceiling. Watch item: do not add any onboarding step, or the main job moves to 4 taps. Steady-state J-MAIN is 0 to 1 tap. J4 from a notification is about 2 taps; J2 for Claudia is 2 taps to the guide.

4. Orphans

One orphan screen: Upgrade / Tendd Pro, retained as a contextual gate justified by D3 and D4. No orphan jobs. Every job in JTBD is served by at least one screen.

Site graph

Every screen and transition, grouped by cluster. The full page-level detail lives in the library below.

flowchart TD
  subgraph OB["1 Onboarding"]
    W["Welcome"] --> PC["Path Choice"]
    PC --> CB["Connect Bank"]
    PC --> AS["Add Subscription"]
    CB --> GR["Guided Reveal"]
    AS --> GR
  end
  subgraph CORE["2 Core"]
    HOME["Home"] --> DET["Subscription Detail"]
  end
  subgraph SA["3 Stay Ahead"]
    AL["Alerts"]
  end
  subgraph CC["4 Cut and Celebrate"]
    CG["Cancel Guide"] --> CW["Cancel Win"] --> SH["Share Snapshot"]
  end
  subgraph PR["5 Depth Pro"]
    HT["History and Trends"] --> UP["Upgrade"]
  end
  subgraph AC["6 Account and Trust"]
    CON["Connections"]
    DP["Data and Privacy"]
    SET["Settings"]
  end
  GR --> HOME
  HOME --> AL
  HOME --> AS
  DET --> CG
  AL --> DET
  DET --> HT
  HT --> UP
  SET --> CON
  SET --> DP
  CON --> CB
  CON --> AS
    

Page-level library

One page per cluster, plus global chrome, system pages, and SEO. Each is the source of truth for its surface, with real copy, states, and mockups. Both skeleton flags are resolved (see the top of this page).

Index and rollups: docs/sitemap.md. Reusable sections GC3 to GC7 are specified inside the cluster page that owns each (see the library pages).