From 9078a9c0fa12f4ef764278388913152e87ed739e Mon Sep 17 00:00:00 2001 From: "Alexandro T. Netto" Date: Sat, 17 Oct 2026 15:19:46 -0300 Subject: [PATCH] Render REPORT.html as a UX study Screens with anatomy legend and gallery, component cards with state pills, user flows as step strips with screenshots, rules as Given/When/Then cards, light and dark themes, images embedded once. Release 0.4.0. --- .claude-plugin/marketplace.json | 2 +- CHANGELOG.md | 9 + README.md | 2 +- examples/clickup/REPORT.html | 1535 ++++++++--------- examples/pipedrive/REPORT.html | 1076 ++++++------ package-lock.json | 4 +- package.json | 2 +- .../references/knowledge-base.md | 2 +- .../scripts/build-report.mjs | 831 +++++++-- tests/kb-scripts.test.mjs | 47 +- 10 files changed, 1917 insertions(+), 1593 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 13c12a2..fa20892 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -15,7 +15,7 @@ "skills": [ "./skills/reverse-engineering-saas" ], - "version": "0.3.1" + "version": "0.4.0" } ] } diff --git a/CHANGELOG.md b/CHANGELOG.md index 5e0d41d..62b47e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## 0.4.0 (2026-10-17) + +- `REPORT.html` redesigned as a UX study a person can read and navigate: IBM Plex type, a light and a dark theme with a toggle, a one-line answer with the key findings, stat tiles, section chips, and screenshots in framed figures that enlarge on click. +- Screens: anatomy screenshot beside a numbered legend linked to the components, a gallery of the screen's evidence, the states seen and the states not reached. +- Components: one card per component with a screenshot, variants and states as pills (solid when seen, dashed when not), and behavior notes. +- User flows: a strip of numbered step cards with arrows, a screenshot per step when the step cites one, the user action and the product's response; branches and untested paths below. +- Rules as Given/When/Then cards grouped by file; color swatches in the design system; an evidence gallery. +- Each image is embedded once and reused, so a screenshot cited by a screen, a component and a flow step adds no size. The page still builds when screenshots, screens or flows are missing. + ## 0.3.1 (2026-10-16) - `REPORT.html` redesigned for reading: a header with the product and study status, a notice that the page is for people and that AI agents should read `BUILD.md` (also as a comment at the top of the source), numbered sections in reading order (overview, product, screens, flows, rules, data, API, design, build plan, then what to prepare before launch), a coverage bar, rules and barriers as cards, IDs as badges. diff --git a/README.md b/README.md index 0cd3ff3..69f9363 100644 --- a/README.md +++ b/README.md @@ -265,7 +265,7 @@ That depends on the product's terms and your jurisdiction. RES records the relev ## Status -Version 0.3.1. The method was tested with scenario runs on subagents, before and after each change to the skill, and the scripts with automated tests on Node.js 22 and 24. Two end-to-end studies on real products (ClickUp at L2, Pipedrive at L3) are in [examples/](examples/). Version 0.3.0 fixes the gaps the Pipedrive study found; the ClickUp study's are tracked in [an issue](https://github.com/alextnetto/res/issues/5). Reports from real runs are welcome: open a [study report](https://github.com/alextnetto/res/issues/new?template=study_report.yml). +Version 0.4.0. The method was tested with scenario runs on subagents, before and after each change to the skill, and the scripts with automated tests on Node.js 22 and 24. Two end-to-end studies on real products (ClickUp at L2, Pipedrive at L3) are in [examples/](examples/). Version 0.3.0 fixes the gaps the Pipedrive study found; the ClickUp study's are tracked in [an issue](https://github.com/alextnetto/res/issues/5). Reports from real runs are welcome: open a [study report](https://github.com/alextnetto/res/issues/new?template=study_report.yml). ## Responsible use diff --git a/examples/clickup/REPORT.html b/examples/clickup/REPORT.html index 7d41d60..1fa06dc 100644 --- a/examples/clickup/REPORT.html +++ b/examples/clickup/REPORT.html @@ -6,810 +6,810 @@ ClickUp: reverse engineering report + + + + + -
-

Reverse engineering report · RES

+
+
Reverse engineering study · Updated 2026-10-16 · Environment L2 · Phase 7 Close (study ended)
+
+

RES · Reverse Engineering SaaS

ClickUp

-

How ClickUp works, how to rebuild it, and what to prepare before launch.

-
Updated 2026-10-16Environment L2Phase 7 Close (study ended)
-
-
- +

Document ClickUp's board view, task detail view and custom fields well enough that a team that never used ClickUp can rebuild them, and say what would block such a clone from launching

+ + +

ClickUp, documented from the outside: 4 screens, 19 components and 55 business rules, each tied to evidence.

  1. Covered. board view (F-001 to F-007), task view (F-009 to F-015) and custom fields (F-016 to F-022): 55 rules, 19 components, 5 screens, 14 entities, 14 production barriers. 22 field types (every non-AI type except Button and Rollup) were created, filled where possible and shown on cards; a field with a value was deleted and restored.
  2. Not covered. drag and drop (not automatable here), WIP limits and required fields (Business plan), task-type fields (Business Plus), AI fields (credits), Files, Button and Rollup fields, anything that needs a second person.
  3. Decide. whether the ClickUp terms allow building a clone from this study (Q-005), and whether to open an L1 trial account for the Business-plan features.
+
27
features
4
screens
19
components
55
business rules
14
entities
14
launch items
139
evidence files
-
-

Reading this as a person

This page is the readable report of the study. Start with the overview, then read in order: what the product does, how it looks and behaves, how to build it, and what to prepare before launch.

-

If you are an AI agent

Do not build from this page: it is generated for people. Open BUILD.md in this folder and follow its read order. The Markdown files next to it are the source of truth.

-
-

01

Overview

What was studied, how far the study went, and what needs your decision.

  • Covered: board view (F-001 to F-007), task view (F-009 to F-015) and custom fields (F-016 to F-022): 55 rules, 19 components, 5 screens, 14 entities, 14 production barriers. 22 field types (every non-AI type except Button and Rollup) were created, filled where possible and shown on cards; a field with a value was deleted and restored.
  • Not covered: drag and drop (not automatable here), WIP limits and required fields (Business plan), task-type fields (Business Plus), AI fields (credits), Files, Button and Rollup fields, anything that needs a second person.
  • Decide: whether the ClickUp terms allow building a clone from this study (Q-005), and whether to open an L1 trial account for the Business-plan features.
27features
4screens
19components
55business rules
14entities
14launch items
139evidence files

How far the study went: 55% done

116 done56 partial26 blocked14 todo

Needs your decision

  • Terms: ClickUp Terms 1.5, 3.9 and 4.13 and Developer Terms 3 restrict reverse engineering and competitive use (00-charter.md, BR-011). Decide with counsel whether a clone may rely on this study (Q-005).
  • A dedicated trial account in a separate browser profile (L1) for tests that need a second person (mentions, assignments, permissions, guests) or a Business plan (required fields, WIP limits, pinned fields, Tag Manager).
  • The test workspace is kept by instruction (L-001). Delete it when it is no longer useful: Settings > Workspace > Delete workspace.

Blocked

  • F-005 Drag and drop: synthetic drag does not move cards and freezes the page script (EV-046).
  • F-008 WIP limits and F-019 Required fields: Business plan.
  • F-021 task-type fields: Business Plus.
  • F-023 AI fields: AI credits.
-

02

What the product does

Every feature found, its plan and priority, the screens it lives on, and how deeply each one was studied.

Priority: P1 named by the user, P2 core loop, P3 data model completeness, P4 collaboration, P5 admin and settings. Plan names: Free Forever (the test workspace), Unlimited, Business, Business Plus, Enterprise [doc SRC-035][doc SRC-037].

-
IDAreaFeaturePlanPriorityScreensBarriersStatusSource
F-001BoardColumns by group: one column per status, counts, empty columns, add group (new status), collapseAllP1S-001done[obs EV-002][doc SRC-012]
F-002BoardCard: anatomy, inline field edits (assignee, dates, priority, tags), hover toolbar, More menuAllP1S-001done[obs EV-013][doc SRC-009]
F-003BoardCreate a task inside a columnAllP1S-001done[obs EV-029]
F-004BoardCustomize view and view drafts: card size, cover, stack and empty fields, fields, group, subgroup, filter, sort, Save viewAll (private, protected, default views: Business)P1S-001partial[obs EV-019][doc SRC-013][doc SRC-014]
F-005BoardDrag and drop cards between columns and within a columnAllP1S-001blocked[doc SRC-012]
F-006BoardBulk selection and bulk actionsAllP2S-001partial[obs EV-028]
F-007BoardMany items: column paging and virtual scrollAllP2S-001done[obs EV-046]
F-008BoardWork in progress limits per columnBusinessP2S-001blocked[doc SRC-011]
F-009Task viewLayout and header: breadcrumb, status, assignees, dates, priority, tags, layout modesAllP1S-002done[doc SRC-016][doc SRC-017]
F-010Task viewDescriptionAllP1S-002partial[doc SRC-017]
F-011Task viewSubtasksAllP1S-002partial[doc SRC-017]
F-012Task viewChecklistsAllP1S-002done[doc SRC-017]
F-013Task viewRelationships and dependenciesAllP1S-002partial[doc SRC-021][doc SRC-022]
F-014Task viewActivity and commentsAllP1S-002partial[doc SRC-017]
F-015Task viewFields section (custom fields inside the task)AllP1S-002done[doc SRC-007]
F-016Custom fieldsCreate a field of each type, with its optionsAll (60 value uses on Free)P1S-002, S-003partial[doc SRC-002][api SRC-001]
F-017Custom fieldsFill values of each typeAll (60 uses on Free)P1S-001, S-002partial[doc SRC-005]
F-018Custom fieldsHow each type renders on board cardsAllP1S-001done[doc SRC-007]
F-019Custom fieldsRequired fieldsBusinessP1S-002, S-003blocked[doc SRC-003]
F-020Custom fieldsDelete a field that has values; trash and restoreAllP1S-002, S-005done[doc SRC-004]
F-021Custom fieldsScope (workspace, space, folder, list, task type) and the Custom Field ManagerAll (task-type fields: Business Plus)P1S-003partial[doc SRC-006][doc SRC-008]
F-022Custom fieldsFree Forever limit of 60 value usesFreeP1S-002partial[doc SRC-005]
F-023Custom fieldsAI fields (summary, categorize, autofill)AI creditsP3S-003BR-014blocked[doc SRC-044]
F-024StatusesStatus groups, list or space scopeAllP2S-001partial[obs EV-037][doc SRC-018]
F-025TagsSpace-level tags created from a cardAllP2S-001partial[obs EV-040]
F-026RealtimeChanges appear in other open tabs without reloadAllP2S-001BR-013done[obs EV-032]
F-027IntegrationsCalendar, email, chat, CRM and storage integrations (barrier scan only)VariesP5BR-004, BR-005, BR-006, BR-007n/a[obs EV-001][doc SRC-049]
-

Screen catalog

IDScreenURL patternEntry pointsFeaturesFile
S-001Board view of a list/:team/v/b/li/:list (also /:team/v/li/:list/:view)Views bar > Board; sidebar list > Board tabF-001 to F-008, F-016 to F-018, F-024 to F-026screens/S-001-board.md
S-002Task view/t/:task and /t/:team/:task (opens as modal, full screen or sidebar)Click a card title; card More > New tabF-009 to F-015, F-017screens/S-002-task-view.md
S-003Custom Field Managermodal over /:team/settings/... or any view (no own route seen)Workspace menu > Custom Fields; Settings > Custom Field Manager; Fields panel gearF-016, F-019 to F-021screens/S-003-custom-field-manager.md
S-005Trash/:team/settings/trashSettings > TrashF-020screens/S-005-trash.md
S-004List view of a list/:team/v/l/li/:listViews bar > List(used only to create fixtures; out of scope)
-

Coverage by feature

Values: todo, partial, done, blocked, n/a. The work queue is this table, top to bottom.

-
FeatureAnatomyStatesInteractionsRulesDataNetworkKeyboard and a11yPersistenceDesignNotes
F-001 Board columnsdonedonedonedonedonedonepartialdonedoneS-001, C-002, R-001, R-002, R-009
F-002 Board carddonedonedonedonedonedonedonedonedoneC-001, C-004, C-005, C-009, C-010; R-003 to R-007, R-017
F-003 Create in columndonedonedonedonepartialblockedpartialdonedoneC-007, R-010; create request not captured (recorder off)
F-004 Customize view and draftsdonedonepartialdonedonedonetododonedoneC-003, R-008, R-012 to R-015; Save view, Autosave, Private, Protect, Default not clicked
F-005 Drag and droppartialblockedblockedpartialn/ablockedpartialblockedtodoblocked: drag not automatable (EV-046); R-019 from docs; Q-003
F-006 Bulk selectiondonepartialpartialtodon/atodotodon/adoneC-006; no bulk action run
F-007 Many itemsn/adonedonedonen/adonen/an/an/aR-016
F-008 WIP limitsblockedblockedblockedpartialn/ablockedblockedblockedblockedblocked: plan (Business) [doc SRC-011]
F-009 Task view header and layoutdonedonedonedonedonedonepartialdonepartialS-002, C-011, R-020 to R-024, R-027, R-032; keyboard walk not done
F-010 DescriptiondonepartialpartialdonedoneblockedtododonepartialC-012, R-025; saved through the collaborative editor socket (not capturable)
F-011 SubtasksdonepartialpartialdonedonedonetododonepartialC-013, R-028
F-012 ChecklistsdonedonepartialdonedonedonepartialdonepartialC-014, R-030, R-031
F-013 Relationships and dependenciesdonepartialpartialdonedonedonetododonepartialC-015, R-029; plain links and custom relationships not tested
F-014 Activity and commentsdonepartialpartialdonedonedonetododonepartialC-016, R-026; mentions and threads need a second person (L1)
F-015 Fields section in taskdonedonedonedonedonedonepartialdonepartialC-017, R-043, R-044; keyboard entry not walked
F-016 Create custom fieldsdonepartialdonedonedonedonetododonepartialC-018, R-033, R-034, R-040; 22 of the UI types created; Button (needs an automation), Rollup and AI types not created
F-017 Fill custom field valuesdonepartialdonedonedonedonetododonedoneC-019, R-035 to R-038, R-044 to R-047; Files and Relationship values not set; invalid input not tried
F-018 Custom fields on cardsdonedonedonedonedonedonen/adonedoneC-019, R-048 to R-050
F-019 Required fieldspartialblockedblockedpartialpartialblockedblockedblockedpartialblocked: plan (Business) [doc SRC-003]; R-041 observed on Free, R-042 from docs; Q-010
F-020 Delete field with valuesdonedonedonedonedonepartialtododonedoneS-005, R-051 to R-054; delete method inferred from the preflight; restore request not captured
F-021 Field scope and managerdonepartialpartialpartialdonepartialtododonepartialS-003, R-055; only list locations tried; task-type fields need Business Plus
F-022 Free plan 60 usesn/apartialn/apartialdonedonen/adonen/aR-037; limit not reached (18 of 60); Q-008, Q-009
F-023 AI fieldspartialblockedblockedblockedpartialblockedblockedblockedblockedblocked: AI credits; presets seen in the type menu (EV-095, EV-096); BR-014
F-024 Statusespartialpartialpartialpartialpartialtodon/apartialpartialR-011
F-025 Tagspartialpartialdonedonedonedonen/adonepartialR-006
F-026 Realtimen/an/adonedonen/ablockedn/an/an/aR-018; WebSocket not capturable
F-027 Integrationsn/an/an/an/an/an/an/an/an/abarrier scan only (clone/barriers.md)
-

03

Screens

Each screen: its layout, states, interactions, keyboard behavior and text. Open one to read it.

S-001 Board view of a list

Features: F-001 to F-008, F-016 to F-018, F-024 to F-026 · URL: /:team/v/b/li/:list · Status: reviewed

-

Purpose

-

Shows the tasks of one list as columns. Each column is one value of the grouping field (status by default) and holds one card per task. The user reads progress at a glance, edits task fields on the card, creates tasks inside a column and opens a task in full.

-

Entry points

+

01Overview

What needs your decision, how far the study went, and what comes next.

i

If you are an AI agent

Do not build from this page: it is generated for people. Open BUILD.md in this folder and follow its read order. The Markdown files next to it are the source of truth.

!
Needs your decision
  • Terms: ClickUp Terms 1.5, 3.9 and 4.13 and Developer Terms 3 restrict reverse engineering and competitive use (00-charter.md, BR-011). Decide with counsel whether a clone may rely on this study (Q-005).
  • A dedicated trial account in a separate browser profile (L1) for tests that need a second person (mentions, assignments, permissions, guests) or a Business plan (required fields, WIP limits, pinned fields, Tag Manager).
  • The test workspace is kept by instruction (L-001). Delete it when it is no longer useful: Settings > Workspace > Delete workspace.
×
Blocked
  • F-005 Drag and drop: synthetic drag does not move cards and freezes the page script (EV-046).
  • F-008 WIP limits and F-019 Required fields: Business plan.
  • F-021 task-type fields: Business Plus.
  • F-023 AI fields: AI credits.

How far the study went: 55% of checks done

116 done56 partial26 blocked14 todo

Next actions

  1. F-005 drag and drop: a person drags cards while the agent records, or a Playwright session with real mouse events (Q-003).
  2. F-019 required fields and F-021 task-type fields: Business trial in an L1 account; probe where creation is blocked and the message (Q-010).
  3. Validate the barrier weights and costs with 10 to 20 Brazilian SMB buyers and two quotes per provider (Q-006, Q-007), then fix the PRD build order.
+

02What the product does

Every feature found, its plan and priority, the screens it lives on, and how deeply each one was studied.

Priority: P1 named by the user, P2 core loop, P3 data model completeness, P4 collaboration, P5 admin and settings. Plan names: Free Forever (the test workspace), Unlimited, Business, Business Plus, Enterprise [doc SRC-035][doc SRC-037].

+
IDAreaFeaturePlanPriorityScreensBarriersStatusSource
F-001BoardColumns by group: one column per status, counts, empty columns, add group (new status), collapseAllP1S-001done[obs EV-002][doc SRC-012]
F-002BoardCard: anatomy, inline field edits (assignee, dates, priority, tags), hover toolbar, More menuAllP1S-001done[obs EV-013][doc SRC-009]
F-003BoardCreate a task inside a columnAllP1S-001done[obs EV-029]
F-004BoardCustomize view and view drafts: card size, cover, stack and empty fields, fields, group, subgroup, filter, sort, Save viewAll (private, protected, default views: Business)P1S-001partial[obs EV-019][doc SRC-013][doc SRC-014]
F-005BoardDrag and drop cards between columns and within a columnAllP1S-001blocked[doc SRC-012]
F-006BoardBulk selection and bulk actionsAllP2S-001partial[obs EV-028]
F-007BoardMany items: column paging and virtual scrollAllP2S-001done[obs EV-046]
F-008BoardWork in progress limits per columnBusinessP2S-001blocked[doc SRC-011]
F-009Task viewLayout and header: breadcrumb, status, assignees, dates, priority, tags, layout modesAllP1S-002done[doc SRC-016][doc SRC-017]
F-010Task viewDescriptionAllP1S-002partial[doc SRC-017]
F-011Task viewSubtasksAllP1S-002partial[doc SRC-017]
F-012Task viewChecklistsAllP1S-002done[doc SRC-017]
F-013Task viewRelationships and dependenciesAllP1S-002partial[doc SRC-021][doc SRC-022]
F-014Task viewActivity and commentsAllP1S-002partial[doc SRC-017]
F-015Task viewFields section (custom fields inside the task)AllP1S-002done[doc SRC-007]
F-016Custom fieldsCreate a field of each type, with its optionsAll (60 value uses on Free)P1S-002, S-003partial[doc SRC-002][api SRC-001]
F-017Custom fieldsFill values of each typeAll (60 uses on Free)P1S-001, S-002partial[doc SRC-005]
F-018Custom fieldsHow each type renders on board cardsAllP1S-001done[doc SRC-007]
F-019Custom fieldsRequired fieldsBusinessP1S-002, S-003blocked[doc SRC-003]
F-020Custom fieldsDelete a field that has values; trash and restoreAllP1S-002, S-005done[doc SRC-004]
F-021Custom fieldsScope (workspace, space, folder, list, task type) and the Custom Field ManagerAll (task-type fields: Business Plus)P1S-003partial[doc SRC-006][doc SRC-008]
F-022Custom fieldsFree Forever limit of 60 value usesFreeP1S-002partial[doc SRC-005]
F-023Custom fieldsAI fields (summary, categorize, autofill)AI creditsP3S-003BR-014blocked[doc SRC-044]
F-024StatusesStatus groups, list or space scopeAllP2S-001partial[obs EV-037][doc SRC-018]
F-025TagsSpace-level tags created from a cardAllP2S-001partial[obs EV-040]
F-026RealtimeChanges appear in other open tabs without reloadAllP2S-001BR-013done[obs EV-032]
F-027IntegrationsCalendar, email, chat, CRM and storage integrations (barrier scan only)VariesP5BR-004, BR-005, BR-006, BR-007n/a[obs EV-001][doc SRC-049]
+

Screen catalog

IDScreenURL patternEntry pointsFeaturesFile
S-001Board view of a list/:team/v/b/li/:list (also /:team/v/li/:list/:view)Views bar > Board; sidebar list > Board tabF-001 to F-008, F-016 to F-018, F-024 to F-026screens/S-001-board.md
S-002Task view/t/:task and /t/:team/:task (opens as modal, full screen or sidebar)Click a card title; card More > New tabF-009 to F-015, F-017screens/S-002-task-view.md
S-003Custom Field Managermodal over /:team/settings/... or any view (no own route seen)Workspace menu > Custom Fields; Settings > Custom Field Manager; Fields panel gearF-016, F-019 to F-021screens/S-003-custom-field-manager.md
S-005Trash/:team/settings/trashSettings > TrashF-020screens/S-005-trash.md
S-004List view of a list/:team/v/l/li/:listViews bar > List(used only to create fixtures; out of scope)
+
Coverage by feature which parts of each feature were checked

Values: todo, partial, done, blocked, n/a. The work queue is this table, top to bottom.

+
FeatureAnatomyStatesInteractionsRulesDataNetworkKeyboard and a11yPersistenceDesignNotes
F-001 Board columnsdonedonedonedonedonedonepartialdonedoneS-001, C-002, R-001, R-002, R-009
F-002 Board carddonedonedonedonedonedonedonedonedoneC-001, C-004, C-005, C-009, C-010; R-003 to R-007, R-017
F-003 Create in columndonedonedonedonepartialblockedpartialdonedoneC-007, R-010; create request not captured (recorder off)
F-004 Customize view and draftsdonedonepartialdonedonedonetododonedoneC-003, R-008, R-012 to R-015; Save view, Autosave, Private, Protect, Default not clicked
F-005 Drag and droppartialblockedblockedpartialn/ablockedpartialblockedtodoblocked: drag not automatable (EV-046); R-019 from docs; Q-003
F-006 Bulk selectiondonepartialpartialtodon/atodotodon/adoneC-006; no bulk action run
F-007 Many itemsn/adonedonedonen/adonen/an/an/aR-016
F-008 WIP limitsblockedblockedblockedpartialn/ablockedblockedblockedblockedblocked: plan (Business) [doc SRC-011]
F-009 Task view header and layoutdonedonedonedonedonedonepartialdonepartialS-002, C-011, R-020 to R-024, R-027, R-032; keyboard walk not done
F-010 DescriptiondonepartialpartialdonedoneblockedtododonepartialC-012, R-025; saved through the collaborative editor socket (not capturable)
F-011 SubtasksdonepartialpartialdonedonedonetododonepartialC-013, R-028
F-012 ChecklistsdonedonepartialdonedonedonepartialdonepartialC-014, R-030, R-031
F-013 Relationships and dependenciesdonepartialpartialdonedonedonetododonepartialC-015, R-029; plain links and custom relationships not tested
F-014 Activity and commentsdonepartialpartialdonedonedonetododonepartialC-016, R-026; mentions and threads need a second person (L1)
F-015 Fields section in taskdonedonedonedonedonedonepartialdonepartialC-017, R-043, R-044; keyboard entry not walked
F-016 Create custom fieldsdonepartialdonedonedonedonetododonepartialC-018, R-033, R-034, R-040; 22 of the UI types created; Button (needs an automation), Rollup and AI types not created
F-017 Fill custom field valuesdonepartialdonedonedonedonetododonedoneC-019, R-035 to R-038, R-044 to R-047; Files and Relationship values not set; invalid input not tried
F-018 Custom fields on cardsdonedonedonedonedonedonen/adonedoneC-019, R-048 to R-050
F-019 Required fieldspartialblockedblockedpartialpartialblockedblockedblockedpartialblocked: plan (Business) [doc SRC-003]; R-041 observed on Free, R-042 from docs; Q-010
F-020 Delete field with valuesdonedonedonedonedonepartialtododonedoneS-005, R-051 to R-054; delete method inferred from the preflight; restore request not captured
F-021 Field scope and managerdonepartialpartialpartialdonepartialtododonepartialS-003, R-055; only list locations tried; task-type fields need Business Plus
F-022 Free plan 60 usesn/apartialn/apartialdonedonen/adonen/aR-037; limit not reached (18 of 60); Q-008, Q-009
F-023 AI fieldspartialblockedblockedblockedpartialblockedblockedblockedblockedblocked: AI credits; presets seen in the type menu (EV-095, EV-096); BR-014
F-024 Statusespartialpartialpartialpartialpartialtodon/apartialpartialR-011
F-025 Tagspartialpartialdonedonedonedonen/adonepartialR-006
F-026 Realtimen/an/adonedonen/ablockedn/an/an/aR-018; WebSocket not capturable
F-027 Integrationsn/an/an/an/an/an/an/an/an/abarrier scan only (clone/barriers.md)
+

03Screens

Each screen with its annotated anatomy, the screenshots taken of it, and the states it can be in. Click a picture to enlarge it.

S-001

Board view of a list

FeaturesF-001 to F-008, F-016 to F-018, F-024 to F-026URL/:team/v/b/li/:listStatusreviewed

Shows the tasks of one list as columns. Each column is one value of the grouping field (status by default) and holds one card per task. The user reads progress at a glance, edits task fields on the card, creates tasks inside a column and opens a task in full.

EV-012 After Mark complete on a card: card moved to COMPLETE, counts 53/1, toast Status changed with Undo; v-03 sits above v-02

Anatomy

  1. 1
    Location headerBreadcrumb (Space / List with a menu), favorite star; right side: call, Agents, automation, AI, Share
  2. 2
    Views bar"Add Channel", view tabs (List, Board), "+ View"
  3. 3
    View toolbar, left C-003"Group: Status" button, "Subtasks" button; "Save view" appears here when the view has unsaved changes
  4. 4
    View toolbar, right C-003Sort, Filter, Closed (disabled while grouped by status), Assignee filter, Me-mode avatar, search, Customize, Add Task split button
  5. 5
    Column strip C-002One column per group value, then "+ Add group" at the end; horizontal scroll when wider than the screen
  6. 6
    Column header C-002Status pill in the status color, task count; on hover: collapse, More (Group options), + (add task at top)
  7. 7
    Card list C-001Virtualized list of cards, then "+ Add Task" in the column footer
  8. 8
    Bulk action bar C-006Bottom of the screen, only while tasks are selected
  9. 9
    Toasts C-008Bottom left: Task created, Status changed with Undo, prompts

More from this screen 28 screenshots

EV-002 Board view of an empty list: three status columns and Add group
EV-017 Collapsed column as a vertical strip; Save view button appears in the toolbar (view draft)
EV-026 Board grouped by Priority (draft): Urgent, High, Normal, Low, No priority columns; cards show a status chip; Save view visible
EV-038 New status column [RE] REVIEW inserted before COMPLETE, name shown uppercase
EV-015 Column menu (Group options) on a column with tasks: Collapse, Archive all, Automate status, Select all, Rename, Edit statuses
EV-016 Column menu on an empty column: no Archive all and no Select all
Show 22 more
EV-028 Bulk action bar after Select all in a column: count, clear, Status, Assignees, Dates, Custom Fields (disabled with no fields), Tags, Move/Add, Convert to Subtask, Copy, duplicate, archive, delete, More
EV-030 After creating in IN PROGRESS: card at the top of the column with that status, form reopened below, toast Task created with Pin to bottom, Copy URL, View task
EV-041 Assignee picker on a card: Search or enter email, Me (avatar masked), Assign with AI
EV-010 Card date chips: overdue in red (3 days ago), today in yellow, range Today - Mon; priority chip High
EV-006 Card hover toolbar and the priority picker opened from the card flag icon
EV-040 Tag picker on a card with a new name typed: Select an option, Create <name>, settings gear
EV-121 Card of [RE] all fields with every value: dropdown pill, text, textarea first line with ellipsis, number, money, date, checkbox, email, signature, voting, tasks chip with +, people (masked), rating, progress bars, labels, formula, phone, website, files dash, location truncated
EV-018 Board loading state: column header and card skeletons while the view re-queries
EV-120 Board with all 22 custom fields shown (unsaved view draft): every field takes a row with its type icon; empty money and formula show R$ 0, rating three grey stars, voting 0, relationship fields an Add task button
EV-027 Group Priority with subgroup Status (draft): priority columns and collapsible status swimlanes with counts
EV-042 After assigning yourself: a prompt to add the task to your priorities with Don't ask again and Add to priorities (name masked)
EV-029 Inline create form inside a column: Task Name, Save (disabled while empty), Add assignee, Add dates, Add priority, Add tag
EV-037 Dialog after Add group: Where should this new status apply? List only (default) or Entire Space
EV-020 Card size Small (draft): narrower columns, fields wrap; Save view visible; card options list (cover, stack fields, show empty fields, collapse empty columns)
EV-023 Stack fields on and Show empty fields off (draft): empty cards show only the title; filled fields stack one per row
EV-123 Customize > Fields: Shown section grows as fields are toggled on; Properties; Custom Fields; Custom Fields in Workspace (7, not created by the study); Save view appears
EV-124 After a reload the board is back to its saved settings: no custom field rows, no Save view, search cleared
EV-122 Clicking the dropdown pill on a card opens the same option picker inline; hovering the icon shows the field name and Custom Field
EV-033 Keyboard focus on a card field toggle (assignee): white rounded outline
EV-031 Second tab 3 s after setting priority Low in the first tab: not updated yet
EV-032 Second tab about 8 s later, no reload: card shows Low
EV-039 Filters popover: Ask AI to build filters, Saved filters, Select filter list (Status, Tags, Due date, Priority, Assignee, Archived, Assigned comment, Created by, Date closed, Date created...)

States

EmptyThree columns (to do, in progress, complete) with only "+ Add Task", then "+ Add group"
LoadingColumn header skeletons and card skeletons; field values on cards can fill in after the titles
TypicalCards with chips for filled fields and empty placeholders for the rest
Custom fields shownA row per field on every card; empty values "-" or a type placeholder
Many itemsColumn scrolls on its own; only about 11 cards exist in the DOM; more load while scrolling
Long textTitle wraps to two lines and ends with an ellipsis; card height grows
Collapsed columnVertical strip with the status name rotated and the count
Grouped by another fieldColumns Urgent, High, Normal, Low, No priority; cards show a status chip; closed tasks hidden
SwimlanesRows per second field, each collapsible with its own count and +
Error
No permission
Plan-gatedNot available on Free Forever
Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Views bar of a list: the "Board" tab, created by default with every new list next to "List" [obs EV-002].
  • URL /:team/v/b/li/:list opens the list's default board view; saved views also open at /:team/v/li/:list/:view [obs EV-011].
  • Sidebar: Space > list > the last view opened.
-

Anatomy

-

Board with fixtures

-
#RegionContentsComponentEvidence
1Location headerBreadcrumb (Space / List with a menu), favorite star; right side: call, Agents, automation, AI, Share[obs EV-012]
2Views bar"Add Channel", view tabs (List, Board), "+ View"[obs EV-002]
3View toolbar, left"Group: Status" button, "Subtasks" button; "Save view" appears here when the view has unsaved changesC-003[obs EV-017]
4View toolbar, rightSort, Filter, Closed (disabled while grouped by status), Assignee filter, Me-mode avatar, search, Customize, Add Task split buttonC-003[obs EV-012][obs EV-026]
5Column stripOne column per group value, then "+ Add group" at the end; horizontal scroll when wider than the screenC-002[obs EV-012][obs EV-038]
6Column headerStatus pill in the status color, task count; on hover: collapse, More (Group options), + (add task at top)C-002[obs EV-015][obs EV-016]
7Card listVirtualized list of cards, then "+ Add Task" in the column footerC-001[obs EV-046]
8Bulk action barBottom of the screen, only while tasks are selectedC-006[obs EV-028]
9ToastsBottom left: Task created, Status changed with Undo, promptsC-008[obs EV-012][obs EV-030]
-

Board DOM: Angular 22 custom elements cu3-board-view > cu3-board > cu3-board-header (column headers) and cu3-board-group (columns, with cdk-virtual-scroll-viewport) > cu3-board-task (cards) [obs EV-011].

-

Data shown

-
ElementEntity.fieldEvidence
ColumnStatus.status, Status.color, Status.type (one column per status of the list)[net EV-014][obs EV-038]
Column countnumber of tasks in the group, closed included in the closed column[obs EV-046]
Card titleTask.name[obs EV-012]
Assignee chipTask.assignees (avatar)[obs EV-041]
Date chipTask.start_date, Task.due_date (relative text, colored by urgency)[obs EV-010]
Priority chipTask.priority (flag color and label)[obs EV-006]
TagsTask.tags (name pills)[obs EV-040]
Status chipTask.status, only when the board is not grouped by status[obs EV-026]
Custom field rowsCustomFieldValue per shown field, one row each with the type icon (C-019)[obs EV-121][net EV-112]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyNew listThree columns (to do, in progress, complete) with only "+ Add Task", then "+ Add group"[obs EV-002]
LoadingOpen the board, or change grouping or card settingsColumn header skeletons and card skeletons; field values on cards can fill in after the titles[obs EV-018]
TypicalFixturesCards with chips for filled fields and empty placeholders for the rest[obs EV-012]
Custom fields shownCustomize > Fields, all 22 onA row per field on every card; empty values "-" or a type placeholder[obs EV-120][obs EV-121]
Many items53 tasks in one columnColumn scrolls on its own; only about 11 cards exist in the DOM; more load while scrolling[obs EV-046][net EV-014]
Long text200+ character title with emoji and accentsTitle wraps to two lines and ends with an ellipsis; card height grows[obs EV-012]
Collapsed columnColumn menu > Collapse groupVertical strip with the status name rotated and the count[obs EV-017]
Grouped by another fieldGroup: PriorityColumns Urgent, High, Normal, Low, No priority; cards show a status chip; closed tasks hidden[obs EV-026]
SwimlanesGroup > Add subgroupRows per second field, each collapsible with its own count and +[obs EV-027]
ErrorNot reached
No permissionNot testable with one account (needs L1 and a second user)
Plan-gatedWIP limits (Business)Not available on Free Forever[doc SRC-011]
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Card flag icon > a priorityPriority chip appears at oncePUT /tasks/v1/item?check_dependenciesTask (server)[net EV-007][obs EV-006]
Card calendar icon > date > close pickerDate chip appears; saved only when the picker closesPUT /tasks/v1/item?...check_remap_subtasksTask[net EV-014][obs EV-010]
Card person icon > MeAvatar on the card; prompt to add to personal prioritiesPUT /tasks/v1/task/:id?...field_backlinksTask[net EV-014][obs EV-042]
Card tag icon > type a new name > Enter > closeTag created at Space level and appliedPOST /tasks/v1/tag on closeSpace tag + task[net EV-014][obs EV-040]
Hover toolbar ✓ Mark completeCard moves to the closed column, toast "Status changed" with Undo ⌘ZPUT /tasks/v1/item?...check_resolvedTask[obs EV-012][net EV-014]
Column + or "+ Add Task"Inline create form inside the columnPOST create (not captured)Task[obs EV-029]
Column More > Collapse groupColumn collapses; "Save view" appearsnone until saved; a view re-queryView draft (lost on reload)[obs EV-017][net EV-014]
"+ Add group" > name > ✓Scope dialog, then a new status columnnot capturedList statuses[obs EV-037][obs EV-038]
Column More > Select allCards get a checked box; bulk bar opensnoneBrowser memory[obs EV-028]
Scroll inside a columnMore cards renderPOST /task-v3/experience/:id/tasks/bulknone[net EV-014][obs EV-046]
Card title clickOpens the task (S-002)
Drag a card to another columnChanges the group value (status)Task[doc SRC-012] (not observed: F-005 blocked)
Customize > card size, cover, togglesBoard re-renders; "Save view" appearsview re-queryView draft[obs EV-020][obs EV-023]
Customize > Fields > a custom field toggleThe field gets a row on every card; "Save view" appearsview re-queryView draft (lost on reload)[obs EV-120][obs EV-123][obs EV-124]
Card custom field valueOpens the field editor on the card (same picker as the task view)POST /customFields/v1/task/:id/field/:idTask[obs EV-122][net EV-112]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab orderCard title link, then the hover toolbar buttons (Mark complete, Add subtask, Rename, More), then the four field toggles[obs EV-034]
Arrow keysDown arrow does not move between cards[obs EV-034]
ShortcutsPriority picker items show ⌘1 to ⌘4 and ⌘0; documented global shortcuts in SRC-046 not exercised on the board[obs EV-006][doc SRC-046]
Focus visibleField toggles: white 1px ring plus a 3px dark halo; the title link has no outline[obs EV-033][obs EV-035]
EscapeCloses pickers and menus; closing the date picker saves[net EV-014]
Unlabeled controlsCard open area, field toggles and the Add subtask button have no accessible name[obs EV-011][obs EV-034]
-

Microcopy

-
ElementTextEvidence
Column menu title"Group options"[obs EV-015]
Toast after complete"Status changed" · "Undo ⌘Z"[obs EV-012]
Toast after create"Task created" · "Pin to bottom 3" · "Copy URL 2" · "View task 1"[obs EV-030]
New status dialog"Where should this new status apply?" · "List only" · "Entire Space"[obs EV-037]
Inline form"Task Name..." · "Save ↵" · "Add assignee" · "Add dates" · "Add priority" · "Add tag"[obs EV-029]
Draft indicator"Save view"[obs EV-017]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
ColumnStatus.status, Status.color, Status.type (one column per status of the list)[net EV-014][obs EV-038]
Column countnumber of tasks in the group, closed included in the closed column[obs EV-046]
Card titleTask.name[obs EV-012]
Assignee chipTask.assignees (avatar)[obs EV-041]
Date chipTask.start_date, Task.due_date (relative text, colored by urgency)[obs EV-010]
Priority chipTask.priority (flag color and label)[obs EV-006]
TagsTask.tags (name pills)[obs EV-040]
Status chipTask.status, only when the board is not grouped by status[obs EV-026]
Custom field rowsCustomFieldValue per shown field, one row each with the type icon (C-019)[obs EV-121][net EV-112]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Card flag icon > a priorityPriority chip appears at oncePUT /tasks/v1/item?check_dependenciesTask (server)[net EV-007][obs EV-006]
Card calendar icon > date > close pickerDate chip appears; saved only when the picker closesPUT /tasks/v1/item?...check_remap_subtasksTask[net EV-014][obs EV-010]
Card person icon > MeAvatar on the card; prompt to add to personal prioritiesPUT /tasks/v1/task/:id?...field_backlinksTask[net EV-014][obs EV-042]
Card tag icon > type a new name > Enter > closeTag created at Space level and appliedPOST /tasks/v1/tag on closeSpace tag + task[net EV-014][obs EV-040]
Hover toolbar ✓ Mark completeCard moves to the closed column, toast "Status changed" with Undo ⌘ZPUT /tasks/v1/item?...check_resolvedTask[obs EV-012][net EV-014]
Column + or "+ Add Task"Inline create form inside the columnPOST create (not captured)Task[obs EV-029]
Column More > Collapse groupColumn collapses; "Save view" appearsnone until saved; a view re-queryView draft (lost on reload)[obs EV-017][net EV-014]
"+ Add group" > name > ✓Scope dialog, then a new status columnnot capturedList statuses[obs EV-037][obs EV-038]
Column More > Select allCards get a checked box; bulk bar opensnoneBrowser memory[obs EV-028]
Scroll inside a columnMore cards renderPOST /task-v3/experience/:id/tasks/bulknone[net EV-014][obs EV-046]
Card title clickOpens the task (S-002)
Drag a card to another columnChanges the group value (status)Task[doc SRC-012] (not observed: F-005 blocked)
Customize > card size, cover, togglesBoard re-renders; "Save view" appearsview re-queryView draft[obs EV-020][obs EV-023]
Customize > Fields > a custom field toggleThe field gets a row on every card; "Save view" appearsview re-queryView draft (lost on reload)[obs EV-120][obs EV-123][obs EV-124]
Card custom field valueOpens the field editor on the card (same picker as the task view)POST /customFields/v1/task/:id/field/:idTask[obs EV-122][net EV-112]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab orderCard title link, then the hover toolbar buttons (Mark complete, Add subtask, Rename, More), then the four field toggles[obs EV-034]
Arrow keysDown arrow does not move between cards[obs EV-034]
ShortcutsPriority picker items show ⌘1 to ⌘4 and ⌘0; documented global shortcuts in SRC-046 not exercised on the board[obs EV-006][doc SRC-046]
Focus visibleField toggles: white 1px ring plus a 3px dark halo; the title link has no outline[obs EV-033][obs EV-035]
EscapeCloses pickers and menus; closing the date picker saves[net EV-014]
Unlabeled controlsCard open area, field toggles and the Add subtask button have no accessible name[obs EV-011][obs EV-034]
+

Microcopy

+
ElementTextEvidence
Column menu title"Group options"[obs EV-015]
Toast after complete"Status changed" · "Undo ⌘Z"[obs EV-012]
Toast after create"Task created" · "Pin to bottom 3" · "Copy URL 2" · "View task 1"[obs EV-030]
New status dialog"Where should this new status apply?" · "List only" · "Entire Space"[obs EV-037]
Inline form"Task Name..." · "Save ↵" · "Add assignee" · "Add dates" · "Add priority" · "Add tag"[obs EV-029]
Draft indicator"Save view"[obs EV-017]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadYes, within about 8 s in a background tab[obs EV-031][obs EV-032]
Loading pattern (skeleton, spinner, optimistic update)Skeletons on load and on view changes; field edits show at once (optimistic)[obs EV-018][obs EV-006]
Delays the user seesCard field values seemed to fill in after the titles; not measurable in a background tabQ-001
-

Responsive

-
WidthChangeEvidence
1710 CSS pxAll observations[obs EV-046]
1024 and 390Not tested: the window belongs to the user and was not resized
-

Not tested

-
  • Drag and drop (F-005): the tool's drag and synthetic events do not move cards. Needs a human or a real mouse driver.
  • Sort options and saved filters: popovers opened only (EV-039); no filter applied.
  • Save view, Autosave, Private, Protect, Set as default: not clicked, to keep the default view clean; Private and Default need Business [doc SRC-014].
  • WIP limits (Business), Me mode, the Subtasks toggle options, card cover with an image.
  • Error and no-permission states.
  • Widths 1024 and 390 px.
-
S-002 Task view

Features: F-009 to F-015, F-017, F-019, F-020 · URL: /t/:team/:task · Status: reviewed

-

Purpose

-

Shows one task in full: its properties, description, custom fields, subtasks, relations, checklists and attachments, with the activity log and comments beside it. Every edit saves in place.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadYes, within about 8 s in a background tab[obs EV-031][obs EV-032]
Loading pattern (skeleton, spinner, optimistic update)Skeletons on load and on view changes; field edits show at once (optimistic)[obs EV-018][obs EV-006]
Delays the user seesCard field values seemed to fill in after the titles; not measurable in a background tabQ-001
+

Responsive

+
WidthChangeEvidence
1710 CSS pxAll observations[obs EV-046]
1024 and 390Not tested: the window belongs to the user and was not resized
+

Not tested

+
  • Drag and drop (F-005): the tool's drag and synthetic events do not move cards. Needs a human or a real mouse driver.
  • Sort options and saved filters: popovers opened only (EV-039); no filter applied.
  • Save view, Autosave, Private, Protect, Set as default: not clicked, to keep the default view clean; Private and Default need Business [doc SRC-014].
  • WIP limits (Business), Me mode, the Subtasks toggle options, card cover with an image.
  • Error and no-permission states.
  • Widths 1024 and 390 px.
+
S-002

Task view

FeaturesF-009 to F-015, F-017, F-019, F-020URL/t/:team/:taskStatusreviewed

Shows one task in full: its properties, description, custom fields, subtasks, relations, checklists and attachments, with the activity log and comments beside it. Every edit saves in place.

EV-051 Task view (Full screen) annotated: 1 header, 2 hero (type, title, AI bar), 3 fields grid, 4 description, 5 sections (fields, subtasks, relations, checklist, attachments), 6 activity sidebar with comment box

Anatomy

  1. 1
    HeaderPrevious and next task, breadcrumb (Space / List), add to another list, move; right: "Created <date>", AI, Share, More, favorite, Switch layout, close
  2. 2
    Hero C-011Task type pill ("Task ▾"), AI and task ID buttons, counts for subtasks, relations or checklist items, the title (wraps, no truncation), an AI prompt bar
  3. 3
    Fields grid C-011Two columns: Status (pill, next-status arrow, complete ✓), Dates (Start → Due), Track time (Start), Assignees, Priority, Tags; dependency rows (Blocked by, Blocking) appear under the grid
  4. 4
    Description C-012Rich text editor; placeholder "Add description, or write with AI"; history and full-screen icons
  5. 5
    Sections C-013, C-014, C-015Add fields, Add subtask, Relate items or add dependencies, Create checklist, Attach file; each becomes a section once used
  6. 5a
    Fields section C-017, C-019One row per custom field of the task's locations, "Hide N empty fields"
  7. 5b
    Related section C-019One tab per Tasks or Relationship field with a table of linked tasks
  8. 6
    Activity sidebar C-016"Activity" with search, follower count bell and filter; history lines with relative times, "Show more"; comments; composer at the bottom; right rail toggles (collapse, comments, activity, apps)

More from this screen 30 screenshots

EV-059 Task view of an overdue task: Dates shows Start -> 3 days ago in red; empty fields read Empty (0.6 scale)
EV-024 Card More menu: Copy link, Copy ID, New tab; Favorite, Rename, Unfollow, Remind me; Move to, Add to, Merge, Duplicate, Convert to, Custom Fields, Templates; Relationships, Task Type; Start timer, Send email to task; Archive, Delete; Sharing & Permissions
EV-076 Task view More menu: card menu items plus Description history and Print
EV-060 216-character title wraps over four lines in the task view without truncation
EV-065 Blocked task after adding a dependency: Blocked by row under the fields (warning icon), relation count in the header, Related/Dependencies tabs with a Blocked by table
EV-055 Description editor: '- ' turned into a bullet list; **bold** typed inline stayed literal; history and full-screen icons
Show 24 more
EV-062 Subtasks section after two creates: 2 open with progress bar, table Name/Assignee/Priority, Add Task row; subtask count in the header; activity lines
EV-071 Checklists section: 3 open with progress bar, named checklist, items with circles, Add item, Add checklist; activity aggregates 'added 3 items'; header checklist count
EV-117 Task view with every field filled; activity log has one line per field change (people line masked)
EV-119 Related section with a tab per relationship field ([RE] cf-tasks 1) and a table Name, Due date, Priority
EV-057 Posted comment in the activity stream (author masked), Just now, reactions, Reply; composer placeholder changes
EV-077 Task type menu: Task (default), Milestone, Form Response, Meeting Note; Recommended Asset, Campaign, Goal, Person, Resource; Create Task Type; Fill with AI
EV-078 After a full reload: description with bullets and the comment persisted; the task opened in Full screen again (0.5 scale)
EV-082 Clicking Required in tasks on Free Forever: tooltip explains the rule, the switch stays off, no message
EV-083 Clicking Pinned on Free Forever opens Upgrade to Business to unlock Pinning Custom Fields (USD price); closed without choosing
EV-054 Status picker in the task view: search, groups Not started (TO DO), Active (IN PROGRESS, [RE] REVIEW), Closed (COMPLETE)
EV-073 Next-status arrow moved TO DO to IN PROGRESS; activity line with both status colors; Status changed toast with Undo; Collapse empty fields link
EV-066 The other task shows Blocking (red icon) and an activity line You marked this task as blocking
EV-067 Create checklist creates a checklist named Checklist at once (name in edit mode), Add item, Add checklist (0.6 scale)
EV-072 After resolving one item: 2 open, the item hides under Show 1 completed; item hover actions
EV-074 Sidebar layout: board stays visible on the left, the task opens as a right panel; layout popover shows Sidebar selected
EV-075 Modal layout: centered overlay over a dimmed page, activity panel inside the modal
EV-080 Create Dropdown form: type switcher, Field name, Dropdown options with color dots, Set default, delete, Add option, AI option generator, AI Autofill, Permissions and settings, Cancel, Create
EV-130 On another task the empty phone field now defaults to Brazil: the country picked earlier was saved to the user profile, not to the field
EV-131 After picking the original country again (PUT /user/v1/user) and a reload, the phone field defaults to it (flag masked: account data); no phone value was saved
EV-126 Delete confirmation: This action will delete this Custom Field from 1 task. Admins are able to restore deleted fields from the Trash.
EV-127 After delete: the dropdown row is gone from the task and a toast says Field deleted successfully (no Undo)
EV-068 Board after task-view edits: description icon on a card, 2 subtasks toggle, dependency warning badge with count
EV-064 Relate items menu: Relate a Task or Doc, This task blocks..., This task is blocked by..., New custom relationship
EV-032 Second tab about 8 s later, no reload: card shows Low

States

EmptyPlaceholders: Start, Due, Empty for priority and tags, "Add description, or write with AI", the five section buttons
LoadingThe board stays mounted underneath; the activity list fills in after the body
TypicalFilled fields, description, comment
Many items
Long textTitle wraps over four lines, no ellipsis
OverdueDue shows "3 days ago" with a red icon
Error
No permission
Plan-gatedRequired stays off; Pinned opens Upgrade to Business
Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Click a card title on the board (C-001); the URL changes to /t/:team/:task and the title bar reads "<task name> | #<task id>" [obs EV-051][net EV-053].
  • Header arrows ↑ ↓ step to the previous or next task in the board's order [obs EV-059].
  • Card More > New tab; a direct link opens the same view [obs EV-024].
-

Anatomy

-

Task view anatomy

-
#RegionContentsComponentEvidence
1HeaderPrevious and next task, breadcrumb (Space / List), add to another list, move; right: "Created <date>", AI, Share, More, favorite, Switch layout, close[obs EV-051][obs EV-076]
2HeroTask type pill ("Task ▾"), AI and task ID buttons, counts for subtasks, relations or checklist items, the title (wraps, no truncation), an AI prompt barC-011[obs EV-051][obs EV-060]
3Fields gridTwo columns: Status (pill, next-status arrow, complete ✓), Dates (Start → Due), Track time (Start), Assignees, Priority, Tags; dependency rows (Blocked by, Blocking) appear under the gridC-011[obs EV-051][obs EV-065]
4DescriptionRich text editor; placeholder "Add description, or write with AI"; history and full-screen iconsC-012[obs EV-055]
5SectionsAdd fields, Add subtask, Relate items or add dependencies, Create checklist, Attach file; each becomes a section once usedC-013, C-014, C-015[obs EV-062][obs EV-065][obs EV-071]
5aFields sectionOne row per custom field of the task's locations, "Hide N empty fields"C-017, C-019[obs EV-117]
5bRelated sectionOne tab per Tasks or Relationship field with a table of linked tasksC-019[obs EV-119]
6Activity sidebar"Activity" with search, follower count bell and filter; history lines with relative times, "Show more"; comments; composer at the bottom; right rail toggles (collapse, comments, activity, apps)C-016[obs EV-057]
-

Component tree (Angular): cu-task-view > cu-task-view-header, cu-task-hero-section, cu-task-fields-container, cu-task-view-content-description (cu-task-editor, Quill), cu-task-view-flat-layout (custom fields, subtasks, relationships, checklists, attachments sections) and cu-task-view-right-sidebar [obs EV-050].

-

Data shown

-
ElementEntity.fieldEvidence
TitleTask.name[net EV-053]
TypeTask.custom_type (null = Task)[net EV-053][obs EV-077]
StatusTask.status {status, color, type, status_group}[net EV-053]
DatesTask.time_mgmt.start_date, due_date (+ _time flags)[net EV-053][obs EV-059]
AssigneesTask.users[type=assigned][net EV-053]
PriorityTask.priority[net EV-053]
TagsTask.tags[net EV-053]
DescriptionTask.content (rich text), text_content[net EV-053][obs EV-078]
SubtasksTask.subtask_ids, subtasks_count[net EV-053][obs EV-062]
DependenciesTask.related_tasks_count {dependsOn, dependedBy}[net EV-053][obs EV-065]
ChecklistsTask.checklists[{name, items[{name, resolved}]}][net EV-069][obs EV-071]
Activityhistory items and comments[net EV-058]
CreatedTask.time_mgmt.date_created ("Created 16 Oct")[obs EV-051]
FieldsCustomFieldValue for each CustomField at the task's locations[obs EV-117][net EV-112]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyA new taskPlaceholders: Start, Due, Empty for priority and tags, "Add description, or write with AI", the five section buttons[obs EV-059]
LoadingOpen a taskThe board stays mounted underneath; the activity list fills in after the body[obs EV-050][obs EV-051]
TypicalFixturesFilled fields, description, comment[obs EV-078]
Many itemsNot reached (2 subtasks, 3 checklist items)
Long text216-character titleTitle wraps over four lines, no ellipsis[obs EV-060]
OverdueDue date in the pastDue shows "3 days ago" with a red icon[obs EV-059]
ErrorNot reached
No permissionNeeds a second account (L1)
Plan-gatedRequired and Pinned field settingsRequired stays off; Pinned opens Upgrade to Business[obs EV-082][obs EV-083]
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Status pillPicker grouped Not started, Active, Closed[obs EV-054]
Next-status arrow ▸Moves to the next status in order; toast with Undo; activity linePUT /tasks/v1/item?...check_resolvedTask[obs EV-073][net EV-014]
Description typingSaved on its own (no Save); markdown "- " makes a bullet listnot fetch/XHR (collaborative editor)Task[obs EV-055][obs EV-078]
Comment composer > sendComment appears in the activity streamPOST /comments/v1/task/:id/commentTask[obs EV-057][net EV-058]
Add subtask > name > EnterSubtasks section with a table; input stays for the nextPOST /tasks/v1/subcategory/:list/taskTask[obs EV-062][net EV-063]
Relate > This task is blocked by > pickBlocked by row and Dependencies tab; the other task shows BlockingPOST /scheduling/v1/dependencyBoth tasks[obs EV-065][obs EV-066][net EV-069]
Create checklistA checklist named "Checklist" is created at oncePOST /tasks/v1/task/:id/checklistTask[obs EV-067][net EV-069]
Checklist item circleItem resolved and hidden under "Show 1 completed"PUT /tasks/v1/checklistItem/:idTask[obs EV-072]
Switch layoutToggles Full screen, Modal, SidebarUser preference (all workspaces)[obs EV-074][obs EV-075]
Opening or using a taskMarks it viewedPUT /task-v3/core/:id/tasks/:id/viewedUser (recently viewed)[net EV-058]
↑ ↓ arrowsPrevious or next task in the board order[obs EV-059]
Fields > + > Create new > type > CreateNew field on the task's listPOST /customFields/v2/field, PUT .../locationsList (field location)[obs EV-080][net EV-099]
A field valueType editor; saves on change; activity linePOST /customFields/v1/task/:id/field/:idTask[obs EV-117][net EV-112]
Phone flag menu > a countryChanges the default country of every phone fieldPUT /user/v1/userUser profile (all workspaces)[obs EV-130][obs EV-131]
Row gear > delete icon > DeleteField removed from every task, toast "Field deleted successfully"/customFields/v2/field/:id?delete_all=trueWorkspace (field to Trash)[obs EV-126][obs EV-127]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab orderNot walked in the task view
Arrow keysNot checked
ShortcutsDocumented: Shift+S status, Shift+A assignee, M assign to me, Shift+P priority, Shift+D date, Shift+L tag, Shift+M comment (off by default)[doc SRC-046]
Focus visibleNot checked
EscapeEscape in an empty checklist item input closed the whole task view and returned to the board[obs EV-068]
Unlabeled controlsSeveral icon-only buttons in the header have no name (one _iconOnly button flagged)[obs EV-050]
-

Microcopy

-
ElementTextEvidence
Description placeholder"Add description, or write with AI"[obs EV-051]
Section buttons"Add fields", "Add subtask", "Relate items or add dependencies", "Create checklist", "Attach file"[obs EV-051]
Relate menu"Relate a Task or Doc", "This task blocks...", "This task is blocked by...", "New custom relationship"[obs EV-064]
Composer"Write a comment..."; after the first comment "Comment, press 'space' for AI, '/' for commands"[obs EV-057]
Activity"You created this task", "You created subtask: …", "You marked this task as blocking …", "You added 3 items to checklist …", "You changed status from To Do to In Progress"[obs EV-062][obs EV-066][obs EV-071][obs EV-073]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
TitleTask.name[net EV-053]
TypeTask.custom_type (null = Task)[net EV-053][obs EV-077]
StatusTask.status {status, color, type, status_group}[net EV-053]
DatesTask.time_mgmt.start_date, due_date (+ _time flags)[net EV-053][obs EV-059]
AssigneesTask.users[type=assigned][net EV-053]
PriorityTask.priority[net EV-053]
TagsTask.tags[net EV-053]
DescriptionTask.content (rich text), text_content[net EV-053][obs EV-078]
SubtasksTask.subtask_ids, subtasks_count[net EV-053][obs EV-062]
DependenciesTask.related_tasks_count {dependsOn, dependedBy}[net EV-053][obs EV-065]
ChecklistsTask.checklists[{name, items[{name, resolved}]}][net EV-069][obs EV-071]
Activityhistory items and comments[net EV-058]
CreatedTask.time_mgmt.date_created ("Created 16 Oct")[obs EV-051]
FieldsCustomFieldValue for each CustomField at the task's locations[obs EV-117][net EV-112]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Status pillPicker grouped Not started, Active, Closed[obs EV-054]
Next-status arrow ▸Moves to the next status in order; toast with Undo; activity linePUT /tasks/v1/item?...check_resolvedTask[obs EV-073][net EV-014]
Description typingSaved on its own (no Save); markdown "- " makes a bullet listnot fetch/XHR (collaborative editor)Task[obs EV-055][obs EV-078]
Comment composer > sendComment appears in the activity streamPOST /comments/v1/task/:id/commentTask[obs EV-057][net EV-058]
Add subtask > name > EnterSubtasks section with a table; input stays for the nextPOST /tasks/v1/subcategory/:list/taskTask[obs EV-062][net EV-063]
Relate > This task is blocked by > pickBlocked by row and Dependencies tab; the other task shows BlockingPOST /scheduling/v1/dependencyBoth tasks[obs EV-065][obs EV-066][net EV-069]
Create checklistA checklist named "Checklist" is created at oncePOST /tasks/v1/task/:id/checklistTask[obs EV-067][net EV-069]
Checklist item circleItem resolved and hidden under "Show 1 completed"PUT /tasks/v1/checklistItem/:idTask[obs EV-072]
Switch layoutToggles Full screen, Modal, SidebarUser preference (all workspaces)[obs EV-074][obs EV-075]
Opening or using a taskMarks it viewedPUT /task-v3/core/:id/tasks/:id/viewedUser (recently viewed)[net EV-058]
↑ ↓ arrowsPrevious or next task in the board order[obs EV-059]
Fields > + > Create new > type > CreateNew field on the task's listPOST /customFields/v2/field, PUT .../locationsList (field location)[obs EV-080][net EV-099]
A field valueType editor; saves on change; activity linePOST /customFields/v1/task/:id/field/:idTask[obs EV-117][net EV-112]
Phone flag menu > a countryChanges the default country of every phone fieldPUT /user/v1/userUser profile (all workspaces)[obs EV-130][obs EV-131]
Row gear > delete icon > DeleteField removed from every task, toast "Field deleted successfully"/customFields/v2/field/:id?delete_all=trueWorkspace (field to Trash)[obs EV-126][obs EV-127]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab orderNot walked in the task view
Arrow keysNot checked
ShortcutsDocumented: Shift+S status, Shift+A assignee, M assign to me, Shift+P priority, Shift+D date, Shift+L tag, Shift+M comment (off by default)[doc SRC-046]
Focus visibleNot checked
EscapeEscape in an empty checklist item input closed the whole task view and returned to the board[obs EV-068]
Unlabeled controlsSeveral icon-only buttons in the header have no name (one _iconOnly button flagged)[obs EV-050]
+

Microcopy

+
ElementTextEvidence
Description placeholder"Add description, or write with AI"[obs EV-051]
Section buttons"Add fields", "Add subtask", "Relate items or add dependencies", "Create checklist", "Attach file"[obs EV-051]
Relate menu"Relate a Task or Doc", "This task blocks...", "This task is blocked by...", "New custom relationship"[obs EV-064]
Composer"Write a comment..."; after the first comment "Comment, press 'space' for AI, '/' for commands"[obs EV-057]
Activity"You created this task", "You created subtask: …", "You marked this task as blocking …", "You added 3 items to checklist …", "You changed status from To Do to In Progress"[obs EV-062][obs EV-066][obs EV-071][obs EV-073]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadBoard side confirmed (R-018); not checked inside the task view[obs EV-032]
Loading pattern (skeleton, spinner, optimistic update)Checklist section shows a skeleton while it is created[obs EV-067]
Delays the user seesNot measured (background tab)Q-001
-

Responsive

-
WidthChangeEvidence
1710 CSS pxFull screen, Modal and Sidebar layouts[obs EV-074][obs EV-075]
1024 and 390Not tested
-

Not tested

-
  • Attachments (no file upload), time tracking (would start a running timer), recurrence, cover image, task type change, Share and the sharing dialog (A5 risk).
  • Mentions, assigned comments, threaded replies, reactions (need a second person to be meaningful).
  • Description history, Print, Duplicate, Merge, Move, Archive, Delete from the task view.
  • Keyboard walk and focus styles inside the task view.
-
S-003 Custom Field Manager

Features: F-016, F-019 to F-021 · URL: a modal over /:team/settings/... (no route of its own seen) · Status: reviewed

-

Purpose

-

Lists every custom field of the workspace in one place, grouped by type, with where each one lives. From here the user creates fields, opens a field's settings and sees which locations and task types use it.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadBoard side confirmed (R-018); not checked inside the task view[obs EV-032]
Loading pattern (skeleton, spinner, optimistic update)Checklist section shows a skeleton while it is created[obs EV-067]
Delays the user seesNot measured (background tab)Q-001
+

Responsive

+
WidthChangeEvidence
1710 CSS pxFull screen, Modal and Sidebar layouts[obs EV-074][obs EV-075]
1024 and 390Not tested
+

Not tested

+
  • Attachments (no file upload), time tracking (would start a running timer), recurrence, cover image, task type change, Share and the sharing dialog (A5 risk).
  • Mentions, assigned comments, threaded replies, reactions (need a second person to be meaningful).
  • Description history, Print, Duplicate, Merge, Move, Archive, Delete from the task view.
  • Keyboard walk and focus styles inside the task view.
+
S-003

Custom Field Manager

FeaturesF-016, F-019 to F-021URLa modal over /:team/settings/... (no route of its own seen)Statusreviewed

Lists every custom field of the workspace in one place, grouped by type, with where each one lives. From here the user creates fields, opens a field's settings and sees which locations and task types use it.

EV-098 Custom Field Manager, all fields grouped by type with a Create <type> field link per group; columns Name, Type, Created by (masked), Date Created, Location(s)

Anatomy

  1. 1
    Left rail, topAll Custom Fields, Workspace Fields, Task Type Fields (New), Personal List
  2. 2
    Left rail, By LocationSearch and the location tree (Space)
  3. 3
    Left rail, By Task TypeTask, Milestone, Form Response, Meeting Note, each with a count
  4. 4
    ToolbarSearch fields, Field type grouping, Filter, Create new
  5. 5
    TableOne group per type (pill with icon and count), rows Name, Type icon, Created by, Date Created, Location(s), row menu; "+ Create <type> field" under each group
  6. 6
    Create new menu C-018AI Fields (Summary, Custom Text, Custom Dropdown), then All types

More from this screen 5 screenshots

EV-133 Trash after deleting the list: one row for the list (tasks are not listed separately), Deleted by masked
EV-134 Custom Field Manager after deleting the list: All Custom Fields empty; sections Workspace Fields, Task Type Fields, Personal List, By Location, By Task Type
EV-096 Create new type menu, top: AI Fields (Summary, Custom Text, Custom Dropdown), then All
EV-097 Create new type menu, bottom: Progress, Email, Phone, Categorize, Custom Dropdown, Translation, Sentiment, Tasks, Location, Rating, Voting, Signature, Button, Action Items, T-shirt Size
EV-045 Custom Field Manager, All Custom Fields: No matching results found (same moment as EV-044)

States

Empty"No matching results found" and a Create field button
Loading
TypicalGroups by type, one row each
Many items
Long text
Error
No permission
Plan-gatedBusiness Plus and above [doc SRC-006][doc SRC-008]
Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Settings > Features > Custom Field Manager [obs EV-133][obs EV-134].
  • The gear in a view's Fields panel and the workspace menu also open it [doc SRC-006].
-

Anatomy

-

Custom Field Manager grouped by type

-
#RegionContentsComponentEvidence
1Left rail, topAll Custom Fields, Workspace Fields, Task Type Fields (New), Personal List[obs EV-098]
2Left rail, By LocationSearch and the location tree (Space)[obs EV-098]
3Left rail, By Task TypeTask, Milestone, Form Response, Meeting Note, each with a count[obs EV-098]
4ToolbarSearch fields, Field type grouping, Filter, Create new[obs EV-098]
5TableOne group per type (pill with icon and count), rows Name, Type icon, Created by, Date Created, Location(s), row menu; "+ Create <type> field" under each group[obs EV-098]
6Create new menuAI Fields (Summary, Custom Text, Custom Dropdown), then All typesC-018[obs EV-096][obs EV-097]
-

Data shown

-
ElementEntity.fieldEvidence
NameCustomField.name[obs EV-098][net EV-099]
TypeCustomField.type[obs EV-098][net EV-099]
Created byCustomField.userid (masked)[obs EV-098][net EV-099]
Date CreatedCustomField.date_created[obs EV-098][net EV-099]
Location(s)CustomFieldLocation.parent[obs EV-098][net EV-099]
Task type countsCustomField bound to task types[obs EV-098]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyNew workspace, or after teardown"No matching results found" and a Create field button[obs EV-045][obs EV-134]
LoadingNot seen
Typical22 list-level fieldsGroups by type, one row each[obs EV-098]
Many itemsNot reached
Long textNot tested
ErrorNot reached
No permissionNeeds a second, non-admin account (L1)
Plan-gatedMoving and merging fields, task-type fieldsBusiness Plus and above [doc SRC-006][doc SRC-008]
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Create new > typeThe field form (C-018), with the location to choosePOST /customFields/v2/field, then PUT .../fields/:id/locationsWorkspace (field) + location[obs EV-097][net EV-099]
Group pill arrowCollapses a type groupnone seenBrowser[obs EV-098]
Left rail itemFilters the table (Workspace Fields, Personal List, a location, a task type)GET /customFields/v2/fieldnone[obs EV-134]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab orderNot walked
Arrow keysNot checked
ShortcutsNone seen
Focus visibleNot checked
EscapeNot checked
Unlabeled controlsNot checked
-

Microcopy

-
ElementTextEvidence
Empty table"No matching results found" · "Create field"[obs EV-134]
Group footer"Create <type> field"[obs EV-098]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
NameCustomField.name[obs EV-098][net EV-099]
TypeCustomField.type[obs EV-098][net EV-099]
Created byCustomField.userid (masked)[obs EV-098][net EV-099]
Date CreatedCustomField.date_created[obs EV-098][net EV-099]
Location(s)CustomFieldLocation.parent[obs EV-098][net EV-099]
Task type countsCustomField bound to task types[obs EV-098]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Create new > typeThe field form (C-018), with the location to choosePOST /customFields/v2/field, then PUT .../fields/:id/locationsWorkspace (field) + location[obs EV-097][net EV-099]
Group pill arrowCollapses a type groupnone seenBrowser[obs EV-098]
Left rail itemFilters the table (Workspace Fields, Personal List, a location, a task type)GET /customFields/v2/fieldnone[obs EV-134]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab orderNot walked
Arrow keysNot checked
ShortcutsNone seen
Focus visibleNot checked
EscapeNot checked
Unlabeled controlsNot checked
+

Microcopy

+
ElementTextEvidence
Empty table"No matching results found" · "Create field"[obs EV-134]
Group footer"Create <type> field"[obs EV-098]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadNot checked
Loading pattern (skeleton, spinner, optimistic update)Not seen
Delays the user seesNot measured
-

Responsive

-
WidthChangeEvidence
1710 CSS pxModal of about 1060 × 750 screenshot px[obs EV-098]
-

Not tested

-
  • Editing a field from the manager, moving and merging fields (Business Plus), filters other than the left rail, the row menu.
  • Workspace, Space and Folder locations: every study field lived on one list.
  • Task-type fields (Business Plus [doc SRC-008]).
  • The 7 "Custom Fields in Workspace" seen in the view Fields panel never appear here (B-007, Q-002).
-
S-005 Trash

Features: F-020 · URL: /:team/settings/trash · Status: reviewed

-

Purpose

-

Lists what was deleted in the workspace (lists, tasks, tags, custom fields) so an admin can restore it within 30 days or delete it forever.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadNot checked
Loading pattern (skeleton, spinner, optimistic update)Not seen
Delays the user seesNot measured
+

Responsive

+
WidthChangeEvidence
1710 CSS pxModal of about 1060 × 750 screenshot px[obs EV-098]
+

Not tested

+
  • Editing a field from the manager, moving and merging fields (Business Plus), filters other than the left rail, the row menu.
  • Workspace, Space and Folder locations: every study field lived on one list.
  • Task-type fields (Business Plus [doc SRC-008]).
  • The 7 "Custom Fields in Workspace" seen in the view Fields panel never appear here (B-007, Q-002).
+
S-005

Trash

FeaturesF-020URL/:team/settings/trashStatusreviewed

Lists what was deleted in the workspace (lists, tasks, tags, custom fields) so an admin can restore it within 30 days or delete it forever.

EV-137 Trash after teardown: the temporary task, the tag (tags go to Trash too) and the list; Deleted by masked; 30-day notice

Anatomy

  1. 1
    Header"Trash", the 30-day notice, "Clear all Trash" (red)
  2. 2
    FiltersSearch, Type, "Me" (on by default, removable)
  3. 3
    TableName with type icon, Location (path), Deleted on (relative), Deleted by (avatar), row menu
  4. 4
    Row menuRestore, Delete forever

More from this screen 4 screenshots

EV-128 Settings > Trash: deleted field listed with Location (1 location), Deleted on, Deleted by (masked); filter Me on by default; 30-day notice; Clear all Trash
EV-126 Delete confirmation: This action will delete this Custom Field from 1 task. Admins are able to restore deleted fields from the Trash.
EV-132 Delete list confirmation: 54 tasks and templates within this List will be deleted; automations will become inactive
EV-129 After Restore from Trash the dropdown field is back on the task with its old value [RE] opt A

States

EmptyTrash icon and "No items found for your search."
TypicalOne row each
Loading
Many items
Long text
Error
No permission
Plan-gated
Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Settings > Admin > Trash [obs EV-128].
  • The delete dialogs for fields mention it ("restore deleted fields from the Trash") and the list delete toast links to it ("List moved to trash") [obs EV-126][obs EV-132].
-

Anatomy

-

Trash after teardown

-
#RegionContentsComponentEvidence
1Header"Trash", the 30-day notice, "Clear all Trash" (red)[obs EV-137]
2FiltersSearch, Type, "Me" (on by default, removable)[obs EV-128]
3TableName with type icon, Location (path), Deleted on (relative), Deleted by (avatar), row menu[obs EV-137]
4Row menuRestore, Delete forever[obs EV-128]
-

Data shown

-
ElementEntity.fieldEvidence
Name and iconthe deleted object and its kind (list, task, tag, field)[obs EV-137]
Locationparent path ("Space > List", "1 location" for a field)[obs EV-128][obs EV-137]
Deleted ondeletion time, relative[obs EV-137]
Deleted byuser (masked)[obs EV-137]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyNothing deleted by the current userTrash icon and "No items found for your search."[obs EV-128]
TypicalDeleted list, tag and taskOne row each[obs EV-137]
LoadingNot seen
Many itemsNot reached
Long textNot tested
ErrorNot reached
No permissionNeeds a non-admin account (L1)
Plan-gatedNone seen
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Row menu > RestoreThe item leaves the list and comes back where it was, with its valuesnot capturedWorkspace[obs EV-129]
Row menu > Delete foreverNot clicked (permanent)
Clear all TrashNot clicked (permanent)
-

Keyboard and accessibility

-
CheckResultEvidence
Tab orderNot walked
Arrow keysNot checked
ShortcutsNone seen
Focus visibleNot checked
EscapeNot checked
Unlabeled controlsThe row menu button shows only "…"[obs EV-128]
-

Microcopy

-
ElementTextEvidence
Notice"Items shown below will be automatically deleted forever after 30 days."[obs EV-128]
Empty"No items found for your search."[obs EV-128]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
Name and iconthe deleted object and its kind (list, task, tag, field)[obs EV-137]
Locationparent path ("Space > List", "1 location" for a field)[obs EV-128][obs EV-137]
Deleted ondeletion time, relative[obs EV-137]
Deleted byuser (masked)[obs EV-137]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Row menu > RestoreThe item leaves the list and comes back where it was, with its valuesnot capturedWorkspace[obs EV-129]
Row menu > Delete foreverNot clicked (permanent)
Clear all TrashNot clicked (permanent)
+

Keyboard and accessibility

+
CheckResultEvidence
Tab orderNot walked
Arrow keysNot checked
ShortcutsNone seen
Focus visibleNot checked
EscapeNot checked
Unlabeled controlsThe row menu button shows only "…"[obs EV-128]
+

Microcopy

+
ElementTextEvidence
Notice"Items shown below will be automatically deleted forever after 30 days."[obs EV-128]
Empty"No items found for your search."[obs EV-128]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadNot checked
Loading pattern (skeleton, spinner, optimistic update)Not seen
Delays the user seesNone noticed
-

Responsive

-
WidthChangeEvidence
1710 CSS pxSettings layout with a left menu[obs EV-128]
-

Not tested

-
  • Delete forever and Clear all Trash (permanent deletion; out of bounds for the agent).
  • Restoring a list or a tag; the Type filter; the view with "Me" removed.
  • Who may restore (the delete dialog says admins).
-

04

Components

The reusable pieces of the interface and their states.

C-001 Board card

Product name: cu3-board-task (.board-task) · Used in: S-001 · Status: reviewed

-

Anatomy

-

Card states

-
#PartContentEvidence
1CoverOptional image or description above the title (Customize > Card cover: Auto, None, Image, Task description)[obs EV-021]
2TitleTask name, link to /t/:id/:id; up to two lines, then ellipsis[obs EV-012][obs EV-011]
3Task propertiesIcons for description, attachments, checklists, dependencies (Layout options > Show task properties)[obs EV-022][doc SRC-009]
4Field rowField toggles in order: assignee, dates, priority, tags, then shown custom fields; empty fields show an outline icon[obs EV-012][obs EV-043]
5Status chipOnly when the board is grouped by a field other than status[obs EV-026]
6Subtasks"N subtasks" toggle that expands children inside the card[doc SRC-009]
7Hover toolbarMark complete, Add subtask, Rename, More; top right, over the title[obs EV-013]
+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadNot checked
Loading pattern (skeleton, spinner, optimistic update)Not seen
Delays the user seesNone noticed
+

Responsive

+
WidthChangeEvidence
1710 CSS pxSettings layout with a left menu[obs EV-128]
+

Not tested

+
  • Delete forever and Clear all Trash (permanent deletion; out of bounds for the agent).
  • Restoring a list or a tag; the Type filter; the view with "Me" removed.
  • Who may restore (the delete dialog says admins).
+

04Components

The reusable pieces of the interface. Solid pills are variants and states seen in the product; dashed ones were not observed. Hover a pill for detail.

EV-010 Card date chips: overdue in red (3 days ago), today in yellow, range Today - Mon; priority chip High
C-001

Board card

Product namecu3-board-task (.board-task)Used inS-001Statusreviewed

Variants

Small / Medium / LargeStack fields onShow empty fields offClosed task

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • The whole card opens the task; the title is a real link, so middle click opens a new tab [obs EV-011].
  • Each field toggle opens its picker in place (C-004, C-005, C-009, C-010); edits are optimistic [obs EV-006].
  • Date chip text is relative: "3 days ago" (red, open and overdue), "Today" (yellow), "Today - Mon" for a range [obs EV-010].
  • The hover toolbar overlaps the end of a long title ("[RE] created in colu…") [obs EV-030].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1CoverOptional image or description above the title (Customize > Card cover: Auto, None, Image, Task description)[obs EV-021]
2TitleTask name, link to /t/:id/:id; up to two lines, then ellipsis[obs EV-012][obs EV-011]
3Task propertiesIcons for description, attachments, checklists, dependencies (Layout options > Show task properties)[obs EV-022][doc SRC-009]
4Field rowField toggles in order: assignee, dates, priority, tags, then shown custom fields; empty fields show an outline icon[obs EV-012][obs EV-043]
5Status chipOnly when the board is grouped by a field other than status[obs EV-026]
6Subtasks"N subtasks" toggle that expands children inside the card[doc SRC-009]
7Hover toolbarMark complete, Add subtask, Rename, More; top right, over the title[obs EV-013]

Field elements: cu-assignees-field, cu-dates-field (cu-task-row-recurring-date-picker), cu-priority-field, cu-tags-field, cu-board-task-custom-fields, each wrapped in cu-board-task-field-layout [obs EV-011].

-

Variants

-
VariantDifferenceEvidence
Small / Medium / LargeColumn width 200 / 264 / 328 CSS px; card 246 px wide at Medium[obs EV-046][obs EV-035]
Stack fields onEach filled field on its own row with an icon[obs EV-023]
Show empty fields offEmpty field placeholders hidden; an empty card shows only its title[obs EV-023]
Closed taskSame card in the closed column[obs EV-012]
-

States

-
StateVisual changeEvidence
DefaultBackground rgb(25,25,25), radius 10px, hairline white shadow[obs EV-035]
HoverHover toolbar appears top right; field tooltips ("Priority", "Dates")[obs EV-013][obs EV-010]
FocusField toggle gets a white 1px ring and dark 3px halo; title link no ring[obs EV-033]
PressedNot observed
SelectedCheckbox square at top right, filled white[obs EV-028]
DisabledNot observed
LoadingSkeleton block the size of a card[obs EV-018]
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Width (Medium)246 px inside a 264 px column[obs EV-035]
Min height72 px (title and one field row)[obs EV-035]
Backgroundrgb(25,25,25)--cu-background-subtle[obs EV-035]
Radius10px[obs EV-035]
Shadowrgba(255,255,255,.333) 0 0 1px, rgba(0,0,0,.055) 0 1px 2px[obs EV-035]
Title type14px/20px, weight 500, rgb(238,238,238)--cu-content-default[obs EV-035]
Field toggle24×24, radius 6px, 1px border rgb(34,34,34)--cu-border-low-contrast[obs EV-035]
Overdue date textrgb(255,133,137)--cu-content-danger[obs EV-035][obs EV-010]
Due today textrgb(255,204,77)--cu-content-warning[obs EV-035][obs EV-010]
-

Behavior

-
  • The whole card opens the task; the title is a real link, so middle click opens a new tab [obs EV-011].
  • Each field toggle opens its picker in place (C-004, C-005, C-009, C-010); edits are optimistic [obs EV-006].
  • Date chip text is relative: "3 days ago" (red, open and overdue), "Today" (yellow), "Today - Mon" for a range [obs EV-010].
  • The hover toolbar overlaps the end of a long title ("[RE] created in colu…") [obs EV-030].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
linktask nameEnter opensno outline[obs EV-034]
button (toolbar)"Mark complete", "Rename", More named by data-test; Add subtask unnamedTab reaches them even without hovernot checked[obs EV-034]
div[tabindex=0] field togglesnoneTabyes[obs EV-033][obs EV-034]
-

Not tested

-
  • Cover image (no attachment fixture), subtasks expander, task property icons with real content, pressed state.
-
C-002 Board column

Product name: cu3-board-group with cu3-board-group-header · Used in: S-001 · Status: reviewed

-

Anatomy

-

Column menu

-
#PartContentEvidence
1HeaderStatus pill (icon by status type, uppercase name) and count; header background tinted with the status color[obs EV-012][obs EV-035]
2Header hover actionsCollapse (‹), More (Group options), + (add task at the top)[obs EV-015]
3WIP slotcu3-board-grouping-header-wip present in the DOM; limits need Business[obs EV-011][doc SRC-011]
4Card listVirtualized list (cdk-virtual-scroll-viewport) of C-001[obs EV-011]
5Footer"+ Add Task" in the status color[obs EV-012]
-

Variants

-
VariantDifferenceEvidence
EmptyOnly "+ Add Task"[obs EV-002]
CollapsedVertical strip, rotated name, count[obs EV-017]
Non-status groupingHeader shows the value (flag + "High"); "No priority" column for empty values[obs EV-026]
Swimlane cellSame column per row of the subgroup[obs EV-027]
-

States

-
StateVisual changeEvidence
DefaultPill + count[obs EV-012]
HoverActions appear on the header[obs EV-015]
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingHeader skeleton[obs EV-018]
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Width264 px (Medium), 200 (Small), 328 (Large)[obs EV-046]
Header40 px high, 8px padding[obs EV-035]
Status pill20 px high, radius 6px, 11px/500 text, padding 2 6 2 4[obs EV-035]
Gap between columnsabout 8 px[obs EV-012]
-

Behavior

-
  • Group options menu: Collapse group, Archive all in this group, Automate status, Select all, Rename, Edit statuses. Archive all and Select all appear only when the column has tasks (R-009) [obs EV-015][obs EV-016].
  • Columns are not draggable on the board [inf] Q-003.
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
list items (li) per columnstatus name in data-test onlynot checkednot checked[obs EV-011]
-

Not tested

-
  • Rename, Edit statuses, Automate status and Archive all (not clicked).
-
C-003 Customize view panel

Product name: Customize view side panel (cu-view-setting-toggle) · Used in: S-001 · Status: reviewed

-

Anatomy

-

Customize view

-
#PartContentEvidence
1Header"Customize view", close[obs EV-019]
2NameView icon and name field ("Board")[obs EV-019]
3More options (inline)Card size, Card cover, Stack fields, Show empty fields, Collapse empty columns, More options ›[obs EV-020]
4Settings listFields (n shown), Filter, Group, Sort, Subtasks, Templates[obs EV-019]
5View togglesAutosave for me, Pin view, Private view, Protect view, Set as default view[obs EV-019]
6SharingCopy link to view, Favorite ›, Sharing & Permissions[obs EV-019]
7Layout options pagePage and card layout: Card size, Card cover, Stack fields, Show task properties, Show empty fields, Show task locations, Show subtask parent names, Collapse empty columns, Show column colors. Task visibility: Show closed tasks, Show closed subtasks, Show tasks from other Lists, Show subtasks from other Lists. View settings: Default to Me Mode, Duplicate view, Reset view to defaults, Default view settings[obs EV-022]
8Fields pageSearch, Create new / Add existing tabs; Shown (Task Name locked, Assignee, Dates, Priority, Tags); Properties (Date closed, Date created, Date updated, Status, Task ID, Task Type, Time tracked); Custom Fields in Workspace[obs EV-043][obs EV-044]
-

Variants

-
VariantDifferenceEvidence
Card size dropdownSmall, Medium (default), Large[obs EV-020]
Card cover dropdownAuto, None, Image (default), Task description[obs EV-021]
-

States

-
StateVisual changeEvidence
DefaultToggles off except Show empty fields, Show task properties, Show subtask parent names, Show column colors, tasks/subtasks from other Lists[obs EV-022]
HoverRow highlight; tooltip on Stack fields: "Display standard fields as stacked or inline"[obs EV-023]
FocusNot checked
PressedNot observed
SelectedCheckmark on the chosen dropdown value[obs EV-020]
Disabled"Show closed tasks" greyed while grouped by status[obs EV-022]
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Panel widthabout 270 px at 1456 px screenshot width (about 320 CSS px)[obs EV-019]
Toggle on colorbrand purple[obs EV-022]
-

Behavior

-
  • Every change re-renders the board and shows "Save view"; nothing persists until saved; a reload drops it (R-008) [obs EV-017][net EV-014].
  • The Fields page lists workspace fields that the Custom Field Manager does not show (B-008) [obs EV-044][obs EV-045].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
togglesrow label (view-setting-toggle__label)not checkednot checked[obs EV-011]
-

Not tested

-
  • Save view, Autosave, Pin, Private, Protect, Set as default, Duplicate, Reset, Templates, Sharing.
-
C-004 Date picker

Product name: cu-recurring-date-dropdown · Used in: S-001, S-002 · Status: reviewed

-

Anatomy

-

Date picker

-
#PartContentEvidence
1Inputs"Start date" and "Due date", each with clear (×) and "Add time" once set[obs EV-008][obs EV-009]
2Quick optionsToday, Later (a time later today), Tomorrow, This weekend, Next week (Monday), Next weekend, 2 weeks, 4 weeks; each shows the resolved day[obs EV-008]
3Month gridMonth and year, "Today", previous and next; weeks start on Monday; today in a red circle; range highlighted[obs EV-009]
4Set Recurring ›Recurrence submenu[obs EV-008]
5Work schedule banner"Set up your work schedule", dismissible[obs EV-008]
-

Variants

-
VariantDifferenceEvidence
Opens upwardWhen there is no room below the card[obs EV-009]
-

States

-
StateVisual changeEvidence
DefaultDue date input focused[obs EV-008]
HoverQuick option row highlight[obs EV-009]
FocusFocused input has a white border[obs EV-008]
PressedNot observed
SelectedChosen day boxed; start-to-due range shaded[obs EV-009]
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Sizeabout 410 × 310 px (screenshot scale)[obs EV-008]
-

Behavior

-
  • Opening it loads the workspace work schedule and schedule exceptions [net EV-014].
  • Picking a start date moves focus to the due date input [obs EV-009].
  • The value is saved when the picker closes, not when a day is clicked (R-005) [net EV-014].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
inputsplaceholders "Start date", "Due date"Escape closes and savesyes[obs EV-008][net EV-014]
-

Not tested

-
  • Typing a date as text, times, recurrence, work schedule setup.
-
C-005 Priority picker

Product name: cu-priority-list-dropdown · Used in: S-001, S-002 · Status: reviewed

-

Anatomy

-

Priority picker

-
#PartContentEvidence
1Search"Search..."[obs EV-006]
2PriorityUrgent (red flag, ⌘1), High (yellow, ⌘2), Normal (blue, ⌘3), Low (grey, ⌘4), Clear (⌘0)[obs EV-006]
3Personal PrioritiesSection with the operator's personal priority list[obs EV-006]
4AI"Prioritize with AI"[obs EV-006]
-

Variants

-
VariantDifferenceEvidence
Card chip after choiceFlag in the priority color plus label ("High", "Low")[obs EV-010][obs EV-032]
-

States

-
StateVisual changeEvidence
DefaultFirst item highlighted[obs EV-006]
HoverRow highlight[obs EV-006]
FocusSearch focused[obs EV-006]
PressedNot observed
SelectedNot observed
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Urgent flagred (rgb 255,133,137 family)[obs EV-006]
High flagyellow (rgb 255,204,77 family)[obs EV-006]
-

Behavior

-
  • Choosing a value saves at once: PUT /tasks/v1/item with priority as a numeric string, "2" for High (R-017) [net EV-007].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
menu itemspriority names⌘1 to ⌘4, ⌘0 shownnot checked[obs EV-006]
-

Not tested

-
  • Keyboard shortcuts themselves, Personal Priorities, Prioritize with AI.
-
C-006 Bulk action bar

Product name: bulk action toolbar (--cu-bulk-action-toolbar-inset-x) · Used in: S-001 · Status: reviewed

-

Anatomy

-

Bulk bar

-
#PartContentEvidence
1Count"1 Task selected" with × to clear[obs EV-028]
2ActionsStatus, Assignees, Dates, Custom Fields, Tags, Move/Add, Convert to Subtask, Copy, duplicate, archive, delete (red), More[obs EV-028]
-

Variants

-
VariantDifferenceEvidence
No custom fields in the list"Custom Fields" disabled[obs EV-028]
-

States

-
StateVisual changeEvidence
DefaultFloating bar at the bottom center[obs EV-028]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledGreyed action[obs EV-028]
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Inset34px--cu-bulk-action-toolbar-inset-x[obs EV-035]
-

Behavior

-
  • Opens after "Select all" in a column menu; selected cards show a filled checkbox at top right [obs EV-028].
  • No hover checkbox appeared on cards before a selection existed [obs EV-013].
  • × clears the selection and closes the bar [obs EV-028].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
buttonslabels as shown; icon-only buttons not checkednot checkednot checked[obs EV-028]
-

Not tested

-
  • Any bulk action, More menu contents, shift-click range selection.
-
C-007 Inline task create form

Product name: board quick create card · Used in: S-001 · Status: reviewed

-

Anatomy

-

Inline create

-
#PartContentEvidence
1Name inputPlaceholder "Task Name..."[obs EV-029]
2Save"Save ↵", disabled while the name is empty[obs EV-029]
3Field shortcutsAdd assignee, Add dates, Add priority, Add tag[obs EV-029]
-

Variants

-
VariantDifferenceEvidence
Column footer "+ Add Task"Form opens at the end of the column[obs EV-029]
Header +Form opens at the top of the column[obs EV-015]
-

States

-
StateVisual changeEvidence
DefaultWhite border around the form[obs EV-029]
HoverNot checked
FocusInput focused on open[obs EV-029]
PressedNot observed
SelectedNot applicable
DisabledSave disabled when empty[obs EV-029]
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthcard width[obs EV-029]
-

Behavior

-
  • Enter with an empty name does nothing and shows no message [obs EV-029].
  • Enter with a name creates the task with the column's status, keeps the form open for the next task and shows a "Task created" toast (R-010) [obs EV-030].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
textboxplaceholder onlyEnter saves, Escape closesyes[obs EV-029]
-

Not tested

-
  • Field shortcuts inside the form, pasting several lines.
-
C-008 Toast

Product name: cu-toast-new · Used in: S-001, S-002 · Status: reviewed

-

Anatomy

-

Toast

-
#PartContentEvidence
1Icon and titleGreen check and "Task created", or "Status changed"[obs EV-030][obs EV-012]
2BodyTask name "in" list link[obs EV-030]
3ActionsButtons with a number or key hint: "Pin to bottom 3", "Copy URL 2", "View task 1"; "Undo ⌘Z"[obs EV-030][obs EV-012]
-

Variants

-
VariantDifferenceEvidence
Task createdThree actions with digit shortcuts[obs EV-030]
Status changedUndo with ⌘Z[obs EV-012]
Priorities prompt"Don't ask again ⌥1", "Add to priorities ⌥2"[obs EV-042]
Offline mode"You can still track time and create tasks and reminders! Access any task in your tray."[obs EV-019]
-

States

-
StateVisual changeEvidence
DefaultBottom left over the sidebar, stacked when several[obs EV-030]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthabout 270 px at screenshot scale[obs EV-030]
-

Behavior

-
  • Several toasts stack; each disappears after a few seconds [obs EV-030].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
buttonslabelsdigit and ⌘Z hints shown; not pressednot checked[obs EV-030]
-

Not tested

-
  • The digit shortcuts and Undo itself; the exact timeout.
-
C-009 Assignee picker

Product name: cu-user-list-dropdown · Used in: S-001, S-002 · Status: reviewed

-

Anatomy

-

Assignee picker

-
#PartContentEvidence
1Search"Search or enter email..."[obs EV-041]
2People"Me" first (avatar), then members[obs EV-041]
3AI"Assign with AI"[obs EV-041]
-

Variants

-
VariantDifferenceEvidence
Single-member workspaceOnly "Me"[obs EV-041]
-

States

-
StateVisual changeEvidence
DefaultList of people[obs EV-041]
HoverRow highlight[obs EV-041]
FocusNot checked
PressedNot observed
SelectedAvatar shown on the card[obs EV-012]
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthabout 240 px at screenshot scale[obs EV-041]
-

Behavior

-
  • Picking "Me" saves at once (PUT /tasks/v1/task/:id with assignees.add) and then shows a prompt to add the task to the user's priorities (R-007) [net EV-014][obs EV-042].
  • Typing an email would invite a person (A5): not done.
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
listnot checkednot checkednot checked
-

Not tested

-
  • Teams, other members, invite by email (needs a second account: L1).
-
C-010 Tag picker

Product name: cu-tags-list · Used in: S-001, S-002 · Status: reviewed

-

Anatomy

-

Tag picker

-
#PartContentEvidence
1InputTag search; applied tags show as removable pills inside it[obs EV-040]
2Options"Select an option" header, matching tags, "Create <name> ↵" when no tag matches[obs EV-040]
3SettingsGear to manage tags[obs EV-040]
-

Variants

-
VariantDifferenceEvidence
Card chipGrey pill with the tag name ("[re] tag-a")[obs EV-012]
-

States

-
StateVisual changeEvidence
DefaultInput focused[obs EV-040]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedPill in the input[obs EV-040]
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
New tag colorstag_fg and tag_bg hex colors chosen by the product[net EV-014]
-

Behavior

-
  • Tags are created at Space level and applied to the task in one request when the picker closes (R-006) [net EV-014].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
inputnot checkedEnter createsnot checked[obs EV-040]
-

Not tested

-
  • Tag colors, tag manager, removing a tag.
-
C-011 Task fields grid

Product name: cu-task-fields-container · Used in: S-002 · Status: reviewed

-

Anatomy

-

Task fields grid

-
#PartContentEvidence
1StatusStatus pill, next-status arrow ▸, complete ✓[obs EV-073]
2DatesStart → Due; overdue due date in red[obs EV-059]
3Track timeStart timer[obs EV-051]
4AssigneesAvatars; Empty when none[obs EV-051]
5PriorityFlag and label; Empty when none[obs EV-051]
6TagsTag pills; Empty when none[obs EV-051]
7Dependency rowsBlocked by / Blocking with the other task[obs EV-065][obs EV-066]
8Collapse empty fieldsLink that hides empty properties[obs EV-073]
-

Variants

-
VariantDifferenceEvidence
Empty taskPlaceholders Start, Due, Empty[obs EV-059]
With dependencyExtra row under the grid[obs EV-065]
-

States

-
StateVisual changeEvidence
DefaultLabel column with icons, value column[obs EV-051]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Layouttwo columns of label + value[obs EV-051]
-

Behavior

-
  • Each value opens the same pickers as the board card (C-004, C-005, C-009, C-010) [obs EV-051].
  • The ✓ completes the task; ▸ moves to the next status (R-024) [obs EV-073].
  • A browser-stored preference hides empty fields (cu-task-view-hide-empty-location-fields in localStorage) [obs EV-011].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
buttonslabel icons per field (task-field-label-icon__container-<Field>)not checkednot checked[obs EV-050]
-

Not tested

-
  • Time tracking, Collapse empty fields toggle (browser preference), assignee change in the task view.
-
C-012 Description editor

Product name: cu-task-editor (Quill) · Used in: S-002 · Status: reviewed

-

Anatomy

-

Description editor

-
#PartContentEvidence
1Text areaRich text with markdown shortcuts[obs EV-055]
2PlaceholderAdd description, or write with AI[obs EV-051]
3ActionsDescription history, full screen[obs EV-055][obs EV-050]
-

Variants

-
VariantDifferenceEvidence
EmptyPlaceholder with AI link[obs EV-051]
FilledParagraphs and lists[obs EV-078]
-

States

-
StateVisual changeEvidence
DefaultPlain text[obs EV-078]
HoverNot checked
FocusCaret, toolbar on selection[obs EV-055]
PressedNot observed
SelectedNot checked
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widththe content column[obs EV-051]
-

Behavior

-
  • Saves without a button through the collaborative editor connection; the task detail response carries an editor_token [net EV-053][obs EV-078].
  • "- " at the start of a line makes a bullet list; **bold** typed in one go is not converted (R-025) [obs EV-055].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
textbox (contenteditable)not checkedEnter new linecaret[obs EV-055]
-

Not tested

-
  • Toolbar formats, slash commands, AI writing, image paste, description history, concurrent editing.
-
C-013 Subtasks section

Product name: cu-task-view-subtasks-section · Used in: S-002 · Status: reviewed

-

Anatomy

-

Subtasks section

-
#PartContentEvidence
1HeaderSubtasks, N open, progress bar; Sort, expand, Suggest (AI), +[obs EV-062]
2TableName with status circle, Assignee, Priority, add column[obs EV-062]
3Add Task rowInline create[obs EV-062]
-

Variants

-
VariantDifferenceEvidence
Before first subtaskSingle input under the header[obs EV-061]
-

States

-
StateVisual changeEvidence
DefaultTable[obs EV-062]
HoverNot checked
FocusInput focused after Add subtask[obs EV-061]
PressedNot observed
SelectedRow checkbox column[obs EV-062]
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Row heightabout 30 px[obs EV-062]
-

Behavior

-
  • Enter creates the subtask and keeps the input open; each create is one request with parent set (R-028) [net EV-063].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
table rowsnot checkedEnter createsnot checked[obs EV-061]
-

Not tested

-
  • Sort, Suggest (AI), nested subtasks, subtask status changes, converting a subtask.
-
C-014 Checklist

Product name: cu-task-view-checklists-section · Used in: S-002 · Status: reviewed

-

Anatomy

-

Checklist

-
#PartContentEvidence
1HeaderChecklists, N open, progress bar; expand, +[obs EV-071]
2ChecklistEditable name, items with circles, Add item[obs EV-071]
3FooterShow N completed, Add checklist[obs EV-072]
4Item hoverDrag handle; actions (assign, convert, More)[obs EV-072]
-

Variants

-
VariantDifferenceEvidence
NewName 'Checklist' in edit mode[obs EV-067]
-

States

-
StateVisual changeEvidence
DefaultOpen items listed[obs EV-071]
HoverItem actions[obs EV-072]
FocusNot checked
PressedNot observed
SelectedResolved items hidden[obs EV-072]
DisabledNot observed
LoadingSkeleton while created[obs EV-067]
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Item rowabout 30 px[obs EV-071]
-

Behavior

-
  • Create checklist saves an empty checklist at once (R-030); items save one request each; items have uuid IDs and can nest (children) and carry an assignee and dates [net EV-069].
  • Resolved items collapse under Show completed (R-031) [obs EV-072].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
itemsnot checkedEnter adds, Escape on empty closes the task viewnot checked[obs EV-068]
-

Not tested

-
  • Item assignee and dates, nesting, reordering, deleting a checklist, converting an item to a task.
-
C-015 Relationships section

Product name: cu-task-view-relationships-section · Used in: S-002 · Status: reviewed

-

Anatomy

-

Relationships section

-
#PartContentEvidence
1TabsRelated, Dependencies with count[obs EV-065]
2Dependencies tableGroup Blocked by N; Name, Due date, Priority, assignee[obs EV-065]
3Related empty stateNo tasks or docs related. Relate[obs EV-066]
-

Variants

-
VariantDifferenceEvidence
Blocked sideWarning icon, Blocked by[obs EV-065]
Blocking sideRed icon, Blocking[obs EV-066]
-

States

-
StateVisual changeEvidence
DefaultTabs and table[obs EV-065]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedActive tab underlined[obs EV-065]
DisabledNot observed
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Tabunderline indicator[obs EV-065]
-

Behavior

-
  • The Relate menu offers Relate a Task or Doc, This task blocks..., This task is blocked by..., New custom relationship [obs EV-064].
  • Picking a task from search creates the dependency in one request (task_id, depends_on; the response has type and lag_ms) (R-029) [net EV-069].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
tabs (role tab)Related, Dependenciesnot checkednot checked[obs EV-050]
-

Not tested

-
  • Plain task links, custom relationships, removing a dependency, closing a blocked task (dependency warning).
-
C-016 Activity and comments

Product name: cu-task-view-right-sidebar · Used in: S-002 · Status: reviewed

-

Anatomy

-

Activity and comments

-
#PartContentEvidence
1HeaderActivity, search, follower count, filter[obs EV-051]
2History linesYou <did> … with relative time; Show more folds older lines[obs EV-051][obs EV-073]
3Comment cardAuthor, time, text, reactions, Reply[obs EV-057]
4ComposerText, toolbar (add, AI, attach, mention, assign, emoji, clip, task, doc), send with menu[obs EV-056]
-

Variants

-
VariantDifferenceEvidence
Modal layoutSidebar inside the modal[obs EV-075]
Sidebar layoutCollapsed to icons[obs EV-074]
-

States

-
StateVisual changeEvidence
DefaultHistory only[obs EV-051]
HoverNot checked
FocusComposer focused[obs EV-056]
PressedNot observed
SelectedNot applicable
DisabledSend disabled while empty[obs EV-051]
LoadingEmpty list until history loads[obs EV-051]
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthabout 560 CSS px[obs EV-050]
-

Behavior

-
  • History is read in pages from tasks/history; comments come from a separate comment service [net EV-053][net EV-058].
  • Several item creations aggregate into one line ("added 3 items") [obs EV-071].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
textboxplaceholder onlynot checkednot checked[obs EV-056]
-

Not tested

-
  • Mentions, assigned comments, threads, reactions, attachments in comments, activity filters and search.
-
C-017 Task Fields section

Product name: cu-task-view-custom-fields-section · Used in: S-002 · Status: reviewed

-

Anatomy

-

Fields section with every value

-
#PartContentEvidence
1HeaderCollapse arrow, "Fields", then search, expand and + (add field)[obs EV-117]
2Row labelType icon and field name; on hover a pin-off icon at the left and a gear (field settings) at the right[obs EV-102][obs EV-117]
3Row valueThe value as rendered by its type (C-019), "–" when empty; on hover a clear × at the far right[obs EV-103][obs EV-117]
4Footer"Hide N empty fields" / show toggle[obs EV-117]
5Add fields popover (from +)Search for new or existing fields, tabs Create new and Add existing, Popular and All type lists[obs EV-079]
-

Variants

-
VariantDifferenceEvidence
All filledNo empty rows; the footer counts only the empty ones left[obs EV-117]
Mostly emptyRows show "–"; empty rows stay listed until hidden with the footer link[obs EV-100]
-

States

-
StateVisual changeEvidence
DefaultLabel column and value column, one row per field[obs EV-117]
HoverRow highlight, gear and clear icons[obs EV-102]
FocusThe value becomes an input or opens a picker or popover[obs EV-102][obs EV-108]
PressedNot observed
SelectedNot applicable
DisabledFormula values are grey and read-only[obs EV-116]
LoadingFormula showed empty for a moment after the task opened[obs EV-129]
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Layouttwo columns, label about one quarter of the width[obs EV-117]
Row heightabout 30 screenshot px; text area rows grow with the lines[obs EV-117]
-

Behavior

-
  • Rows are sorted by name and include every field of the task's locations; Tasks and Relationship fields are not here, they live in the Related section (R-039, R-043) [obs EV-117][obs EV-118].
  • Every value saves on its own; there is no Save button (R-044) [net EV-112].
  • The gear opens the field settings popover (C-018) for that field, from which the field can be deleted (R-051) [obs EV-125].
  • Escape inside the task view closes the whole view (R-032), so editors are closed by clicking outside [obs EV-068].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
button"Set value for <field> Custom Field"not checkednot checked[obs EV-139]
-

Not tested

-
  • Keyboard entry into rows, the search and expand icons, drag order, Add existing.
  • How required, pinned and task-type fields are grouped (plan-gated).
-
C-018 Custom field form

Product name: field create and edit popover · Used in: S-002, S-003 · Status: reviewed

-

Anatomy

-

Create Dropdown form

-
#PartContentEvidence
1Type switcherCurrent type with a menu to change it; "Advanced" (gear) on edit[obs EV-080][obs EV-125]
2Field nameRequired; emoji picker at the left[obs EV-080][obs EV-125]
3Type optionsPer type, see the table below[obs EV-084] to [obs EV-094]
4AI Autofill"Automatically assign Dropdown values", Off by default[obs EV-080][obs EV-125]
5Permissions and settingsDescription, Permissions (Workspace default), Exceptions (creator can edit), Required in tasks, Pinned, Visible to Guests and Limited Members (on), "Belongs to" with the location[obs EV-081]
6FooterCreate or Save (disabled until valid), Cancel; on edit a red delete icon at the left[obs EV-080][obs EV-125]
-

Options per type

-
TypeOptions in the formEvidence
DropdownOptions with color dots, Set default, delete per option, Add option, AI option generator, sort Manual[obs EV-080][obs EV-125]
LabelsSame as Dropdown; Create stays disabled until one option exists[obs EV-092]
NumberNumber format US (1,234.56) or EU (1.234,56)[obs EV-084]
MoneyCurrency (BRL - Brazilian Real (R$) chosen), number format[obs EV-085]
VotingEmoji type, "Hide users who have voted"[obs EV-086]
TasksRelationship name, related to any task in the workspace or to tasks from one List, Create rollup fields[obs EV-087]
RelationshipTasks from a specific List (required; the field's own list not offered), rollup fields from it[obs EV-093]
PeopleShow people from the entire workspace, show guests, select multiple people (on), include teams[obs EV-088]
RatingEmoji type (star), scale 1 to 5 (default 3)[obs EV-089]
Progress (Auto)Track completion of subtasks, checklists, assigned comments; tasks without action items show 100% when done[obs EV-090]
Progress (Manual)Start value 0, end value 100[obs EV-091]
ButtonName, button label and color; "Action required: Add automation"[obs EV-094]
AI SummaryA Text area preset with AI Autofill on and a prompt[obs EV-095]
-

Variants

-
VariantDifferenceEvidence
Create from a taskOpens over the task; location defaults to the task's list[obs EV-080][obs EV-081]
Create from the managerOpens over the manager after choosing a type[obs EV-086]
Edit from the row gearSame form with Save, Advanced and the delete icon[obs EV-125]
-

States

-
StateVisual changeEvidence
DefaultFooter button disabled until required parts are filled[obs EV-092][obs EV-125]
HoverNot checked
FocusName input focused on open[obs EV-080]
PressedNot observed
SelectedNot applicable
DisabledRequired in tasks cannot be turned on (Free Forever)[obs EV-082]
LoadingNot observed
ErrorNot observed
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthabout 310 screenshot px popover[obs EV-125]
-

Behavior

-
  • Create sends the definition and then its location (R-033) [net EV-099].
  • Required in tasks does not turn on and Pinned opens an upgrade dialog on Free Forever (R-041) [obs EV-082][obs EV-083].
  • The delete icon asks for confirmation and moves the field to Trash (R-051) [obs EV-126].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
dialognot checkednot checkednot checked
-

Not tested

-
  • Changing the type of an existing field (conversion rules are in SRC-045), Advanced settings, default values, permissions and exceptions with other people (needs L1).
  • AI option generator and AI Autofill (consume AI credits).
  • Button fields with an automation, Rollup fields.
-
C-019 Custom field value, by type

Product name: value cell in the Fields section and the card field row · Used in: S-001, S-002 · Status: reviewed

-

How each of the 22 field types tested looks in the task view and on a board card, how it is edited and what it stores. Request shapes are in EV-112.

-

Anatomy

-

Card with every field filled

-
#PartContentEvidence
1Type iconOne icon per type, at the left of the task row and of the card row[obs EV-117][obs EV-121]
2ValueRendered per type (table below)[obs EV-117][obs EV-121]
3Empty value"–" in the task view, "-" on cards, with the exceptions in the table[obs EV-100][obs EV-120]
-

Rendering per type

-
TypeTask view, filledEditorCard, emptyCard, filledStored valueEvidence
CheckboxPurple checked boxClickEmpty boxChecked boxboolean[obs EV-117][obs EV-120][obs EV-121][net EV-112]
DateRelative day ("Mon")Date picker-"Mon"epoch ms + time flag[obs EV-117][obs EV-121][net EV-112]
DropdownColored pill with ▾Picker: search, colored options, drag handles-Pill with ▾, editable in placeoption id[obs EV-100][obs EV-122][net EV-112]
LabelsColored pillsSame picker, several values-Pillsone add per label[obs EV-101][obs EV-121][net EV-112]
TextPlain textInline input-Textstring[obs EV-111][obs EV-121]
Text areaSeveral linesLarge popover editor-First line + "..."string, rich text copy[obs EV-108][obs EV-109][obs EV-121][net EV-112]
Number1.234,5 (field format EU)Inline input with clear ×-1.234,5string[obs EV-103][obs EV-121][net EV-112]
MoneyR$ 1.234,56 (BRL, EU); empty shows "R$"Inline input with mask-R$ 1.234,56string[obs EV-101][obs EV-102][obs EV-121]
EmailTextInline input-Textstring (email)[obs EV-117][obs EV-121]
Phone+55 11 90000 0000Flag menu + masked input; the flag writes the profile country (R-036)-Same text, shown a moment laterstring[obs EV-104][obs EV-105][obs EV-121]
WebsiteFavicon + domain onlyInline input-Favicon + domainstring (url)[obs EV-111][obs EV-121]
LocationFormatted addressSearch with Google Places suggestions-Address cut at card widthaddress, lat, lng, place id[obs EV-113][obs EV-114][obs EV-121][net EV-112]
PeopleAvatar (masked)Person picker, "Keep typing a full email to invite"-Avataruser ids add/rem[obs EV-106][obs EV-121][net EV-112]
Rating2 of 3 starsClick a starGrey starsStars, shown a moment laternumber[obs EV-111][obs EV-120][obs EV-121]
Voting👍 1Toggle own vote👍 0👍 1user ids add/rem[obs EV-109][obs EV-120][obs EV-121][net EV-112]
Progress (Manual)Slider with value 61Drag the knobSlider at 0Slider and 61{current}[obs EV-107][obs EV-120][obs EV-121][net EV-112]
Progress (Auto)Bar 0%Computed (subtasks, checklists, assigned comments)Bar 0%; 100% on a closed taskBar and percentcomputed[obs EV-090][obs EV-120]
SignatureTyped name in a script fontPad, Type or Draw, Clear, Save-Script namestring + isTyped, signedBy[obs EV-110][obs EV-111][obs EV-121][net EV-112]
FormulaGrey computed value, R$ 2.469,06Field, operator, field; Advanced EditorR$ 0R$ 2.469,06definition only (no per-task write)[obs EV-115][obs EV-116][obs EV-120][net EV-112]
Files"–"Not tested (upload)--not captured[obs EV-121]
TasksNot in Fields; Related tab with a tableRelate menu > field > task picker (Recent Tasks)"Add task"Task chip + "+"task ids add/rem[obs EV-118][obs EV-119][obs EV-121][net EV-112]
RelationshipNot in Fields; Related tabRelate menu > field"Add task""Add task" (target list empty)not captured[obs EV-118][obs EV-121]
-

Variants

-
VariantDifferenceEvidence
Task viewFull value, editor in place or in a popover[obs EV-117]
CardOne row per shown field, compact, cut to the card width[obs EV-121]
-

States

-
StateVisual changeEvidence
DefaultAs in the table[obs EV-117]
HoverCard: field name tooltip on the icon; task view: gear and clear icons[obs EV-122][obs EV-102]
FocusEditor opens[obs EV-102]
PressedNot observed
SelectedNot applicable
DisabledFormula is read-only[obs EV-116]
LoadingRating and phone appear on cards after the other rows[obs EV-121]
ErrorNot observed (no invalid email or URL tried)
-

Measurements and tokens

-
PropertyValueTokenEvidence
Card rowicon column plus value, about 24 screenshot px per row[obs EV-121]
-

Behavior

-
  • Values render the same way in the task and on the card, except text area (first line on the card), location (cut) and the relationship types (chips on the card, a Related tab in the task) [obs EV-117][obs EV-121].
  • Number and money formats come from the field, not from the user's language (R-035) [obs EV-084][obs EV-085].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
button"Set value for <field> Custom Field"not checkednot checked[obs EV-139]
-

Not tested

-
  • Files (upload), Button (needs an automation), Rollup, AI fields (Summary, Custom Text, Custom Dropdown, Categorize, Translation, Sentiment, Action Items, T-shirt Size; they spend AI credits).
  • Invalid input (bad email, bad URL, letters in Number), very long values, many labels or people on a card.
  • Drawn signatures, Relationship with linked tasks, Voting by several people.
-

05

How it behaves

Business rules observed in the product, each with its evidence. They become the acceptance tests of the new product.

Rules: board view

R-001 The board shows one column per status of the list, empty ones included, in status order

-
  • Given a list whose statuses are to do, in progress, complete
  • When the board view opens with Group: Status
  • Then three columns appear in that order, each with its count, even when empty, followed by "+ Add group"; the closed status is the last column
  • Evidence: [obs EV-002][obs EV-038][net EV-014]
  • Feature: F-001 · Screen: S-001
-

R-002 Column counts include every task of the group; the sidebar list count leaves out closed tasks

-
  • Given 54 tasks, one of them in the closed status
  • When the board and the sidebar render
  • Then the columns read 53 and 1, and the sidebar shows 53 next to the list
  • Evidence: [obs EV-012][obs EV-046]
  • Feature: F-001 · Screen: S-001
-

R-003 Mark complete on a card moves the task to the closed status and offers Undo

-
  • Given an open task on the board
  • When the user clicks ✓ "Mark complete" in the card's hover toolbar
  • Then the card moves to the closed column, the counts update, and a toast "Status changed" shows "Undo ⌘Z"; the request sends status with the closed status name
  • Evidence: [obs EV-012][net EV-014]
  • Feature: F-002 · Screen: S-001
-

R-004 The card date chip uses relative text and an urgency color

-
  • Given open tasks with due dates in the past, today, and a start-to-due range
  • When the board renders
  • Then a past due date reads "3 days ago" in red, today reads "Today" in yellow, and a range reads "Today - Mon" in the default color
  • Evidence: [obs EV-010][obs EV-035]
  • Feature: F-002 · Screen: S-001
-
ProbeInputResultEvidence
Overduedue 13 Oct, today 16 Oct"3 days ago", red[obs EV-010]
Todayquick option Today"Today", yellow[obs EV-010]
Rangestart Today, due Next week"Today - Mon"[obs EV-010]
-

R-005 The date picker saves when it closes, not when a day is clicked

-
  • Given the date picker open on a card
  • When the user clicks a day
  • Then the chip updates inside the picker only; the update request is sent when the picker closes (Escape or click outside)
  • Evidence: [net EV-014][obs EV-008]
  • Feature: F-002 · Screen: S-001
-

R-006 Typing an unknown tag on a card creates a Space tag and applies it when the picker closes

-
  • Given the tag picker on a card and a name that matches no tag
  • When the user presses Enter on "Create <name>" and closes the picker
  • Then one request creates the tag with generated foreground and background colors and applies it to the task; the card shows the tag pill
  • Evidence: [obs EV-040][net EV-014]
  • Feature: F-025 · Screen: S-001
-

R-007 Assigning yourself prompts to add the task to your personal priorities

-
  • Given the assignee picker on a card
  • When the user picks "Me"
  • Then the assignee is saved at once and a prompt offers "Don't ask again" and "Add to priorities"
  • Evidence: [obs EV-041][obs EV-042][net EV-014]
  • Feature: F-002 · Screen: S-001
-

R-008 View changes are drafts until Save view; a reload drops them without warning

-
  • Given the default board view
  • When the user collapses a column, changes card size, toggles a layout option, or changes grouping
  • Then "Save view" appears in the toolbar, the board re-queries the view with the draft settings, nothing is saved; after a reload the board is back to the saved settings and no message mentions the lost draft
  • Evidence: [obs EV-017][obs EV-020][net EV-014]
  • Feature: F-004 · Screen: S-001
-
ProbeInputResultEvidence
Collapse group, reloadIN PROGRESS collapsedexpanded again after reload[obs EV-017]
Card size Large, layout toggles, reloadLarge, Stack fields on, Show empty fields offback to Medium and defaults[obs EV-023]
Group Priority + subgroup Status, reloadswimlanesback to Group: Status[obs EV-027]
-

R-009 The column menu offers Archive all and Select all only for columns with tasks

-
  • Given one column with tasks and one empty column
  • When the user opens Group options on each
  • Then the full column shows Collapse group, Archive all in this group, Automate status, Select all, Rename, Edit statuses; the empty column shows only Collapse group, Automate status, Rename, Edit statuses
  • Evidence: [obs EV-015][obs EV-016]
  • Feature: F-001 · Screen: S-001
-

R-010 A task created inside a column takes that column's status and the form stays open

-
  • Given the board grouped by status
  • When the user opens "+ Add Task" in IN PROGRESS, types a name and presses Enter
  • Then the task is created with status in progress, the form reopens for the next task, and a "Task created" toast appears; Enter with an empty name does nothing
  • Evidence: [obs EV-029][obs EV-030]
  • Feature: F-003 · Screen: S-001
-

R-011 Adding a group on a list that inherits statuses asks where the new status applies

-
  • Given a list that inherits its statuses from the Space
  • When the user adds a group named "[re] review" and confirms with ✓
  • Then a dialog asks "List only" (default) or "Entire Space"; with List only the list gets its own statuses and the new status column appears before the closed column
  • Evidence: [obs EV-036][obs EV-037][obs EV-038]
  • Feature: F-024 · Screen: S-001
-

R-012 Grouping by a field other than status adds a status chip to cards and a column for empty values

-
  • Given the board
  • When Group is set to Priority
  • Then columns are Urgent, High, Normal, Low and No priority; cards show their status as a chip; closed tasks are hidden and the Closed toggle becomes active
  • Evidence: [obs EV-026][obs EV-025]
  • Feature: F-004 · Screen: S-001
-

R-013 A subgroup splits the board into collapsible swimlanes

-
  • Given the board grouped by Priority
  • When the user adds a subgroup by Status
  • Then each status becomes a row with its own count, collapse arrow and +, crossing every priority column; the group button reads "Group: Priority / Status"
  • Evidence: [obs EV-027]
  • Feature: F-004 · Screen: S-001
-

R-014 Card size sets the column width

-
  • Given the board
  • When Card size is Small, Medium or Large
  • Then columns are 200, 264 or 328 CSS px wide; Medium is the default
  • Evidence: [obs EV-020][obs EV-021][obs EV-046]
  • Feature: F-004 · Screen: S-001
-

R-015 Show empty fields and Stack fields change the card body

-
  • Given cards with some fields empty
  • When Show empty fields is off and Stack fields is on
  • Then empty field placeholders disappear (an empty card shows only its title) and each filled field takes its own row with an icon
  • Evidence: [obs EV-023]
  • Feature: F-004 · Screen: S-001
-

R-016 Columns load tasks in pages while scrolling

-
  • Given a column with 53 tasks
  • When the board loads and the user scrolls inside the column
  • Then about 11 cards exist at first; scrolling sends another tasks/bulk request and more cards render
  • Evidence: [obs EV-046][net EV-014]
  • Feature: F-007 · Screen: S-001
-

R-017 Priority has four fixed levels stored as numbers

-
  • Given the priority picker
  • When the user picks High
  • Then the card shows a yellow flag with "High" and the request sends priority: "2"; the scale is Urgent 1, High 2, Normal 3, Low 4, and Clear removes it
  • Evidence: [obs EV-006][net EV-007][doc SRC-031]
  • Feature: F-002 · Screen: S-001
-

R-018 Changes appear in other open tabs without reload

-
  • Given the same board open in two tabs
  • When priority Low is set in the first tab
  • Then the second tab shows "Low" on the card without a reload (about 8 s in a background tab)
  • Evidence: [obs EV-031][obs EV-032]
  • Feature: F-026 · Screen: S-001
-

R-019 Dragging a card to another column changes its group value

-
  • Given the board grouped by status
  • When the user drags a card to another column
  • Then the task takes that column's status; dragging within a column changes its order
  • Evidence: [doc SRC-012]
  • Feature: F-005 · Screen: S-001
  • Not observed: the drag could not be automated (EV-046). Q-003.
-

Rules: custom fields

R-033 A field created from a task belongs to that task's list

-
  • Given a task in the list [RE] Board study
  • When the user opens Add fields > Create new, picks a type, types a name and clicks Create
  • Then the field is created with one location, the list ("Belongs to: [RE] Board study"), and shows in the Fields section of every task in that list; the client sends two requests: the definition (POST /customFields/v2/field) and its location (PUT /field/v3/.../fields/:id/locations, parent type 6 = List)
  • Evidence: [obs EV-079][obs EV-080][obs EV-081][net EV-099]
  • Feature: F-016 · Screen: S-002
-

R-034 The type menu puts popular and AI types first; Rollup is not a type of its own

-
  • Given Add fields > Create new in a task, or Create new in the Custom Field Manager
  • When the type menu opens
  • Then the task view lists Popular (Dropdown, Text, Date, Text area, Number, Labels, AI Autofill) and then All; the manager lists AI Fields (Summary, Custom Text, Custom Dropdown) and then All, which ends with Categorize, Translation, Sentiment, Action Items and T-shirt Size; Rollup is offered only inside a Tasks or Relationship field ("Create rollup fields")
  • Evidence: [obs EV-079][obs EV-096][obs EV-097][obs EV-087][obs EV-093]
  • Feature: F-016 · Screen: S-003
-

R-035 Number and money formats are set per field, not by the user's language

-
  • Given a Number field with format EU (1.234,56) and a Money field in BRL with format EU
  • When the user enters 1234,5 and 1234,56
  • Then the task and the card show 1.234,5 and R$ 1.234,56; the field stores number_format: "de-DE" and currency_type: "BRL", and the value is sent as a string
  • Evidence: [obs EV-084][obs EV-085][obs EV-102][obs EV-103][obs EV-121][net EV-099][net EV-112]
  • Feature: F-016, F-017 · Screen: S-002
-

R-036 Picking a country in a Phone field changes the user's profile country

-
  • Given an empty Phone field; its flag defaults to the user's profile country (a country other than Brazil in this account)
  • When the user picks Brazil in the flag menu and types a number
  • Then the number takes the Brazilian mask, (11) 90000-0000, and is saved as +55 11 90000 0000; the pick also sends PUT /user/v1/user with the new country, so every empty Phone field on every task now defaults to Brazil; picking the original country again on another task, with no number typed, sends the same request and restores the default
  • Evidence: [obs EV-104][obs EV-105][obs EV-130][obs EV-131]
  • Feature: F-017 · Screen: S-002
-

R-037 On Free Forever each value written counts once against 60 uses per workspace

-
  • Given Free Forever with no values yet
  • When 17 fields get one value each, and Labels gets two labels added one at a time
  • Then the entitlement counter reads 18 used of 60 (usage, limit, usageLeft); linking a task through a Tasks field and configuring a Formula field did not change it; the counter is fetched again after each value is set
  • Evidence: [net EV-112][doc SRC-005]
  • Feature: F-022 · Screen: S-002
  • Not observed: what happens at 60, and whether deleting a field gives uses back (Q-008). The docs say Formula values count as uses (SRC-043); here they did not (Q-009).
-

R-038 A Formula field is defined once per field and takes the money format of a money input

-
  • Given Number 1.234,5 and Money R$ 1.234,56 on a task
  • When the user opens the empty Formula value, picks Number, +, Money and clicks Calculate
  • Then the task and the card show R$ 2.469,06; the formula is saved on the field definition (PUT /customFields/v2/field/:id with type_config.formula, simple: true, calculation_state: "ready"), so every task in the location computes it, and tasks without inputs show R$ 0; the editor asks "Select a second field to calculate" until both inputs are set
  • Evidence: [obs EV-115][obs EV-116][obs EV-120][net EV-112]
  • Feature: F-016, F-017 · Screen: S-002
-

R-039 Tasks and Relationship fields live in the Relate menu, not in the Fields section

-
  • Given a Tasks field and a Relationship field on the list
  • When the user opens "Relate items or add dependencies"
  • Then both fields appear under the dependency options; picking the Tasks field and a task adds a Related section with one tab per field ("[RE] cf-tasks 1") and a table (Name, Due date, Priority); the board card shows the linked task as a chip with a + button, and an empty one shows "Add task"
  • Evidence: [obs EV-118][obs EV-119][obs EV-120][obs EV-121][net EV-112]
  • Feature: F-016, F-017, F-018 · Screen: S-002
-

R-040 A Relationship field must point at another list

-
  • Given the Relationship field form
  • When the user chooses "tasks from a specific List"
  • Then a related list is required and the field's own list cannot be chosen; the form offers rollup fields from the related list
  • Evidence: [obs EV-093]
  • Feature: F-016 · Screen: S-003
-

R-041 Required and Pinned do nothing on Free Forever except point to an upgrade

-
  • Given the field's Permissions and settings on Free Forever
  • When the user clicks "Required in tasks", then "Pinned"
  • Then Required stays off with only a tooltip as feedback; Pinned opens "Upgrade to Business" (closed without choosing)
  • Evidence: [obs EV-082][obs EV-083][doc SRC-003]
  • Feature: F-019 · Screen: S-002
-

R-042 A required field blocks task creation where it is used (documented)

-
  • Given a Business workspace and a field set to "Required in tasks"
  • When a user creates a task in a location of that field without a value
  • Then the task cannot be created until the field has a value; the public API skips the check unless check_required_custom_fields is true; the task view always shows required fields, even empty
  • Evidence: [doc SRC-003][doc SRC-029][doc SRC-007]
  • Feature: F-019 · Screen: S-002
  • Not observed: plan (Business). Q-010.
-

R-043 The task view lists a location's fields in one Fields section

-
  • Given a task in a list with 22 fields
  • When the task opens
  • Then a "Fields" section under the description has one row per field (type icon, name, value) in name order, with search, expand and + in its header; "Hide N empty fields" collapses the empty rows; Tasks and Relationship fields are not listed there (R-039)
  • Evidence: [obs EV-100][obs EV-117][doc SRC-007]
  • Feature: F-015 · Screen: S-002
-

R-044 Each value saves on its own and adds an activity line

-
  • Given the Fields section
  • When the user sets a value (checkbox click, picker choice, text and blur, slider drag)
  • Then one request saves that value (POST /customFields/v1/task/:id/field/:id; DELETE on the same path clears it) and the activity log adds a line such as "You set [RE] cf-money to R$ 1.234,56", "You added [RE] lab 1 to [RE] cf-labels", "You signed on [RE] cf-signature"
  • Evidence: [obs EV-106][obs EV-117][net EV-112]
  • Feature: F-017 · Screen: S-002
-

R-045 Each type has its own editor in the Fields section

-
  • Given the Fields section
  • When the user clicks a value
  • Then the editor depends on the type: dropdown and labels open an option picker with search and colors; people a person picker with "Keep typing a full email to invite"; text area a large popover editor; manual progress a slider; rating clickable stars; voting a thumbs-up toggle; signature a pad with a typed or drawn mode; location a search with Google Places suggestions; formula a field-operator-field editor
  • Evidence: [obs EV-100][obs EV-106][obs EV-107][obs EV-108][obs EV-109][obs EV-110][obs EV-113][obs EV-115]
  • Feature: F-017 · Screen: S-002
-

R-046 Location values store the address and the coordinates

-
  • Given a Location field
  • When the user types a street and picks the suggestion
  • Then the value shows the formatted address ("Av. Paulista, São Paulo - SP, Brazil") and is saved with formatted_address, location {lat, lng} and place_id
  • Evidence: [obs EV-113][obs EV-114][net EV-112]
  • Feature: F-017 · Screen: S-002
-

R-047 A typed signature is drawn in a script font and records who signed

-
  • Given a Signature field
  • When the user types a name in Type mode and clicks Save
  • Then the value shows the name in a script font in the task and on the card; the request carries value_options {isTyped, signedBy}; the activity says "You signed on <field>"
  • Evidence: [obs EV-110][obs EV-111][obs EV-121][net EV-112]
  • Feature: F-017 · Screen: S-002
-

R-048 On a card every shown custom field takes its own row with the type icon

-
  • Given all 22 fields turned on in Customize > Fields
  • When the board renders
  • Then each card gets one row per field, icon at the left, even with Stack fields off; empty values show "-", except Formula ("R$ 0"), Checkbox (empty box), Rating (grey stars), Voting (0), Progress (empty bar, 0) and Tasks or Relationship ("Add task"); filled values keep their task-view look, with text area cut to the first line plus an ellipsis and location cut at the card width; some values (rating, phone) appear a moment after the card
  • Evidence: [obs EV-120][obs EV-121][obs EV-123]
  • Feature: F-018 · Screen: S-001
-

R-049 Custom field values can be edited on the card

-
  • Given a card showing a dropdown value
  • When the user clicks the value
  • Then the same option picker as in the task view opens on the card; hovering the field icon shows the field name and "Custom Field"
  • Evidence: [obs EV-122]
  • Feature: F-018 · Screen: S-001
-

R-050 Showing custom fields on cards is a view draft

-
  • Given a board view saved without custom fields
  • When the user turns fields on in Customize > Fields
  • Then "Save view" appears; after a reload without saving, the cards show no custom fields again
  • Evidence: [obs EV-123][obs EV-124]
  • Feature: F-018 · Screen: S-001
-

R-051 Deleting a field warns with the task count and sends it to Trash without Undo

-
  • Given a Dropdown field holding a value on one task
  • When the user opens the field settings from the row gear and clicks the delete icon
  • Then a dialog reads "This action will delete this Custom Field from 1 task. Admins are able to restore deleted fields from the Trash." (the count appears a moment after the dialog); Delete removes the row from the task at once and shows "Field deleted successfully" with no Undo
  • Evidence: [obs EV-125][obs EV-126][obs EV-127][doc SRC-004]
  • Feature: F-020 · Screen: S-002
-

R-052 Restoring a field from Trash brings its values back

-
  • Given the deleted field in Settings > Trash
  • When the user opens its menu and clicks Restore
  • Then the item leaves the Trash and the task shows the field again with its old value ([RE] opt A)
  • Evidence: [obs EV-128][obs EV-129]
  • Feature: F-020 · Screen: S-005
-

R-053 Trash holds deleted lists, tasks, tags and fields for 30 days

-
  • Given deleted items
  • When the user opens Settings > Trash
  • Then each item shows name, location, deleted on and deleted by, filtered to "Me" by default; a deleted list is one row (its tasks are not listed separately); a tag deleted from a picker is there too; the page says items are deleted forever after 30 days and offers "Clear all Trash"; each row offers Restore and Delete forever
  • Evidence: [obs EV-128][obs EV-133][obs EV-137][doc SRC-004]
  • Feature: F-020 · Screen: S-005
-

R-054 Deleting a list takes its list-level fields with it

-
  • Given 22 fields whose only location is a list
  • When the list is deleted ("54 tasks and templates within this List will be deleted. Additionally, automations will become inactive.")
  • Then the list goes to Trash with its tasks, and the Custom Field Manager shows no fields in All, Workspace Fields or Personal List
  • Evidence: [obs EV-132][obs EV-133][obs EV-134]
  • Feature: F-020, F-021 · Screen: S-003
-

R-055 The Custom Field Manager groups fields by type and lists their locations

-
  • Given 22 list-level fields
  • When the user opens Settings > Custom Field Manager
  • Then All Custom Fields shows one group per type with a count and a "Create <type> field" link, and columns Name, Type, Created by, Date Created, Location(s); the left side filters by Workspace Fields, Task Type Fields, Personal List, By Location and By Task Type
  • Evidence: [obs EV-098][obs EV-134][doc SRC-006]
  • Feature: F-021 · Screen: S-003
-

Rules: task view

R-020 Clicking a card opens the task at its own URL, over the board

-
  • Given the board
  • When the user clicks a card title
  • Then the task opens at /t/:team/:task in the user's layout (Full screen here), the page title becomes "<name> | #<task id>", and the board stays mounted underneath
  • Evidence: [obs EV-051][obs EV-050][net EV-053]
  • Feature: F-009 · Screen: S-002
-

R-021 The task layout is a personal preference shared by every task and workspace

-
  • Given the task view in Full screen
  • When the user clicks the Switch layout button
  • Then the layout cycles to Sidebar (board visible on the left, task on the right); the hover popover offers Modal, Full screen and Sidebar; the choice applies to the next task opened, also after a reload
  • Evidence: [obs EV-052][obs EV-074][obs EV-075][obs EV-078][doc SRC-016]
  • Feature: F-009 · Screen: S-002
-

R-022 The header arrows step through tasks in the board's order

-
  • Given a task opened from the board
  • When the user clicks ↓
  • Then the next card's task opens ([RE] typical → [RE] overdue), without closing the view
  • Evidence: [obs EV-059]
  • Feature: F-009 · Screen: S-002
-

R-023 The status picker groups statuses by type

-
  • Given a list with to do, in progress, [re] review and complete
  • When the user opens the status pill
  • Then the picker shows Not started (to do), Active (in progress, [re] review) and Closed (complete), with search
  • Evidence: [obs EV-054][net EV-053]
  • Feature: F-009 · Screen: S-002
-

R-024 The next-status arrow moves a task one status forward

-
  • Given a task in TO DO
  • When the user clicks ▸ beside the status pill
  • Then the status becomes IN PROGRESS, a toast offers Undo ⌘Z, and the activity log adds "You changed status from To Do to In Progress"
  • Evidence: [obs EV-073][net EV-014]
  • Feature: F-009 · Screen: S-002
-

R-025 The description saves while typing, and "- " starts a bullet list

-
  • Given an empty description
  • When the user types a line, Enter, "- first item", Enter, "second item", then clicks away
  • Then the lines become a paragraph and a two-item bullet list; no Save button exists; after a reload the text is still there; **bold** typed in one go stays literal
  • Evidence: [obs EV-055][obs EV-078]
  • Feature: F-010 · Screen: S-002
-

R-026 A comment posts to the activity stream; the composer stays empty for the next

-
  • Given the activity sidebar
  • When the user types a comment and clicks send
  • Then the comment appears with author, "Just now", reactions and Reply; the request carries the text blocks and the followers
  • Evidence: [obs EV-057][net EV-058]
  • Feature: F-014 · Screen: S-002
-

R-027 Opening and using a task marks it as viewed

-
  • Given any task
  • When the user opens it and acts in it
  • Then the client sends PUT /task-v3/core/:id/tasks/:id/viewed with an empty body
  • Evidence: [net EV-058]
  • Feature: F-009 · Screen: S-002
-

R-028 Subtasks are created inline and show as a table with a progress count

-
  • Given a task without subtasks
  • When the user clicks Add subtask and enters two names
  • Then a Subtasks section shows "2 open", a progress bar and a table (Name, Assignee, Priority); the header gets a subtask count; the board card shows "2 subtasks"
  • Evidence: [obs EV-061][obs EV-062][obs EV-070][net EV-063]
  • Feature: F-011 · Screen: S-002
-

R-029 A dependency shows on both tasks and on both cards

-
  • Given two tasks
  • When the user sets "This task is blocked by" the other
  • Then the blocked task shows "Blocked by <task>" under its fields and a Dependencies tab; the other shows "Blocking <task>"; their cards show a yellow warning 1 and a red blocking 1
  • Evidence: [obs EV-065][obs EV-066][obs EV-070][net EV-069]
  • Feature: F-013 · Screen: S-002
-

R-030 Create checklist creates an empty checklist at once

-
  • Given a task
  • When the user clicks Create checklist
  • Then a checklist named "Checklist" is saved immediately with its name in edit mode; items added with Enter save one by one
  • Evidence: [obs EV-067][net EV-069]
  • Feature: F-012 · Screen: S-002
-

R-031 Resolved checklist items hide behind "Show completed" and update counts

-
  • Given a checklist with 3 open items
  • When the user resolves one
  • Then the section reads "2 open", the item moves under "Show 1 completed", the header count reads 2, and the card shows 1/3
  • Evidence: [obs EV-072][obs EV-073][obs EV-074]
  • Feature: F-012 · Screen: S-002
-

R-032 Escape in an empty inline input closes the task view

-
  • Given the checklist item input open and empty
  • When the user presses Escape
  • Then the task view closes and the board shows again
  • Evidence: [obs EV-068]
  • Feature: F-009 · Screen: S-002
-

06

Data model

The entities behind the screens: fields, types, relations and who may do what.

E-001 Workspace

Product term: Workspace (API: team) · Parent: none · Status: reviewed

+

Variants

+
VariantDifferenceEvidence
Small / Medium / LargeColumn width 200 / 264 / 328 CSS px; card 246 px wide at Medium[obs EV-046][obs EV-035]
Stack fields onEach filled field on its own row with an icon[obs EV-023]
Show empty fields offEmpty field placeholders hidden; an empty card shows only its title[obs EV-023]
Closed taskSame card in the closed column[obs EV-012]
+

States

+
StateVisual changeEvidence
DefaultBackground rgb(25,25,25), radius 10px, hairline white shadow[obs EV-035]
HoverHover toolbar appears top right; field tooltips ("Priority", "Dates")[obs EV-013][obs EV-010]
FocusField toggle gets a white 1px ring and dark 3px halo; title link no ring[obs EV-033]
PressedNot observed
SelectedCheckbox square at top right, filled white[obs EV-028]
DisabledNot observed
LoadingSkeleton block the size of a card[obs EV-018]
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Width (Medium)246 px inside a 264 px column[obs EV-035]
Min height72 px (title and one field row)[obs EV-035]
Backgroundrgb(25,25,25)--cu-background-subtle[obs EV-035]
Radius10px[obs EV-035]
Shadowrgba(255,255,255,.333) 0 0 1px, rgba(0,0,0,.055) 0 1px 2px[obs EV-035]
Title type14px/20px, weight 500, rgb(238,238,238)--cu-content-default[obs EV-035]
Field toggle24×24, radius 6px, 1px border rgb(34,34,34)--cu-border-low-contrast[obs EV-035]
Overdue date textrgb(255,133,137)--cu-content-danger[obs EV-035][obs EV-010]
Due today textrgb(255,204,77)--cu-content-warning[obs EV-035][obs EV-010]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
linktask nameEnter opensno outline[obs EV-034]
button (toolbar)"Mark complete", "Rename", More named by data-test; Add subtask unnamedTab reaches them even without hovernot checked[obs EV-034]
div[tabindex=0] field togglesnoneTabyes[obs EV-033][obs EV-034]
+

Not tested

+
  • Cover image (no attachment fixture), subtasks expander, task property icons with real content, pressed state.
+
EV-015 Column menu (Group options) on a column with tasks: Collapse, Archive all, Automate status, Select all, Rename, Edit statuses
C-002

Board column

Product namecu3-board-group with cu3-board-group-headerUsed inS-001Statusreviewed

Variants

EmptyCollapsedNon-status groupingSwimlane cell

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Group options menu: Collapse group, Archive all in this group, Automate status, Select all, Rename, Edit statuses. Archive all and Select all appear only when the column has tasks (R-009) [obs EV-015][obs EV-016].
  • Columns are not draggable on the board [inf] Q-003.
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1HeaderStatus pill (icon by status type, uppercase name) and count; header background tinted with the status color[obs EV-012][obs EV-035]
2Header hover actionsCollapse (‹), More (Group options), + (add task at the top)[obs EV-015]
3WIP slotcu3-board-grouping-header-wip present in the DOM; limits need Business[obs EV-011][doc SRC-011]
4Card listVirtualized list (cdk-virtual-scroll-viewport) of C-001[obs EV-011]
5Footer"+ Add Task" in the status color[obs EV-012]
+

Variants

+
VariantDifferenceEvidence
EmptyOnly "+ Add Task"[obs EV-002]
CollapsedVertical strip, rotated name, count[obs EV-017]
Non-status groupingHeader shows the value (flag + "High"); "No priority" column for empty values[obs EV-026]
Swimlane cellSame column per row of the subgroup[obs EV-027]
+

States

+
StateVisual changeEvidence
DefaultPill + count[obs EV-012]
HoverActions appear on the header[obs EV-015]
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingHeader skeleton[obs EV-018]
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Width264 px (Medium), 200 (Small), 328 (Large)[obs EV-046]
Header40 px high, 8px padding[obs EV-035]
Status pill20 px high, radius 6px, 11px/500 text, padding 2 6 2 4[obs EV-035]
Gap between columnsabout 8 px[obs EV-012]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
list items (li) per columnstatus name in data-test onlynot checkednot checked[obs EV-011]
+

Not tested

+
  • Rename, Edit statuses, Automate status and Archive all (not clicked).
+
EV-019 Customize view side panel: name, More options, Fields, Filter, Group, Sort, Subtasks, Templates, view toggles (autosave, pin, private, protect, default), sharing
C-003

Customize view panel

Product nameCustomize view side panel (cu-view-setting-toggle)Used inS-001Statusreviewed

Variants

Card size dropdownCard cover dropdown

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Every change re-renders the board and shows "Save view"; nothing persists until saved; a reload drops it (R-008) [obs EV-017][net EV-014].
  • The Fields page lists workspace fields that the Custom Field Manager does not show (B-008) [obs EV-044][obs EV-045].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Header"Customize view", close[obs EV-019]
2NameView icon and name field ("Board")[obs EV-019]
3More options (inline)Card size, Card cover, Stack fields, Show empty fields, Collapse empty columns, More options ›[obs EV-020]
4Settings listFields (n shown), Filter, Group, Sort, Subtasks, Templates[obs EV-019]
5View togglesAutosave for me, Pin view, Private view, Protect view, Set as default view[obs EV-019]
6SharingCopy link to view, Favorite ›, Sharing & Permissions[obs EV-019]
7Layout options pagePage and card layout: Card size, Card cover, Stack fields, Show task properties, Show empty fields, Show task locations, Show subtask parent names, Collapse empty columns, Show column colors. Task visibility: Show closed tasks, Show closed subtasks, Show tasks from other Lists, Show subtasks from other Lists. View settings: Default to Me Mode, Duplicate view, Reset view to defaults, Default view settings[obs EV-022]
8Fields pageSearch, Create new / Add existing tabs; Shown (Task Name locked, Assignee, Dates, Priority, Tags); Properties (Date closed, Date created, Date updated, Status, Task ID, Task Type, Time tracked); Custom Fields in Workspace[obs EV-043][obs EV-044]
+

Variants

+
VariantDifferenceEvidence
Card size dropdownSmall, Medium (default), Large[obs EV-020]
Card cover dropdownAuto, None, Image (default), Task description[obs EV-021]
+

States

+
StateVisual changeEvidence
DefaultToggles off except Show empty fields, Show task properties, Show subtask parent names, Show column colors, tasks/subtasks from other Lists[obs EV-022]
HoverRow highlight; tooltip on Stack fields: "Display standard fields as stacked or inline"[obs EV-023]
FocusNot checked
PressedNot observed
SelectedCheckmark on the chosen dropdown value[obs EV-020]
Disabled"Show closed tasks" greyed while grouped by status[obs EV-022]
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Panel widthabout 270 px at 1456 px screenshot width (about 320 CSS px)[obs EV-019]
Toggle on colorbrand purple[obs EV-022]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
togglesrow label (view-setting-toggle__label)not checkednot checked[obs EV-011]
+

Not tested

+
  • Save view, Autosave, Pin, Private, Protect, Set as default, Duplicate, Reset, Templates, Sharing.
+
EV-008 Date picker opened from a card: start and due inputs, quick options, month grid, Set Recurring
C-004

Date picker

Product namecu-recurring-date-dropdownUsed inS-001, S-002Statusreviewed

Variants

Opens upward

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Opening it loads the workspace work schedule and schedule exceptions [net EV-014].
  • Picking a start date moves focus to the due date input [obs EV-009].
  • The value is saved when the picker closes, not when a day is clicked (R-005) [net EV-014].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Inputs"Start date" and "Due date", each with clear (×) and "Add time" once set[obs EV-008][obs EV-009]
2Quick optionsToday, Later (a time later today), Tomorrow, This weekend, Next week (Monday), Next weekend, 2 weeks, 4 weeks; each shows the resolved day[obs EV-008]
3Month gridMonth and year, "Today", previous and next; weeks start on Monday; today in a red circle; range highlighted[obs EV-009]
4Set Recurring ›Recurrence submenu[obs EV-008]
5Work schedule banner"Set up your work schedule", dismissible[obs EV-008]
+

Variants

+
VariantDifferenceEvidence
Opens upwardWhen there is no room below the card[obs EV-009]
+

States

+
StateVisual changeEvidence
DefaultDue date input focused[obs EV-008]
HoverQuick option row highlight[obs EV-009]
FocusFocused input has a white border[obs EV-008]
PressedNot observed
SelectedChosen day boxed; start-to-due range shaded[obs EV-009]
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Sizeabout 410 × 310 px (screenshot scale)[obs EV-008]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
inputsplaceholders "Start date", "Due date"Escape closes and savesyes[obs EV-008][net EV-014]
+

Not tested

+
  • Typing a date as text, times, recurrence, work schedule setup.
+
EV-006 Card hover toolbar and the priority picker opened from the card flag icon
C-005

Priority picker

Product namecu-priority-list-dropdownUsed inS-001, S-002Statusreviewed

Variants

Card chip after choice

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Choosing a value saves at once: PUT /tasks/v1/item with priority as a numeric string, "2" for High (R-017) [net EV-007].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Search"Search..."[obs EV-006]
2PriorityUrgent (red flag, ⌘1), High (yellow, ⌘2), Normal (blue, ⌘3), Low (grey, ⌘4), Clear (⌘0)[obs EV-006]
3Personal PrioritiesSection with the operator's personal priority list[obs EV-006]
4AI"Prioritize with AI"[obs EV-006]
+

Variants

+
VariantDifferenceEvidence
Card chip after choiceFlag in the priority color plus label ("High", "Low")[obs EV-010][obs EV-032]
+

States

+
StateVisual changeEvidence
DefaultFirst item highlighted[obs EV-006]
HoverRow highlight[obs EV-006]
FocusSearch focused[obs EV-006]
PressedNot observed
SelectedNot observed
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Urgent flagred (rgb 255,133,137 family)[obs EV-006]
High flagyellow (rgb 255,204,77 family)[obs EV-006]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
menu itemspriority names⌘1 to ⌘4, ⌘0 shownnot checked[obs EV-006]
+

Not tested

+
  • Keyboard shortcuts themselves, Personal Priorities, Prioritize with AI.
+
EV-028 Bulk action bar after Select all in a column: count, clear, Status, Assignees, Dates, Custom Fields (disabled with no fields), Tags, Move/Add, Convert to Subtask, Copy, duplicate, archive, delete, More
C-006

Bulk action bar

Product namebulk action toolbar (--cu-bulk-action-toolbar-inset-x)Used inS-001Statusreviewed

Variants

No custom fields in the list

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Opens after "Select all" in a column menu; selected cards show a filled checkbox at top right [obs EV-028].
  • No hover checkbox appeared on cards before a selection existed [obs EV-013].
  • × clears the selection and closes the bar [obs EV-028].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Count"1 Task selected" with × to clear[obs EV-028]
2ActionsStatus, Assignees, Dates, Custom Fields, Tags, Move/Add, Convert to Subtask, Copy, duplicate, archive, delete (red), More[obs EV-028]
+

Variants

+
VariantDifferenceEvidence
No custom fields in the list"Custom Fields" disabled[obs EV-028]
+

States

+
StateVisual changeEvidence
DefaultFloating bar at the bottom center[obs EV-028]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledGreyed action[obs EV-028]
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Inset34px--cu-bulk-action-toolbar-inset-x[obs EV-035]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
buttonslabels as shown; icon-only buttons not checkednot checkednot checked[obs EV-028]
+

Not tested

+
  • Any bulk action, More menu contents, shift-click range selection.
+
EV-029 Inline create form inside a column: Task Name, Save (disabled while empty), Add assignee, Add dates, Add priority, Add tag
C-007

Inline task create form

Product nameboard quick create cardUsed inS-001Statusreviewed

Variants

Column footer "+ Add Task"Header +

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Enter with an empty name does nothing and shows no message [obs EV-029].
  • Enter with a name creates the task with the column's status, keeps the form open for the next task and shows a "Task created" toast (R-010) [obs EV-030].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Name inputPlaceholder "Task Name..."[obs EV-029]
2Save"Save ↵", disabled while the name is empty[obs EV-029]
3Field shortcutsAdd assignee, Add dates, Add priority, Add tag[obs EV-029]
+

Variants

+
VariantDifferenceEvidence
Column footer "+ Add Task"Form opens at the end of the column[obs EV-029]
Header +Form opens at the top of the column[obs EV-015]
+

States

+
StateVisual changeEvidence
DefaultWhite border around the form[obs EV-029]
HoverNot checked
FocusInput focused on open[obs EV-029]
PressedNot observed
SelectedNot applicable
DisabledSave disabled when empty[obs EV-029]
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthcard width[obs EV-029]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
textboxplaceholder onlyEnter saves, Escape closesyes[obs EV-029]
+

Not tested

+
  • Field shortcuts inside the form, pasting several lines.
+
EV-030 After creating in IN PROGRESS: card at the top of the column with that status, form reopened below, toast Task created with Pin to bottom, Copy URL, View task
C-008

Toast

Product namecu-toast-newUsed inS-001, S-002Statusreviewed

Variants

Task createdStatus changedPriorities promptOffline mode

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Several toasts stack; each disappears after a few seconds [obs EV-030].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Icon and titleGreen check and "Task created", or "Status changed"[obs EV-030][obs EV-012]
2BodyTask name "in" list link[obs EV-030]
3ActionsButtons with a number or key hint: "Pin to bottom 3", "Copy URL 2", "View task 1"; "Undo ⌘Z"[obs EV-030][obs EV-012]
+

Variants

+
VariantDifferenceEvidence
Task createdThree actions with digit shortcuts[obs EV-030]
Status changedUndo with ⌘Z[obs EV-012]
Priorities prompt"Don't ask again ⌥1", "Add to priorities ⌥2"[obs EV-042]
Offline mode"You can still track time and create tasks and reminders! Access any task in your tray."[obs EV-019]
+

States

+
StateVisual changeEvidence
DefaultBottom left over the sidebar, stacked when several[obs EV-030]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthabout 270 px at screenshot scale[obs EV-030]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
buttonslabelsdigit and ⌘Z hints shown; not pressednot checked[obs EV-030]
+

Not tested

+
  • The digit shortcuts and Undo itself; the exact timeout.
+
EV-041 Assignee picker on a card: Search or enter email, Me (avatar masked), Assign with AI
C-009

Assignee picker

Product namecu-user-list-dropdownUsed inS-001, S-002Statusreviewed

Variants

Single-member workspace

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Picking "Me" saves at once (PUT /tasks/v1/task/:id with assignees.add) and then shows a prompt to add the task to the user's priorities (R-007) [net EV-014][obs EV-042].
  • Typing an email would invite a person (A5): not done.
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Search"Search or enter email..."[obs EV-041]
2People"Me" first (avatar), then members[obs EV-041]
3AI"Assign with AI"[obs EV-041]
+

Variants

+
VariantDifferenceEvidence
Single-member workspaceOnly "Me"[obs EV-041]
+

States

+
StateVisual changeEvidence
DefaultList of people[obs EV-041]
HoverRow highlight[obs EV-041]
FocusNot checked
PressedNot observed
SelectedAvatar shown on the card[obs EV-012]
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthabout 240 px at screenshot scale[obs EV-041]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
listnot checkednot checkednot checked
+

Not tested

+
  • Teams, other members, invite by email (needs a second account: L1).
+
EV-040 Tag picker on a card with a new name typed: Select an option, Create <name>, settings gear
C-010

Tag picker

Product namecu-tags-listUsed inS-001, S-002Statusreviewed

Variants

Card chip

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Tags are created at Space level and applied to the task in one request when the picker closes (R-006) [net EV-014].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1InputTag search; applied tags show as removable pills inside it[obs EV-040]
2Options"Select an option" header, matching tags, "Create <name> ↵" when no tag matches[obs EV-040]
3SettingsGear to manage tags[obs EV-040]
+

Variants

+
VariantDifferenceEvidence
Card chipGrey pill with the tag name ("[re] tag-a")[obs EV-012]
+

States

+
StateVisual changeEvidence
DefaultInput focused[obs EV-040]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedPill in the input[obs EV-040]
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
New tag colorstag_fg and tag_bg hex colors chosen by the product[net EV-014]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
inputnot checkedEnter createsnot checked[obs EV-040]
+

Not tested

+
  • Tag colors, tag manager, removing a tag.
+
EV-051 Task view (Full screen) annotated: 1 header, 2 hero (type, title, AI bar), 3 fields grid, 4 description, 5 sections (fields, subtasks, relations, checklist, attachments), 6 activity sidebar with comment box
C-011

Task fields grid

Product namecu-task-fields-containerUsed inS-002Statusreviewed

Variants

Empty taskWith dependency

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Each value opens the same pickers as the board card (C-004, C-005, C-009, C-010) [obs EV-051].
  • The ✓ completes the task; ▸ moves to the next status (R-024) [obs EV-073].
  • A browser-stored preference hides empty fields (cu-task-view-hide-empty-location-fields in localStorage) [obs EV-011].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1StatusStatus pill, next-status arrow ▸, complete ✓[obs EV-073]
2DatesStart → Due; overdue due date in red[obs EV-059]
3Track timeStart timer[obs EV-051]
4AssigneesAvatars; Empty when none[obs EV-051]
5PriorityFlag and label; Empty when none[obs EV-051]
6TagsTag pills; Empty when none[obs EV-051]
7Dependency rowsBlocked by / Blocking with the other task[obs EV-065][obs EV-066]
8Collapse empty fieldsLink that hides empty properties[obs EV-073]
+

Variants

+
VariantDifferenceEvidence
Empty taskPlaceholders Start, Due, Empty[obs EV-059]
With dependencyExtra row under the grid[obs EV-065]
+

States

+
StateVisual changeEvidence
DefaultLabel column with icons, value column[obs EV-051]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedNot applicable
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Layouttwo columns of label + value[obs EV-051]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
buttonslabel icons per field (task-field-label-icon__container-<Field>)not checkednot checked[obs EV-050]
+

Not tested

+
  • Time tracking, Collapse empty fields toggle (browser preference), assignee change in the task view.
+
EV-055 Description editor: '- ' turned into a bullet list; **bold** typed inline stayed literal; history and full-screen icons
C-012

Description editor

Product namecu-task-editor (Quill)Used inS-002Statusreviewed

Variants

EmptyFilled

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Saves without a button through the collaborative editor connection; the task detail response carries an editor_token [net EV-053][obs EV-078].
  • "- " at the start of a line makes a bullet list; **bold** typed in one go is not converted (R-025) [obs EV-055].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Text areaRich text with markdown shortcuts[obs EV-055]
2PlaceholderAdd description, or write with AI[obs EV-051]
3ActionsDescription history, full screen[obs EV-055][obs EV-050]
+

Variants

+
VariantDifferenceEvidence
EmptyPlaceholder with AI link[obs EV-051]
FilledParagraphs and lists[obs EV-078]
+

States

+
StateVisual changeEvidence
DefaultPlain text[obs EV-078]
HoverNot checked
FocusCaret, toolbar on selection[obs EV-055]
PressedNot observed
SelectedNot checked
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widththe content column[obs EV-051]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
textbox (contenteditable)not checkedEnter new linecaret[obs EV-055]
+

Not tested

+
  • Toolbar formats, slash commands, AI writing, image paste, description history, concurrent editing.
+
EV-062 Subtasks section after two creates: 2 open with progress bar, table Name/Assignee/Priority, Add Task row; subtask count in the header; activity lines
C-013

Subtasks section

Product namecu-task-view-subtasks-sectionUsed inS-002Statusreviewed

Variants

Before first subtask

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Enter creates the subtask and keeps the input open; each create is one request with parent set (R-028) [net EV-063].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1HeaderSubtasks, N open, progress bar; Sort, expand, Suggest (AI), +[obs EV-062]
2TableName with status circle, Assignee, Priority, add column[obs EV-062]
3Add Task rowInline create[obs EV-062]
+

Variants

+
VariantDifferenceEvidence
Before first subtaskSingle input under the header[obs EV-061]
+

States

+
StateVisual changeEvidence
DefaultTable[obs EV-062]
HoverNot checked
FocusInput focused after Add subtask[obs EV-061]
PressedNot observed
SelectedRow checkbox column[obs EV-062]
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Row heightabout 30 px[obs EV-062]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
table rowsnot checkedEnter createsnot checked[obs EV-061]
+

Not tested

+
  • Sort, Suggest (AI), nested subtasks, subtask status changes, converting a subtask.
+
EV-071 Checklists section: 3 open with progress bar, named checklist, items with circles, Add item, Add checklist; activity aggregates 'added 3 items'; header checklist count
C-014

Checklist

Product namecu-task-view-checklists-sectionUsed inS-002Statusreviewed

Variants

New

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Create checklist saves an empty checklist at once (R-030); items save one request each; items have uuid IDs and can nest (children) and carry an assignee and dates [net EV-069].
  • Resolved items collapse under Show completed (R-031) [obs EV-072].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1HeaderChecklists, N open, progress bar; expand, +[obs EV-071]
2ChecklistEditable name, items with circles, Add item[obs EV-071]
3FooterShow N completed, Add checklist[obs EV-072]
4Item hoverDrag handle; actions (assign, convert, More)[obs EV-072]
+

Variants

+
VariantDifferenceEvidence
NewName 'Checklist' in edit mode[obs EV-067]
+

States

+
StateVisual changeEvidence
DefaultOpen items listed[obs EV-071]
HoverItem actions[obs EV-072]
FocusNot checked
PressedNot observed
SelectedResolved items hidden[obs EV-072]
DisabledNot observed
LoadingSkeleton while created[obs EV-067]
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Item rowabout 30 px[obs EV-071]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
itemsnot checkedEnter adds, Escape on empty closes the task viewnot checked[obs EV-068]
+

Not tested

+
  • Item assignee and dates, nesting, reordering, deleting a checklist, converting an item to a task.
+
EV-065 Blocked task after adding a dependency: Blocked by row under the fields (warning icon), relation count in the header, Related/Dependencies tabs with a Blocked by table
C-015

Relationships section

Product namecu-task-view-relationships-sectionUsed inS-002Statusreviewed

Variants

Blocked sideBlocking side

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • The Relate menu offers Relate a Task or Doc, This task blocks..., This task is blocked by..., New custom relationship [obs EV-064].
  • Picking a task from search creates the dependency in one request (task_id, depends_on; the response has type and lag_ms) (R-029) [net EV-069].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1TabsRelated, Dependencies with count[obs EV-065]
2Dependencies tableGroup Blocked by N; Name, Due date, Priority, assignee[obs EV-065]
3Related empty stateNo tasks or docs related. Relate[obs EV-066]
+

Variants

+
VariantDifferenceEvidence
Blocked sideWarning icon, Blocked by[obs EV-065]
Blocking sideRed icon, Blocking[obs EV-066]
+

States

+
StateVisual changeEvidence
DefaultTabs and table[obs EV-065]
HoverNot checked
FocusNot checked
PressedNot observed
SelectedActive tab underlined[obs EV-065]
DisabledNot observed
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Tabunderline indicator[obs EV-065]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
tabs (role tab)Related, Dependenciesnot checkednot checked[obs EV-050]
+

Not tested

+
  • Plain task links, custom relationships, removing a dependency, closing a blocked task (dependency warning).
+
EV-057 Posted comment in the activity stream (author masked), Just now, reactions, Reply; composer placeholder changes
C-016

Activity and comments

Product namecu-task-view-right-sidebarUsed inS-002Statusreviewed

Variants

Modal layoutSidebar layout

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • History is read in pages from tasks/history; comments come from a separate comment service [net EV-053][net EV-058].
  • Several item creations aggregate into one line ("added 3 items") [obs EV-071].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1HeaderActivity, search, follower count, filter[obs EV-051]
2History linesYou <did> … with relative time; Show more folds older lines[obs EV-051][obs EV-073]
3Comment cardAuthor, time, text, reactions, Reply[obs EV-057]
4ComposerText, toolbar (add, AI, attach, mention, assign, emoji, clip, task, doc), send with menu[obs EV-056]
+

Variants

+
VariantDifferenceEvidence
Modal layoutSidebar inside the modal[obs EV-075]
Sidebar layoutCollapsed to icons[obs EV-074]
+

States

+
StateVisual changeEvidence
DefaultHistory only[obs EV-051]
HoverNot checked
FocusComposer focused[obs EV-056]
PressedNot observed
SelectedNot applicable
DisabledSend disabled while empty[obs EV-051]
LoadingEmpty list until history loads[obs EV-051]
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthabout 560 CSS px[obs EV-050]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
textboxplaceholder onlynot checkednot checked[obs EV-056]
+

Not tested

+
  • Mentions, assigned comments, threads, reactions, attachments in comments, activity filters and search.
+
EV-117 Task view with every field filled; activity log has one line per field change (people line masked)
C-017

Task Fields section

Product namecu-task-view-custom-fields-sectionUsed inS-002Statusreviewed

Variants

All filledMostly empty

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Rows are sorted by name and include every field of the task's locations; Tasks and Relationship fields are not here, they live in the Related section (R-039, R-043) [obs EV-117][obs EV-118].
  • Every value saves on its own; there is no Save button (R-044) [net EV-112].
  • The gear opens the field settings popover (C-018) for that field, from which the field can be deleted (R-051) [obs EV-125].
  • Escape inside the task view closes the whole view (R-032), so editors are closed by clicking outside [obs EV-068].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1HeaderCollapse arrow, "Fields", then search, expand and + (add field)[obs EV-117]
2Row labelType icon and field name; on hover a pin-off icon at the left and a gear (field settings) at the right[obs EV-102][obs EV-117]
3Row valueThe value as rendered by its type (C-019), "–" when empty; on hover a clear × at the far right[obs EV-103][obs EV-117]
4Footer"Hide N empty fields" / show toggle[obs EV-117]
5Add fields popover (from +)Search for new or existing fields, tabs Create new and Add existing, Popular and All type lists[obs EV-079]
+

Variants

+
VariantDifferenceEvidence
All filledNo empty rows; the footer counts only the empty ones left[obs EV-117]
Mostly emptyRows show "–"; empty rows stay listed until hidden with the footer link[obs EV-100]
+

States

+
StateVisual changeEvidence
DefaultLabel column and value column, one row per field[obs EV-117]
HoverRow highlight, gear and clear icons[obs EV-102]
FocusThe value becomes an input or opens a picker or popover[obs EV-102][obs EV-108]
PressedNot observed
SelectedNot applicable
DisabledFormula values are grey and read-only[obs EV-116]
LoadingFormula showed empty for a moment after the task opened[obs EV-129]
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Layouttwo columns, label about one quarter of the width[obs EV-117]
Row heightabout 30 screenshot px; text area rows grow with the lines[obs EV-117]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
button"Set value for <field> Custom Field"not checkednot checked[obs EV-139]
+

Not tested

+
  • Keyboard entry into rows, the search and expand icons, drag order, Add existing.
  • How required, pinned and task-type fields are grouped (plan-gated).
+
EV-080 Create Dropdown form: type switcher, Field name, Dropdown options with color dots, Set default, delete, Add option, AI option generator, AI Autofill, Permissions and settings, Cancel, Create
C-018

Custom field form

Product namefield create and edit popoverUsed inS-002, S-003Statusreviewed

Variants

Create from a taskCreate from the managerEdit from the row gear

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Create sends the definition and then its location (R-033) [net EV-099].
  • Required in tasks does not turn on and Pinned opens an upgrade dialog on Free Forever (R-041) [obs EV-082][obs EV-083].
  • The delete icon asks for confirmation and moves the field to Trash (R-051) [obs EV-126].
Full component notes anatomy, options per type, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Type switcherCurrent type with a menu to change it; "Advanced" (gear) on edit[obs EV-080][obs EV-125]
2Field nameRequired; emoji picker at the left[obs EV-080][obs EV-125]
3Type optionsPer type, see the table below[obs EV-084] to [obs EV-094]
4AI Autofill"Automatically assign Dropdown values", Off by default[obs EV-080][obs EV-125]
5Permissions and settingsDescription, Permissions (Workspace default), Exceptions (creator can edit), Required in tasks, Pinned, Visible to Guests and Limited Members (on), "Belongs to" with the location[obs EV-081]
6FooterCreate or Save (disabled until valid), Cancel; on edit a red delete icon at the left[obs EV-080][obs EV-125]
+

Options per type

+
TypeOptions in the formEvidence
DropdownOptions with color dots, Set default, delete per option, Add option, AI option generator, sort Manual[obs EV-080][obs EV-125]
LabelsSame as Dropdown; Create stays disabled until one option exists[obs EV-092]
NumberNumber format US (1,234.56) or EU (1.234,56)[obs EV-084]
MoneyCurrency (BRL - Brazilian Real (R$) chosen), number format[obs EV-085]
VotingEmoji type, "Hide users who have voted"[obs EV-086]
TasksRelationship name, related to any task in the workspace or to tasks from one List, Create rollup fields[obs EV-087]
RelationshipTasks from a specific List (required; the field's own list not offered), rollup fields from it[obs EV-093]
PeopleShow people from the entire workspace, show guests, select multiple people (on), include teams[obs EV-088]
RatingEmoji type (star), scale 1 to 5 (default 3)[obs EV-089]
Progress (Auto)Track completion of subtasks, checklists, assigned comments; tasks without action items show 100% when done[obs EV-090]
Progress (Manual)Start value 0, end value 100[obs EV-091]
ButtonName, button label and color; "Action required: Add automation"[obs EV-094]
AI SummaryA Text area preset with AI Autofill on and a prompt[obs EV-095]
+

Variants

+
VariantDifferenceEvidence
Create from a taskOpens over the task; location defaults to the task's list[obs EV-080][obs EV-081]
Create from the managerOpens over the manager after choosing a type[obs EV-086]
Edit from the row gearSame form with Save, Advanced and the delete icon[obs EV-125]
+

States

+
StateVisual changeEvidence
DefaultFooter button disabled until required parts are filled[obs EV-092][obs EV-125]
HoverNot checked
FocusName input focused on open[obs EV-080]
PressedNot observed
SelectedNot applicable
DisabledRequired in tasks cannot be turned on (Free Forever)[obs EV-082]
LoadingNot observed
ErrorNot observed
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthabout 310 screenshot px popover[obs EV-125]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
dialognot checkednot checkednot checked
+

Not tested

+
  • Changing the type of an existing field (conversion rules are in SRC-045), Advanced settings, default values, permissions and exceptions with other people (needs L1).
  • AI option generator and AI Autofill (consume AI credits).
  • Button fields with an automation, Rollup fields.
+
EV-121 Card of [RE] all fields with every value: dropdown pill, text, textarea first line with ellipsis, number, money, date, checkbox, email, signature, voting, tasks chip with +, people (masked), rating, progress bars, labels, formula, phone, website, files dash, location truncated
C-019

Custom field value, by type

Product namevalue cell in the Fields section and the card field rowUsed inS-001, S-002Statusreviewed

How each of the 22 field types tested looks in the task view and on a board card, how it is edited and what it stores. Request shapes are in EV-112.

Variants

Task viewCard

States 8 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Values render the same way in the task and on the card, except text area (first line on the card), location (cut) and the relationship types (chips on the card, a Related tab in the task) [obs EV-117][obs EV-121].
  • Number and money formats come from the field, not from the user's language (R-035) [obs EV-084][obs EV-085].
Full component notes anatomy, rendering per type, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Type iconOne icon per type, at the left of the task row and of the card row[obs EV-117][obs EV-121]
2ValueRendered per type (table below)[obs EV-117][obs EV-121]
3Empty value"–" in the task view, "-" on cards, with the exceptions in the table[obs EV-100][obs EV-120]
+

Rendering per type

+
TypeTask view, filledEditorCard, emptyCard, filledStored valueEvidence
CheckboxPurple checked boxClickEmpty boxChecked boxboolean[obs EV-117][obs EV-120][obs EV-121][net EV-112]
DateRelative day ("Mon")Date picker-"Mon"epoch ms + time flag[obs EV-117][obs EV-121][net EV-112]
DropdownColored pill with ▾Picker: search, colored options, drag handles-Pill with ▾, editable in placeoption id[obs EV-100][obs EV-122][net EV-112]
LabelsColored pillsSame picker, several values-Pillsone add per label[obs EV-101][obs EV-121][net EV-112]
TextPlain textInline input-Textstring[obs EV-111][obs EV-121]
Text areaSeveral linesLarge popover editor-First line + "..."string, rich text copy[obs EV-108][obs EV-109][obs EV-121][net EV-112]
Number1.234,5 (field format EU)Inline input with clear ×-1.234,5string[obs EV-103][obs EV-121][net EV-112]
MoneyR$ 1.234,56 (BRL, EU); empty shows "R$"Inline input with mask-R$ 1.234,56string[obs EV-101][obs EV-102][obs EV-121]
EmailTextInline input-Textstring (email)[obs EV-117][obs EV-121]
Phone+55 11 90000 0000Flag menu + masked input; the flag writes the profile country (R-036)-Same text, shown a moment laterstring[obs EV-104][obs EV-105][obs EV-121]
WebsiteFavicon + domain onlyInline input-Favicon + domainstring (url)[obs EV-111][obs EV-121]
LocationFormatted addressSearch with Google Places suggestions-Address cut at card widthaddress, lat, lng, place id[obs EV-113][obs EV-114][obs EV-121][net EV-112]
PeopleAvatar (masked)Person picker, "Keep typing a full email to invite"-Avataruser ids add/rem[obs EV-106][obs EV-121][net EV-112]
Rating2 of 3 starsClick a starGrey starsStars, shown a moment laternumber[obs EV-111][obs EV-120][obs EV-121]
Voting👍 1Toggle own vote👍 0👍 1user ids add/rem[obs EV-109][obs EV-120][obs EV-121][net EV-112]
Progress (Manual)Slider with value 61Drag the knobSlider at 0Slider and 61{current}[obs EV-107][obs EV-120][obs EV-121][net EV-112]
Progress (Auto)Bar 0%Computed (subtasks, checklists, assigned comments)Bar 0%; 100% on a closed taskBar and percentcomputed[obs EV-090][obs EV-120]
SignatureTyped name in a script fontPad, Type or Draw, Clear, Save-Script namestring + isTyped, signedBy[obs EV-110][obs EV-111][obs EV-121][net EV-112]
FormulaGrey computed value, R$ 2.469,06Field, operator, field; Advanced EditorR$ 0R$ 2.469,06definition only (no per-task write)[obs EV-115][obs EV-116][obs EV-120][net EV-112]
Files"–"Not tested (upload)--not captured[obs EV-121]
TasksNot in Fields; Related tab with a tableRelate menu > field > task picker (Recent Tasks)"Add task"Task chip + "+"task ids add/rem[obs EV-118][obs EV-119][obs EV-121][net EV-112]
RelationshipNot in Fields; Related tabRelate menu > field"Add task""Add task" (target list empty)not captured[obs EV-118][obs EV-121]
+

Variants

+
VariantDifferenceEvidence
Task viewFull value, editor in place or in a popover[obs EV-117]
CardOne row per shown field, compact, cut to the card width[obs EV-121]
+

States

+
StateVisual changeEvidence
DefaultAs in the table[obs EV-117]
HoverCard: field name tooltip on the icon; task view: gear and clear icons[obs EV-122][obs EV-102]
FocusEditor opens[obs EV-102]
PressedNot observed
SelectedNot applicable
DisabledFormula is read-only[obs EV-116]
LoadingRating and phone appear on cards after the other rows[obs EV-121]
ErrorNot observed (no invalid email or URL tried)
+

Measurements and tokens

+
PropertyValueTokenEvidence
Card rowicon column plus value, about 24 screenshot px per row[obs EV-121]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
button"Set value for <field> Custom Field"not checkednot checked[obs EV-139]
+

Not tested

+
  • Files (upload), Button (needs an automation), Rollup, AI fields (Summary, Custom Text, Custom Dropdown, Categorize, Translation, Sentiment, Action Items, T-shirt Size; they spend AI credits).
  • Invalid input (bad email, bad URL, letters in Number), very long values, many labels or people on a card.
  • Drawn signatures, Relationship with linked tasks, Voting by several people.
+

05How it behaves

Business rules observed in the product, each with its evidence. They become the acceptance tests of the new product.

Board view 19 rules

R-001 The board shows one column per status of the list, empty ones included, in status order

Given
a list whose statuses are to do, in progress, complete
When
the board view opens with Group: Status
Then
three columns appear in that order, each with its count, even when empty, followed by "+ Add group"; the closed status is the last column
Evidence: [obs EV-002][obs EV-038][net EV-014]Feature: F-001 · Screen: S-001

R-002 Column counts include every task of the group; the sidebar list count leaves out closed tasks

Given
54 tasks, one of them in the closed status
When
the board and the sidebar render
Then
the columns read 53 and 1, and the sidebar shows 53 next to the list
Evidence: [obs EV-012][obs EV-046]Feature: F-001 · Screen: S-001

R-003 Mark complete on a card moves the task to the closed status and offers Undo

Given
an open task on the board
When
the user clicks ✓ "Mark complete" in the card's hover toolbar
Then
the card moves to the closed column, the counts update, and a toast "Status changed" shows "Undo ⌘Z"; the request sends status with the closed status name
Evidence: [obs EV-012][net EV-014]Feature: F-002 · Screen: S-001

R-004 The card date chip uses relative text and an urgency color

Given
open tasks with due dates in the past, today, and a start-to-due range
When
the board renders
Then
a past due date reads "3 days ago" in red, today reads "Today" in yellow, and a range reads "Today - Mon" in the default color
Evidence: [obs EV-010][obs EV-035]Feature: F-002 · Screen: S-001
ProbeInputResultEvidence
Overduedue 13 Oct, today 16 Oct"3 days ago", red[obs EV-010]
Todayquick option Today"Today", yellow[obs EV-010]
Rangestart Today, due Next week"Today - Mon"[obs EV-010]

R-005 The date picker saves when it closes, not when a day is clicked

Given
the date picker open on a card
When
the user clicks a day
Then
the chip updates inside the picker only; the update request is sent when the picker closes (Escape or click outside)
Evidence: [net EV-014][obs EV-008]Feature: F-002 · Screen: S-001

R-006 Typing an unknown tag on a card creates a Space tag and applies it when the picker closes

Given
the tag picker on a card and a name that matches no tag
When
the user presses Enter on "Create <name>" and closes the picker
Then
one request creates the tag with generated foreground and background colors and applies it to the task; the card shows the tag pill
Evidence: [obs EV-040][net EV-014]Feature: F-025 · Screen: S-001

R-007 Assigning yourself prompts to add the task to your personal priorities

Given
the assignee picker on a card
When
the user picks "Me"
Then
the assignee is saved at once and a prompt offers "Don't ask again" and "Add to priorities"
Evidence: [obs EV-041][obs EV-042][net EV-014]Feature: F-002 · Screen: S-001

R-008 View changes are drafts until Save view; a reload drops them without warning

Given
the default board view
When
the user collapses a column, changes card size, toggles a layout option, or changes grouping
Then
"Save view" appears in the toolbar, the board re-queries the view with the draft settings, nothing is saved; after a reload the board is back to the saved settings and no message mentions the lost draft
Evidence: [obs EV-017][obs EV-020][net EV-014]Feature: F-004 · Screen: S-001
ProbeInputResultEvidence
Collapse group, reloadIN PROGRESS collapsedexpanded again after reload[obs EV-017]
Card size Large, layout toggles, reloadLarge, Stack fields on, Show empty fields offback to Medium and defaults[obs EV-023]
Group Priority + subgroup Status, reloadswimlanesback to Group: Status[obs EV-027]

R-009 The column menu offers Archive all and Select all only for columns with tasks

Given
one column with tasks and one empty column
When
the user opens Group options on each
Then
the full column shows Collapse group, Archive all in this group, Automate status, Select all, Rename, Edit statuses; the empty column shows only Collapse group, Automate status, Rename, Edit statuses
Evidence: [obs EV-015][obs EV-016]Feature: F-001 · Screen: S-001

R-010 A task created inside a column takes that column's status and the form stays open

Given
the board grouped by status
When
the user opens "+ Add Task" in IN PROGRESS, types a name and presses Enter
Then
the task is created with status in progress, the form reopens for the next task, and a "Task created" toast appears; Enter with an empty name does nothing
Evidence: [obs EV-029][obs EV-030]Feature: F-003 · Screen: S-001

R-011 Adding a group on a list that inherits statuses asks where the new status applies

Given
a list that inherits its statuses from the Space
When
the user adds a group named "[re] review" and confirms with ✓
Then
a dialog asks "List only" (default) or "Entire Space"; with List only the list gets its own statuses and the new status column appears before the closed column
Evidence: [obs EV-036][obs EV-037][obs EV-038]Feature: F-024 · Screen: S-001

R-012 Grouping by a field other than status adds a status chip to cards and a column for empty values

Given
the board
When
Group is set to Priority
Then
columns are Urgent, High, Normal, Low and No priority; cards show their status as a chip; closed tasks are hidden and the Closed toggle becomes active
Evidence: [obs EV-026][obs EV-025]Feature: F-004 · Screen: S-001

R-013 A subgroup splits the board into collapsible swimlanes

Given
the board grouped by Priority
When
the user adds a subgroup by Status
Then
each status becomes a row with its own count, collapse arrow and +, crossing every priority column; the group button reads "Group: Priority / Status"
Evidence: [obs EV-027]Feature: F-004 · Screen: S-001

R-014 Card size sets the column width

Given
the board
When
Card size is Small, Medium or Large
Then
columns are 200, 264 or 328 CSS px wide; Medium is the default
Evidence: [obs EV-020][obs EV-021][obs EV-046]Feature: F-004 · Screen: S-001

R-015 Show empty fields and Stack fields change the card body

Given
cards with some fields empty
When
Show empty fields is off and Stack fields is on
Then
empty field placeholders disappear (an empty card shows only its title) and each filled field takes its own row with an icon
Evidence: [obs EV-023]Feature: F-004 · Screen: S-001

R-016 Columns load tasks in pages while scrolling

Given
a column with 53 tasks
When
the board loads and the user scrolls inside the column
Then
about 11 cards exist at first; scrolling sends another tasks/bulk request and more cards render
Evidence: [obs EV-046][net EV-014]Feature: F-007 · Screen: S-001

R-017 Priority has four fixed levels stored as numbers

Given
the priority picker
When
the user picks High
Then
the card shows a yellow flag with "High" and the request sends priority: "2"; the scale is Urgent 1, High 2, Normal 3, Low 4, and Clear removes it
Evidence: [obs EV-006][net EV-007][doc SRC-031]Feature: F-002 · Screen: S-001

R-018 Changes appear in other open tabs without reload

Given
the same board open in two tabs
When
priority Low is set in the first tab
Then
the second tab shows "Low" on the card without a reload (about 8 s in a background tab)
Evidence: [obs EV-031][obs EV-032]Feature: F-026 · Screen: S-001

R-019 Dragging a card to another column changes its group value

Given
the board grouped by status
When
the user drags a card to another column
Then
the task takes that column's status; dragging within a column changes its order
Evidence: [doc SRC-012]Feature: F-005 · Screen: S-001Not observed: the drag could not be automated (EV-046). Q-003.
+

Custom fields 23 rules

R-033 A field created from a task belongs to that task's list

Given
a task in the list [RE] Board study
When
the user opens Add fields > Create new, picks a type, types a name and clicks Create
Then
the field is created with one location, the list ("Belongs to: [RE] Board study"), and shows in the Fields section of every task in that list; the client sends two requests: the definition (POST /customFields/v2/field) and its location (PUT /field/v3/.../fields/:id/locations, parent type 6 = List)
Evidence: [obs EV-079][obs EV-080][obs EV-081][net EV-099]Feature: F-016 · Screen: S-002

R-034 The type menu puts popular and AI types first; Rollup is not a type of its own

Given
Add fields > Create new in a task, or Create new in the Custom Field Manager
When
the type menu opens
Then
the task view lists Popular (Dropdown, Text, Date, Text area, Number, Labels, AI Autofill) and then All; the manager lists AI Fields (Summary, Custom Text, Custom Dropdown) and then All, which ends with Categorize, Translation, Sentiment, Action Items and T-shirt Size; Rollup is offered only inside a Tasks or Relationship field ("Create rollup fields")
Evidence: [obs EV-079][obs EV-096][obs EV-097][obs EV-087][obs EV-093]Feature: F-016 · Screen: S-003

R-035 Number and money formats are set per field, not by the user's language

Given
a Number field with format EU (1.234,56) and a Money field in BRL with format EU
When
the user enters 1234,5 and 1234,56
Then
the task and the card show 1.234,5 and R$ 1.234,56; the field stores number_format: "de-DE" and currency_type: "BRL", and the value is sent as a string
Evidence: [obs EV-084][obs EV-085][obs EV-102][obs EV-103][obs EV-121][net EV-099][net EV-112]Feature: F-016, F-017 · Screen: S-002

R-036 Picking a country in a Phone field changes the user's profile country

Given
an empty Phone field; its flag defaults to the user's profile country (a country other than Brazil in this account)
When
the user picks Brazil in the flag menu and types a number
Then
the number takes the Brazilian mask, (11) 90000-0000, and is saved as +55 11 90000 0000; the pick also sends PUT /user/v1/user with the new country, so every empty Phone field on every task now defaults to Brazil; picking the original country again on another task, with no number typed, sends the same request and restores the default
Evidence: [obs EV-104][obs EV-105][obs EV-130][obs EV-131]Feature: F-017 · Screen: S-002

R-037 On Free Forever each value written counts once against 60 uses per workspace

Given
Free Forever with no values yet
When
17 fields get one value each, and Labels gets two labels added one at a time
Then
the entitlement counter reads 18 used of 60 (usage, limit, usageLeft); linking a task through a Tasks field and configuring a Formula field did not change it; the counter is fetched again after each value is set
Evidence: [net EV-112][doc SRC-005]Feature: F-022 · Screen: S-002Not observed: what happens at 60, and whether deleting a field gives uses back (Q-008). The docs say Formula values count as uses (SRC-043); here they did not (Q-009).

R-038 A Formula field is defined once per field and takes the money format of a money input

Given
Number 1.234,5 and Money R$ 1.234,56 on a task
When
the user opens the empty Formula value, picks Number, +, Money and clicks Calculate
Then
the task and the card show R$ 2.469,06; the formula is saved on the field definition (PUT /customFields/v2/field/:id with type_config.formula, simple: true, calculation_state: "ready"), so every task in the location computes it, and tasks without inputs show R$ 0; the editor asks "Select a second field to calculate" until both inputs are set
Evidence: [obs EV-115][obs EV-116][obs EV-120][net EV-112]Feature: F-016, F-017 · Screen: S-002

R-039 Tasks and Relationship fields live in the Relate menu, not in the Fields section

Given
a Tasks field and a Relationship field on the list
When
the user opens "Relate items or add dependencies"
Then
both fields appear under the dependency options; picking the Tasks field and a task adds a Related section with one tab per field ("[RE] cf-tasks 1") and a table (Name, Due date, Priority); the board card shows the linked task as a chip with a + button, and an empty one shows "Add task"
Evidence: [obs EV-118][obs EV-119][obs EV-120][obs EV-121][net EV-112]Feature: F-016, F-017, F-018 · Screen: S-002

R-040 A Relationship field must point at another list

Given
the Relationship field form
When
the user chooses "tasks from a specific List"
Then
a related list is required and the field's own list cannot be chosen; the form offers rollup fields from the related list
Evidence: [obs EV-093]Feature: F-016 · Screen: S-003

R-041 Required and Pinned do nothing on Free Forever except point to an upgrade

Given
the field's Permissions and settings on Free Forever
When
the user clicks "Required in tasks", then "Pinned"
Then
Required stays off with only a tooltip as feedback; Pinned opens "Upgrade to Business" (closed without choosing)
Evidence: [obs EV-082][obs EV-083][doc SRC-003]Feature: F-019 · Screen: S-002

R-042 A required field blocks task creation where it is used (documented)

Given
a Business workspace and a field set to "Required in tasks"
When
a user creates a task in a location of that field without a value
Then
the task cannot be created until the field has a value; the public API skips the check unless check_required_custom_fields is true; the task view always shows required fields, even empty
Evidence: [doc SRC-003][doc SRC-029][doc SRC-007]Feature: F-019 · Screen: S-002Not observed: plan (Business). Q-010.

R-043 The task view lists a location's fields in one Fields section

Given
a task in a list with 22 fields
When
the task opens
Then
a "Fields" section under the description has one row per field (type icon, name, value) in name order, with search, expand and + in its header; "Hide N empty fields" collapses the empty rows; Tasks and Relationship fields are not listed there (R-039)
Evidence: [obs EV-100][obs EV-117][doc SRC-007]Feature: F-015 · Screen: S-002

R-044 Each value saves on its own and adds an activity line

Given
the Fields section
When
the user sets a value (checkbox click, picker choice, text and blur, slider drag)
Then
one request saves that value (POST /customFields/v1/task/:id/field/:id; DELETE on the same path clears it) and the activity log adds a line such as "You set [RE] cf-money to R$ 1.234,56", "You added [RE] lab 1 to [RE] cf-labels", "You signed on [RE] cf-signature"
Evidence: [obs EV-106][obs EV-117][net EV-112]Feature: F-017 · Screen: S-002

R-045 Each type has its own editor in the Fields section

Given
the Fields section
When
the user clicks a value
Then
the editor depends on the type: dropdown and labels open an option picker with search and colors; people a person picker with "Keep typing a full email to invite"; text area a large popover editor; manual progress a slider; rating clickable stars; voting a thumbs-up toggle; signature a pad with a typed or drawn mode; location a search with Google Places suggestions; formula a field-operator-field editor
Evidence: [obs EV-100][obs EV-106][obs EV-107][obs EV-108][obs EV-109][obs EV-110][obs EV-113][obs EV-115]Feature: F-017 · Screen: S-002

R-046 Location values store the address and the coordinates

Given
a Location field
When
the user types a street and picks the suggestion
Then
the value shows the formatted address ("Av. Paulista, São Paulo - SP, Brazil") and is saved with formatted_address, location {lat, lng} and place_id
Evidence: [obs EV-113][obs EV-114][net EV-112]Feature: F-017 · Screen: S-002

R-047 A typed signature is drawn in a script font and records who signed

Given
a Signature field
When
the user types a name in Type mode and clicks Save
Then
the value shows the name in a script font in the task and on the card; the request carries value_options {isTyped, signedBy}; the activity says "You signed on <field>"
Evidence: [obs EV-110][obs EV-111][obs EV-121][net EV-112]Feature: F-017 · Screen: S-002

R-048 On a card every shown custom field takes its own row with the type icon

Given
all 22 fields turned on in Customize > Fields
When
the board renders
Then
each card gets one row per field, icon at the left, even with Stack fields off; empty values show "-", except Formula ("R$ 0"), Checkbox (empty box), Rating (grey stars), Voting (0), Progress (empty bar, 0) and Tasks or Relationship ("Add task"); filled values keep their task-view look, with text area cut to the first line plus an ellipsis and location cut at the card width; some values (rating, phone) appear a moment after the card
Evidence: [obs EV-120][obs EV-121][obs EV-123]Feature: F-018 · Screen: S-001

R-049 Custom field values can be edited on the card

Given
a card showing a dropdown value
When
the user clicks the value
Then
the same option picker as in the task view opens on the card; hovering the field icon shows the field name and "Custom Field"
Evidence: [obs EV-122]Feature: F-018 · Screen: S-001

R-050 Showing custom fields on cards is a view draft

Given
a board view saved without custom fields
When
the user turns fields on in Customize > Fields
Then
"Save view" appears; after a reload without saving, the cards show no custom fields again
Evidence: [obs EV-123][obs EV-124]Feature: F-018 · Screen: S-001

R-051 Deleting a field warns with the task count and sends it to Trash without Undo

Given
a Dropdown field holding a value on one task
When
the user opens the field settings from the row gear and clicks the delete icon
Then
a dialog reads "This action will delete this Custom Field from 1 task. Admins are able to restore deleted fields from the Trash." (the count appears a moment after the dialog); Delete removes the row from the task at once and shows "Field deleted successfully" with no Undo
Evidence: [obs EV-125][obs EV-126][obs EV-127][doc SRC-004]Feature: F-020 · Screen: S-002

R-052 Restoring a field from Trash brings its values back

Given
the deleted field in Settings > Trash
When
the user opens its menu and clicks Restore
Then
the item leaves the Trash and the task shows the field again with its old value ([RE] opt A)
Evidence: [obs EV-128][obs EV-129]Feature: F-020 · Screen: S-005

R-053 Trash holds deleted lists, tasks, tags and fields for 30 days

Given
deleted items
When
the user opens Settings > Trash
Then
each item shows name, location, deleted on and deleted by, filtered to "Me" by default; a deleted list is one row (its tasks are not listed separately); a tag deleted from a picker is there too; the page says items are deleted forever after 30 days and offers "Clear all Trash"; each row offers Restore and Delete forever
Evidence: [obs EV-128][obs EV-133][obs EV-137][doc SRC-004]Feature: F-020 · Screen: S-005

R-054 Deleting a list takes its list-level fields with it

Given
22 fields whose only location is a list
When
the list is deleted ("54 tasks and templates within this List will be deleted. Additionally, automations will become inactive.")
Then
the list goes to Trash with its tasks, and the Custom Field Manager shows no fields in All, Workspace Fields or Personal List
Evidence: [obs EV-132][obs EV-133][obs EV-134]Feature: F-020, F-021 · Screen: S-003

R-055 The Custom Field Manager groups fields by type and lists their locations

Given
22 list-level fields
When
the user opens Settings > Custom Field Manager
Then
All Custom Fields shows one group per type with a count and a "Create <type> field" link, and columns Name, Type, Created by, Date Created, Location(s); the left side filters by Workspace Fields, Task Type Fields, Personal List, By Location and By Task Type
Evidence: [obs EV-098][obs EV-134][doc SRC-006]Feature: F-021 · Screen: S-003
+

Task view 13 rules

R-020 Clicking a card opens the task at its own URL, over the board

Given
the board
When
the user clicks a card title
Then
the task opens at /t/:team/:task in the user's layout (Full screen here), the page title becomes "<name> | #<task id>", and the board stays mounted underneath
Evidence: [obs EV-051][obs EV-050][net EV-053]Feature: F-009 · Screen: S-002

R-021 The task layout is a personal preference shared by every task and workspace

Given
the task view in Full screen
When
the user clicks the Switch layout button
Then
the layout cycles to Sidebar (board visible on the left, task on the right); the hover popover offers Modal, Full screen and Sidebar; the choice applies to the next task opened, also after a reload
Evidence: [obs EV-052][obs EV-074][obs EV-075][obs EV-078][doc SRC-016]Feature: F-009 · Screen: S-002

R-022 The header arrows step through tasks in the board's order

Given
a task opened from the board
When
the user clicks ↓
Then
the next card's task opens ([RE] typical → [RE] overdue), without closing the view
Evidence: [obs EV-059]Feature: F-009 · Screen: S-002

R-023 The status picker groups statuses by type

Given
a list with to do, in progress, [re] review and complete
When
the user opens the status pill
Then
the picker shows Not started (to do), Active (in progress, [re] review) and Closed (complete), with search
Evidence: [obs EV-054][net EV-053]Feature: F-009 · Screen: S-002

R-024 The next-status arrow moves a task one status forward

Given
a task in TO DO
When
the user clicks ▸ beside the status pill
Then
the status becomes IN PROGRESS, a toast offers Undo ⌘Z, and the activity log adds "You changed status from To Do to In Progress"
Evidence: [obs EV-073][net EV-014]Feature: F-009 · Screen: S-002

R-025 The description saves while typing, and "- " starts a bullet list

Given
an empty description
When
the user types a line, Enter, "- first item", Enter, "second item", then clicks away
Then
the lines become a paragraph and a two-item bullet list; no Save button exists; after a reload the text is still there; **bold** typed in one go stays literal
Evidence: [obs EV-055][obs EV-078]Feature: F-010 · Screen: S-002

R-026 A comment posts to the activity stream; the composer stays empty for the next

Given
the activity sidebar
When
the user types a comment and clicks send
Then
the comment appears with author, "Just now", reactions and Reply; the request carries the text blocks and the followers
Evidence: [obs EV-057][net EV-058]Feature: F-014 · Screen: S-002

R-027 Opening and using a task marks it as viewed

Given
any task
When
the user opens it and acts in it
Then
the client sends PUT /task-v3/core/:id/tasks/:id/viewed with an empty body
Evidence: [net EV-058]Feature: F-009 · Screen: S-002

R-028 Subtasks are created inline and show as a table with a progress count

Given
a task without subtasks
When
the user clicks Add subtask and enters two names
Then
a Subtasks section shows "2 open", a progress bar and a table (Name, Assignee, Priority); the header gets a subtask count; the board card shows "2 subtasks"
Evidence: [obs EV-061][obs EV-062][obs EV-070][net EV-063]Feature: F-011 · Screen: S-002

R-029 A dependency shows on both tasks and on both cards

Given
two tasks
When
the user sets "This task is blocked by" the other
Then
the blocked task shows "Blocked by <task>" under its fields and a Dependencies tab; the other shows "Blocking <task>"; their cards show a yellow warning 1 and a red blocking 1
Evidence: [obs EV-065][obs EV-066][obs EV-070][net EV-069]Feature: F-013 · Screen: S-002

R-030 Create checklist creates an empty checklist at once

Given
a task
When
the user clicks Create checklist
Then
a checklist named "Checklist" is saved immediately with its name in edit mode; items added with Enter save one by one
Evidence: [obs EV-067][net EV-069]Feature: F-012 · Screen: S-002

R-031 Resolved checklist items hide behind "Show completed" and update counts

Given
a checklist with 3 open items
When
the user resolves one
Then
the section reads "2 open", the item moves under "Show 1 completed", the header count reads 2, and the card shows 1/3
Evidence: [obs EV-072][obs EV-073][obs EV-074]Feature: F-012 · Screen: S-002

R-032 Escape in an empty inline input closes the task view

Given
the checklist item input open and empty
When
the user presses Escape
Then
the task view closes and the board shows again
Evidence: [obs EV-068]Feature: F-009 · Screen: S-002
+

06Data model

The entities behind the screens: fields, types, relations and who may do what.

E-001 Workspace

Product term: Workspace (API: team) · Parent: none · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes[obs EV-048]
planenumyesFree ForeverFree Forever, Unlimited, Business, Business Plus, Enterprise[doc SRC-035]
custom_field_usescounteryes0limit 60 on Free Forever, unlimited on paid plans[net EV-112][doc SRC-005]
regionstringyesAPI gateway per region (eu-west-1 seen)[net EV-005]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes[obs EV-048]
planenumyesFree ForeverFree Forever, Unlimited, Business, Business Plus, Enterprise[doc SRC-035]
custom_field_usescounteryes0limit 60 on Free Forever, unlimited on paid plans[net EV-112][doc SRC-005]
regionstringyesAPI gateway per region (eu-west-1 seen)[net EV-005]

Relations

-
RelationTargetCardinalityOn deleteSource
hasE-002 Space1..ndeletes all[obs EV-048]
has membersE-013 User1..n[obs EV-048]
hasE-007 CustomField0..n[net EV-099]
+
RelationTargetCardinalityOn deleteSource
hasE-002 Space1..ndeletes all[obs EV-048]
has membersE-013 User1..n[obs EV-048]
hasE-007 CustomField0..n[net EV-099]

Lifecycle

Created by the owner from the workspace switcher; onboarding adds a Space, a List and two chat channels (R-033 context, EV-048).

System fields

-
FieldSet whenSource
idcreation[net EV-053]
+
FieldSet whenSource
idcreation[net EV-053]

Rules

  • None specific.

Not tested

  • Deleting a workspace (kept by instruction).
-
E-002 Space

Product term: Space (legacy API: project) · Parent: E-001 · Status: reviewed

+
E-002 Space

Product term: Space (legacy API: project) · Parent: E-001 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes"Space" from onboarding[obs EV-048]
statusesStatus[]yesto do, in progress, completeinherited by lists unless a list has its own[obs EV-037][doc SRC-018]
tagsTag[]notags are Space-level[obs EV-040][obs EV-136]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes"Space" from onboarding[obs EV-048]
statusesStatus[]yesto do, in progress, completeinherited by lists unless a list has its own[obs EV-037][doc SRC-018]
tagsTag[]notags are Space-level[obs EV-040][obs EV-136]

Relations

-
RelationTargetCardinalityOn deleteSource
containsE-003 List0..nlist goes to Trash[obs EV-048]
ownsE-006 Tag0..n[obs EV-136]
ownsE-005 Status1..n[obs EV-037]
+
RelationTargetCardinalityOn deleteSource
containsE-003 List0..nlist goes to Trash[obs EV-048]
ownsE-006 Tag0..n[obs EV-136]
ownsE-005 Status1..n[obs EV-037]

Lifecycle

Active; deleted spaces were not observed.

System fields

-
FieldSet whenSource
space_idset on every task as its location[net EV-053]
+
FieldSet whenSource
space_idset on every task as its location[net EV-053]

Rules

Not tested

  • Folders, Space settings, ClickApps.
-
E-003 List

Product term: List (legacy API: subcategory) · Parent: E-002 (or a Folder) · Status: reviewed

+
E-003 List

Product term: List (legacy API: subcategory) · Parent: E-002 (or a Folder) · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes[obs EV-048]
statusesStatus[]yesinherited from the Spaceown statuses once "List only" is chosen[obs EV-037][obs EV-038]
task_countnumberyes0sidebar count leaves out closed tasks[obs EV-046]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-053]
namestringyes[obs EV-048]
statusesStatus[]yesinherited from the Spaceown statuses once "List only" is chosen[obs EV-037][obs EV-038]
task_countnumberyes0sidebar count leaves out closed tasks[obs EV-046]

Relations

-
RelationTargetCardinalityOn deleteSource
containsE-004 Task0..ntasks go to Trash with the list[obs EV-132]
location ofE-007 CustomField0..nlist-only fields disappear with it[obs EV-134]
hasE-009 View1..n[obs EV-002]
+
RelationTargetCardinalityOn deleteSource
containsE-004 Task0..ntasks go to Trash with the list[obs EV-132]
location ofE-007 CustomField0..nlist-only fields disappear with it[obs EV-134]
hasE-009 View1..n[obs EV-002]

Lifecycle

Active → Trash (30 days, restorable) → deleted forever.

System fields

-
FieldSet whenSource
date_deleteddelete[obs EV-133]
+
FieldSet whenSource
date_deleteddelete[obs EV-133]

Rules

Not tested

  • Folders, list settings, list templates.
-
E-004 Task

Product term: Task · Parent: E-003 (home list) · Status: reviewed

+
E-004 Task

Product term: Task · Parent: E-003 (home list) · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstringyesshort alphanumeric id[net EV-053]
namestringyesno limit hit at 216 characters[net EV-053][obs EV-060]
contentrich text (Quill delta)noalso text_content[net EV-053]
statusStatusyesfirst status of the list[net EV-053]
priorityenum stringnonull"1" Urgent, "2" High, "3" Normal, "4" Low[net EV-007][doc SRC-031]
start_date, due_dateepoch ms stringnonullwith start_date_time, due_date_time flags[net EV-014][net EV-053]
users{userid, type}[]noownertype: assigned, watcher, owner[net EV-053]
tagsstring[]no[]Space tags[net EV-053]
parenttask idnonullset for subtasks[net EV-063]
orderindex, boardindexnumberyesone order index per grouping[net EV-063][net EV-014]
custom_typetask typenonull (Task)Task, Milestone, Form Response, Meeting Note, custom[net EV-053][obs EV-077]
fieldsCustomFieldValue[]no[][net EV-053][net EV-112]
states{is_archived, is_deleted}yesfalse[net EV-053]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstringyesshort alphanumeric id[net EV-053]
namestringyesno limit hit at 216 characters[net EV-053][obs EV-060]
contentrich text (Quill delta)noalso text_content[net EV-053]
statusStatusyesfirst status of the list[net EV-053]
priorityenum stringnonull"1" Urgent, "2" High, "3" Normal, "4" Low[net EV-007][doc SRC-031]
start_date, due_dateepoch ms stringnonullwith start_date_time, due_date_time flags[net EV-014][net EV-053]
users{userid, type}[]noownertype: assigned, watcher, owner[net EV-053]
tagsstring[]no[]Space tags[net EV-053]
parenttask idnonullset for subtasks[net EV-063]
orderindex, boardindexnumberyesone order index per grouping[net EV-063][net EV-014]
custom_typetask typenonull (Task)Task, Milestone, Form Response, Meeting Note, custom[net EV-053][obs EV-077]
fieldsCustomFieldValue[]no[][net EV-053][net EV-112]
states{is_archived, is_deleted}yesfalse[net EV-053]

Relations

-
RelationTargetCardinalityOn deleteSource
inE-003 Listn..1 home, n..n extra listsTrash with the list[net EV-053]
has subtasksE-004 Task0..n[net EV-063]
hasE-010 Comment0..n[net EV-058]
hasE-011 Checklist0..n[net EV-069]
depends onE-012 Dependency0..n[net EV-069]
has valuesE-008 CustomFieldValue0..n[net EV-112]
has historyE-014 HistoryItem0..n[net EV-007]
+
RelationTargetCardinalityOn deleteSource
inE-003 Listn..1 home, n..n extra listsTrash with the list[net EV-053]
has subtasksE-004 Task0..n[net EV-063]
hasE-010 Comment0..n[net EV-058]
hasE-011 Checklist0..n[net EV-069]
depends onE-012 Dependency0..n[net EV-069]
has valuesE-008 CustomFieldValue0..n[net EV-112]
has historyE-014 HistoryItem0..n[net EV-007]

Lifecycle

open statuses → custom (active) statuses → closed status; archived and deleted are separate flags; deleted tasks sit in Trash 30 days.

System fields

-
FieldSet whenSource
date_createdcreate[net EV-053]
date_updatedevery change[net EV-053]
date_closedmoved to a closed status[net EV-053]
creator, ownercreate[net EV-053]
+
FieldSet whenSource
date_createdcreate[net EV-053]
date_updatedevery change[net EV-053]
date_closedmoved to a closed status[net EV-053]
creator, ownercreate[net EV-053]

Rules

Not tested

  • Recurrence, time tracking, cover image, privacy and sharing, multiple lists.
-
E-005 Status

Product term: Status · Parent: E-002 or E-003 · Status: reviewed

+
E-005 Status

Product term: Status · Parent: E-002 or E-003 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstringyes[net EV-053]
statusstringyesshown upper case on the board[net EV-053][obs EV-038]
typeenumyesopen, custom, closed (done in docs)[net EV-014][doc SRC-018]
status_groupstringyespicker groups: Not started, Active, Closed[net EV-053][obs EV-054]
colorhexyes[net EV-053]
orderindexnumberyescolumn order[net EV-053]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstringyes[net EV-053]
statusstringyesshown upper case on the board[net EV-053][obs EV-038]
typeenumyesopen, custom, closed (done in docs)[net EV-014][doc SRC-018]
status_groupstringyespicker groups: Not started, Active, Closed[net EV-053][obs EV-054]
colorhexyes[net EV-053]
orderindexnumberyescolumn order[net EV-053]

Relations

-
RelationTargetCardinalityOn deleteSource
belongs toE-002 Space or E-003 Listn..1[obs EV-037]
+
RelationTargetCardinalityOn deleteSource
belongs toE-002 Space or E-003 Listn..1[obs EV-037]

Lifecycle

Created from Add group or status settings; removed with its list when list-only.

System fields

-
FieldSet whenSource
+
FieldSet whenSource

Rules

Not tested

  • Renaming, deleting a status with tasks, done-type statuses.
-
E-006 Tag

Product term: Tag · Parent: E-002 · Status: reviewed

+
E-006 Tag

Product term: Tag · Parent: E-002 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
namestringyeslower case as typed[net EV-014][obs EV-040]
tag_fg, tag_bghexyesgenerated[net EV-014]
+
FieldTypeRequiredDefaultConstraints or enumSource
namestringyeslower case as typed[net EV-014][obs EV-040]
tag_fg, tag_bghexyesgenerated[net EV-014]

Relations

-
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..nremoved from all tasks when deleted[obs EV-136]
+
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..nremoved from all tasks when deleted[obs EV-136]

Lifecycle

Created from a card picker (Space-level) → deleted from a picker ("everywhere in this Space") → Trash.

System fields

-
FieldSet whenSource
+
FieldSet whenSource

Rules

Not tested

  • Tag Manager (Business Plus), renaming and colors.
-
E-007 CustomField

Product term: Custom Field · Parent: E-001 (one or more locations) · Status: reviewed

+
E-007 CustomField

Product term: Custom Field · Parent: E-001 (one or more locations) · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
iduuidyes[net EV-099]
namestringyes[net EV-099]
typeenum stringyesdrop_down, number, currency, formula seen; 22 UI types created[net EV-099][net EV-112][obs EV-098]
type_idnumberyes17 = formula[net EV-112]
type_configobjectno{}per type: options, number_format, currency_type, precision, formula[net EV-099][net EV-112]
required, required_on_subtasksbooleanyesfalseBusiness plan[net EV-099][doc SRC-003]
pinnedbooleanyesfalseBusiness plan[net EV-099][obs EV-083]
hide_from_guestsbooleanyesfalse[net EV-099]
private, permission_level, members, groupspermissionsnoworkspace default[net EV-099][obs EV-081]
locations{parent{type,id}}[]yesthe list where it was createdtype 6 = List[net EV-099]
deleted, deleted_byflagsyesfalse[net EV-099]
+
FieldTypeRequiredDefaultConstraints or enumSource
iduuidyes[net EV-099]
namestringyes[net EV-099]
typeenum stringyesdrop_down, number, currency, formula seen; 22 UI types created[net EV-099][net EV-112][obs EV-098]
type_idnumberyes17 = formula[net EV-112]
type_configobjectno{}per type: options, number_format, currency_type, precision, formula[net EV-099][net EV-112]
required, required_on_subtasksbooleanyesfalseBusiness plan[net EV-099][doc SRC-003]
pinnedbooleanyesfalseBusiness plan[net EV-099][obs EV-083]
hide_from_guestsbooleanyesfalse[net EV-099]
private, permission_level, members, groupspermissionsnoworkspace default[net EV-099][obs EV-081]
locations{parent{type,id}}[]yesthe list where it was createdtype 6 = List[net EV-099]
deleted, deleted_byflagsyesfalse[net EV-099]

Relations

-
RelationTargetCardinalityOn deleteSource
located atE-003 List (also Workspace, Space, Folder)1..nlist-only fields disappear with the list[net EV-099][doc SRC-008]
valuesE-008 CustomFieldValue0..nvalues come back on restore[obs EV-129]
+
RelationTargetCardinalityOn deleteSource
located atE-003 List (also Workspace, Space, Folder)1..nlist-only fields disappear with the list[net EV-099][doc SRC-008]
valuesE-008 CustomFieldValue0..nvalues come back on restore[obs EV-129]

Lifecycle

Active → Trash (on delete, 30 days, values kept) → restored or deleted forever.

System fields

-
FieldSet whenSource
useridcreate[net EV-099]
date_createdcreate[net EV-099]
+
FieldSet whenSource
useridcreate[net EV-099]
date_createdcreate[net EV-099]

Rules

Not tested

  • Workspace, Space and Folder locations; task-type fields; conversion between types.
-
E-008 CustomFieldValue

Product term: Custom Field value (a "use") · Parent: E-004 · Status: reviewed

+
E-008 CustomFieldValue

Product term: Custom Field value (a "use") · Parent: E-004 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
field_iduuidyes[net EV-112]
task_idstringyes[net EV-112]
valueper typeyesboolean, epoch-ms string, option uuid, string, number, {add,rem} ids, {current}, location object[net EV-112]
value_optionsobjectnodate {time}, signature {isTyped, signedBy}[net EV-112]
value_richtextstringnorich copy of text values[net EV-112]
+
FieldTypeRequiredDefaultConstraints or enumSource
field_iduuidyes[net EV-112]
task_idstringyes[net EV-112]
valueper typeyesboolean, epoch-ms string, option uuid, string, number, {add,rem} ids, {current}, location object[net EV-112]
value_optionsobjectnodate {time}, signature {isTyped, signedBy}[net EV-112]
value_richtextstringnorich copy of text values[net EV-112]

Relations

-
RelationTargetCardinalityOn deleteSource
ofE-007 CustomFieldn..1kept while the field is in Trash[obs EV-129]
onE-004 Taskn..1[net EV-112]
+
RelationTargetCardinalityOn deleteSource
ofE-007 CustomFieldn..1kept while the field is in Trash[obs EV-129]
onE-004 Taskn..1[net EV-112]

Lifecycle

Set (counts one use on Free) → changed → cleared (DELETE).

System fields

-
FieldSet whenSource
history itemevery set[net EV-112]
+
FieldSet whenSource
history itemevery set[net EV-112]

Rules

Not tested

  • Files values, Relationship values, values at the 60-use limit.
-
E-009 View

Product term: View · Parent: E-003 (or Space, Folder) · Status: reviewed

+
E-009 View

Product term: View · Parent: E-003 (or Space, Folder) · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstringyes[net EV-014]
typeenumyesboard, list, overview and others[net EV-014]
grouping{field, dir, collapsed[]}yesstatus[net EV-014]
divide{field, dir, collapsed[]}nononesubgroup (swimlanes)[net EV-014]
sorting{fields[]}no[][net EV-014]
filters{op, fields[], search, show_closed}no[net EV-014]
columns{fields[{field, hidden}]}yesname, assignee, dates, priority, tagscustom fields hidden until shown[net EV-014][obs EV-123]
settingsobjectyescard size Medium, show empty fields on[net EV-014][obs EV-020]
auto_savebooleanyesfalse[net EV-014]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstringyes[net EV-014]
typeenumyesboard, list, overview and others[net EV-014]
grouping{field, dir, collapsed[]}yesstatus[net EV-014]
divide{field, dir, collapsed[]}nononesubgroup (swimlanes)[net EV-014]
sorting{fields[]}no[][net EV-014]
filters{op, fields[], search, show_closed}no[net EV-014]
columns{fields[{field, hidden}]}yesname, assignee, dates, priority, tagscustom fields hidden until shown[net EV-014][obs EV-123]
settingsobjectyescard size Medium, show empty fields on[net EV-014][obs EV-020]
auto_savebooleanyesfalse[net EV-014]

Relations

-
RelationTargetCardinalityOn deleteSource
ofE-003 Listn..1deleted with the list[obs EV-132]
+
RelationTargetCardinalityOn deleteSource
ofE-003 Listn..1deleted with the list[obs EV-132]

Lifecycle

Saved definition plus an unsaved draft in the client; reload drops the draft (R-008).

System fields

-
FieldSet whenSource
+
FieldSet whenSource

Rules

Not tested

  • Private, protected and default views; sharing.
-
E-010 Comment

Product term: Comment · Parent: E-004 · Status: reviewed

+
E-010 Comment

Product term: Comment · Parent: E-004 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-058]
comment{text, attributes}[]yesblock-based rich text[net EV-058]
useridnumberyesauthor[net EV-058]
dateepoch msyes[net EV-058]
resolved, assigneeboolean, usernofalse, nullassigned comments[net EV-058]
reactions[]no[][net EV-058]
+
FieldTypeRequiredDefaultConstraints or enumSource
idstring (numeric)yes[net EV-058]
comment{text, attributes}[]yesblock-based rich text[net EV-058]
useridnumberyesauthor[net EV-058]
dateepoch msyes[net EV-058]
resolved, assigneeboolean, usernofalse, nullassigned comments[net EV-058]
reactions[]no[][net EV-058]

Relations

-
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..1[net EV-058]
+
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..1[net EV-058]

Lifecycle

Posted → edited, resolved or deleted (not tested).

System fields

-
FieldSet whenSource
date_updatededit[net EV-058]
+
FieldSet whenSource
date_updatededit[net EV-058]

Rules

Not tested

  • Threads, mentions, assigned comments, reactions.
-
E-011 Checklist

Product term: Checklist · Parent: E-004 · Status: reviewed

+
E-011 Checklist

Product term: Checklist · Parent: E-004 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
iduuidyes[net EV-069]
namestringyes"Checklist"[net EV-069]
items{name, resolved, assignee, parent, orderindex}[]no[]items can nest (parent, children)[net EV-069]
resolved, unresolvednumberyes0counts[net EV-069]
show_completedbooleanyesfalse[net EV-069]
+
FieldTypeRequiredDefaultConstraints or enumSource
iduuidyes[net EV-069]
namestringyes"Checklist"[net EV-069]
items{name, resolved, assignee, parent, orderindex}[]no[]items can nest (parent, children)[net EV-069]
resolved, unresolvednumberyes0counts[net EV-069]
show_completedbooleanyesfalse[net EV-069]

Relations

-
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..1[net EV-069]
+
RelationTargetCardinalityOn deleteSource
onE-004 Taskn..1[net EV-069]

Lifecycle

Created empty at once → items added → items resolved (hidden behind "Show completed").

System fields

-
FieldSet whenSource
creator, date_createdcreate[net EV-069]
+
FieldSet whenSource
creator, date_createdcreate[net EV-069]

Rules

Not tested

  • Item assignees, nested items, templates.
-
E-012 Dependency

Product term: Dependency (waiting on / blocking) · Parent: E-004 · Status: reviewed

+
E-012 Dependency

Product term: Dependency (waiting on / blocking) · Parent: E-004 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
task_idstringyesthe blocked task[net EV-069]
depends_onstringyesthe blocking task[net EV-069]
typenumberyes[net EV-069]
lag_msnumbernonull[net EV-069]
+
FieldTypeRequiredDefaultConstraints or enumSource
task_idstringyesthe blocked task[net EV-069]
depends_onstringyesthe blocking task[net EV-069]
typenumberyes[net EV-069]
lag_msnumbernonull[net EV-069]

Relations

-
RelationTargetCardinalityOn deleteSource
betweenE-004 Taskn..n[net EV-069]
+
RelationTargetCardinalityOn deleteSource
betweenE-004 Taskn..n[net EV-069]

Lifecycle

Created from the Relate menu; removal not tested.

System fields

-
FieldSet whenSource
date_createdcreate[net EV-069]
+
FieldSet whenSource
date_createdcreate[net EV-069]

Rules

Not tested

  • Removing, dependency warnings on status change, scheduling shifts.
-
E-013 User

Product term: User · Parent: E-001 (member) · Status: reviewed

+
E-013 User

Product term: User · Parent: E-001 (member) · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idnumberyes[net EV-053]
username, initials, colorstringyes[net EV-053]
profilePictureurlno[net EV-053]
timezonestringyes[net EV-053]
countryISO codenoset by the Phone field flag menu[obs EV-131][net EV-112]
task layoutenumyesFull screenFull screen, Modal, Sidebar[obs EV-052]
+
FieldTypeRequiredDefaultConstraints or enumSource
idnumberyes[net EV-053]
username, initials, colorstringyes[net EV-053]
profilePictureurlno[net EV-053]
timezonestringyes[net EV-053]
countryISO codenoset by the Phone field flag menu[obs EV-131][net EV-112]
task layoutenumyesFull screenFull screen, Modal, Sidebar[obs EV-052]

Relations

-
RelationTargetCardinalityOn deleteSource
member ofE-001 Workspacen..n[obs EV-048]
+
RelationTargetCardinalityOn deleteSource
member ofE-001 Workspacen..n[obs EV-048]

Lifecycle

Not studied.

System fields

-
FieldSet whenSource
+
FieldSet whenSource

Rules

Not tested

  • Roles, guests, invitations (need a second person, L1).
-
E-014 HistoryItem

Product term: Activity entry (version change) · Parent: E-004 · Status: reviewed

+
E-014 HistoryItem

Product term: Activity entry (version change) · Parent: E-004 · Status: reviewed

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
history_idstring (numeric)yes[net EV-007][net EV-112]
fieldstringyes[net EV-007]
before, afteranyyes[net EV-007][net EV-112]
relationships{type, object_type}[]yestask-in-space, task-in-folder, task-in-list[net EV-007]
+
FieldTypeRequiredDefaultConstraints or enumSource
history_idstring (numeric)yes[net EV-007][net EV-112]
fieldstringyes[net EV-007]
before, afteranyyes[net EV-007][net EV-112]
relationships{type, object_type}[]yestask-in-space, task-in-folder, task-in-list[net EV-007]

Relations

-
RelationTargetCardinalityOn deleteSource
ofE-004 Taskn..1[net EV-007]
+
RelationTargetCardinalityOn deleteSource
ofE-004 Taskn..1[net EV-007]

Lifecycle

Append only.

System fields

-
FieldSet whenSource
dateevery write[net EV-007]
+
FieldSet whenSource
dateevery write[net EV-007]

Rules

Not tested

  • Retention, filters in the activity panel.

Permissions

The study ran with one account, the workspace owner, so only owner behavior and plan gates were observed. Roles below come from the docs; every cell without obs needs an L1 account with a second user (Q-010 covers required fields).

-
ActionOwnerAdminMemberGuestEvidence
Create, edit, delete custom fieldsyes (observed)yeswith "Manage Custom Fields"no[obs EV-080][doc SRC-006]
Open the Custom Field Manageryes (observed)yeswith "Manage Custom Fields"no[obs EV-098][doc SRC-006]
Make a field requiredBusiness plan and aboveBusiness plan and abovenono[obs EV-082][doc SRC-003]
Restore a deleted field from Trashyes (observed)yesnot documentedno[obs EV-129][doc SRC-004]
See a custom fieldyesyesyesif "Visible to Guests and Limited Members" is on[obs EV-081]
Per-task permission flagsabout 260 booleans returned with each task[net EV-053]
-

TypeScript types

// ClickUp data model as observed (2026-10-16). One exported type per E-### entity file, same field names.
+
ActionOwnerAdminMemberGuestEvidence
Create, edit, delete custom fieldsyes (observed)yeswith "Manage Custom Fields"no[obs EV-080][doc SRC-006]
Open the Custom Field Manageryes (observed)yeswith "Manage Custom Fields"no[obs EV-098][doc SRC-006]
Make a field requiredBusiness plan and aboveBusiness plan and abovenono[obs EV-082][doc SRC-003]
Restore a deleted field from Trashyes (observed)yesnot documentedno[obs EV-129][doc SRC-004]
See a custom fieldyesyesyesif "Visible to Guests and Limited Members" is on[obs EV-081]
Per-task permission flagsabout 260 booleans returned with each task[net EV-053]
+
TypeScript types
// ClickUp data model as observed (2026-10-16). One exported type per E-### entity file, same field names.
 // IDs are strings unless noted. Epoch times are milliseconds, often sent as strings.
 
 export type EpochMs = string;
@@ -989,8 +989,8 @@ 

TypeScript types

// ClickUp data model as observed
   after: unknown;
   relationships: { type: string; object_type: "space" | "folder" | "list" }[];
 }
-
-

Entity relationships (Mermaid)

erDiagram
+
+
Entity relationships mermaid
erDiagram
     %% E-001 to E-014. Names follow the product terms; see data-model/entities/.
     WORKSPACE ||--|{ SPACE : "has"
     WORKSPACE }|--|{ USER : "members"
@@ -1013,44 +1013,44 @@ 

Entity relationships (Mermaid)

erDiagram
     TASK ||--o{ DEPENDENCY : "waits on"
     TASK ||--o{ HISTORY_ITEM : "change log"
     USER ||--o{ COMMENT : "writes"
-
-

07

API

What the web app asks its server for each action, with the shape of the data and no real values.

IDs in paths are :id. Shapes and types only; no real values.

+
+

07API

What the web app asks its server for each action, with the shape of the data and no real values.

IDs in paths are :id. Shapes and types only; no real values.

The web app talks to a regional gateway, frontdoor-prod-<region>.clickup.com (the test workspace used eu-west-1-2), split by service path (/tasks/v1, /task-v3, /view/v1, /customFields/v2, /hierarchy/v3, /data/v3) [net EV-005]. Search goes to a separate GraphQL gateway frontdoor-search.clickup-eu.com/graphql/gateway [net EV-014]. This internal API is not the public API (api.clickup.com/api/v2, documented in SRC-023 to SRC-034); a clone needs only its behavior, not its paths.

Board view

-
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
POST/view/v1/genericViewBoard load; any view draft change (?fresh_req&include_empties&skip_max_length)the full view definition: id, name, type, parent{id,type}, visibility, settings{...}, grouping{field,dir,collapsed[],ignore}, divide{field,dir,collapsed[]}, sorting{fields[]}, filters{op,fields[],search,show_closed,...}, columns{fields[{field,pinned,hidden}]}, auto_save, ...{board{groups[{data{status,type}}]}, tasks, team_id, last_page, overall_calculations, permissions, _version_vector}[net EV-005][net EV-014]
POST/task-v3/experience/:workspace/tasks/bulkBoard load, refetch after edits, next page on column scroll{ids[], fields[], filterOmit, customFieldIds[], taskRelationshipTypes[], relatedTaskFields[], orderindexes{basic[], status[{listId}]}, rollupFields[], includeClosedSubtasksInRollup}{tasks[{status, data{task{...}}}], statuses[{status,type}], fields, list_status_ids_map, user_map, group_map, parent_task_map}[net EV-014]
POST/:id/access/:id/task/acls/bulk?expand_groups&include_parentsAfter refetching tasksnot capturednot captured[net EV-007]
GET/:id/core/:id/tasks/propertiesBoard load[net EV-005]
GET/customFields/v2/fieldBoard load[net EV-005]
GET/tasks/v1/tagBoard load[net EV-005]
PUT/tasks/v1/item?check_dependenciesCard priority{item_ids[], priority: "1".."4"}{assignees{add,rem}, followers{add,rem}, item_ids[], new_indexes{}, versions[{object_type, object_id, operation, data{changes[{field,before,after,history_id}], relationships[{type,object_type}]}, version, date_updated}], hist_ids{}, dependencies_adjusted[], schedulingData{changes[],reachedDependencyLimit,reachedSubtaskLimit}}[net EV-007]
PUT/tasks/v1/item?check_dependencies&check_remap_subtasksCard dates (sent when the picker closes){item_ids[], due_date: epoch-ms, start_date: epoch-ms or "", due_date_time: bool, start_date_time: bool, duration_is_elapsed: bool, duration{}}same as above[net EV-014]
PUT/tasks/v1/item?check_dependencies&check_resolvedMark complete{item_ids[], status: "<status name>"}same, plus orderindices[net EV-014]
PUT/tasks/v1/task/:id?check_dependencies&field_backlinksCard assignee{assignees{add[number], rem[]}}{task{...}, newHistIds, undo_order, dependencies_adjusted, version, schedulingData}[net EV-014]
POST/tasks/v1/tagCreate a tag from a card (on picker close){name, tag_fg: hex, tag_bg: hex, new: bool, task_ids[]}empty[net EV-014]
GET/data/v3/workspaces/:id/workweek_schedules/reference/workspace/:idOpening the date picker{data}[net EV-014]
GET/data/v3/workspaces/:id/schedule_exceptions/reference/workspace/:idOpening the date picker{data}[net EV-014]
+
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
POST/view/v1/genericViewBoard load; any view draft change (?fresh_req&include_empties&skip_max_length)the full view definition: id, name, type, parent{id,type}, visibility, settings{...}, grouping{field,dir,collapsed[],ignore}, divide{field,dir,collapsed[]}, sorting{fields[]}, filters{op,fields[],search,show_closed,...}, columns{fields[{field,pinned,hidden}]}, auto_save, ...{board{groups[{data{status,type}}]}, tasks, team_id, last_page, overall_calculations, permissions, _version_vector}[net EV-005][net EV-014]
POST/task-v3/experience/:workspace/tasks/bulkBoard load, refetch after edits, next page on column scroll{ids[], fields[], filterOmit, customFieldIds[], taskRelationshipTypes[], relatedTaskFields[], orderindexes{basic[], status[{listId}]}, rollupFields[], includeClosedSubtasksInRollup}{tasks[{status, data{task{...}}}], statuses[{status,type}], fields, list_status_ids_map, user_map, group_map, parent_task_map}[net EV-014]
POST/:id/access/:id/task/acls/bulk?expand_groups&include_parentsAfter refetching tasksnot capturednot captured[net EV-007]
GET/:id/core/:id/tasks/propertiesBoard load[net EV-005]
GET/customFields/v2/fieldBoard load[net EV-005]
GET/tasks/v1/tagBoard load[net EV-005]
PUT/tasks/v1/item?check_dependenciesCard priority{item_ids[], priority: "1".."4"}{assignees{add,rem}, followers{add,rem}, item_ids[], new_indexes{}, versions[{object_type, object_id, operation, data{changes[{field,before,after,history_id}], relationships[{type,object_type}]}, version, date_updated}], hist_ids{}, dependencies_adjusted[], schedulingData{changes[],reachedDependencyLimit,reachedSubtaskLimit}}[net EV-007]
PUT/tasks/v1/item?check_dependencies&check_remap_subtasksCard dates (sent when the picker closes){item_ids[], due_date: epoch-ms, start_date: epoch-ms or "", due_date_time: bool, start_date_time: bool, duration_is_elapsed: bool, duration{}}same as above[net EV-014]
PUT/tasks/v1/item?check_dependencies&check_resolvedMark complete{item_ids[], status: "<status name>"}same, plus orderindices[net EV-014]
PUT/tasks/v1/task/:id?check_dependencies&field_backlinksCard assignee{assignees{add[number], rem[]}}{task{...}, newHistIds, undo_order, dependencies_adjusted, version, schedulingData}[net EV-014]
POST/tasks/v1/tagCreate a tag from a card (on picker close){name, tag_fg: hex, tag_bg: hex, new: bool, task_ids[]}empty[net EV-014]
GET/data/v3/workspaces/:id/workweek_schedules/reference/workspace/:idOpening the date picker{data}[net EV-014]
GET/data/v3/workspaces/:id/schedule_exceptions/reference/workspace/:idOpening the date picker{data}[net EV-014]

Every task write returns a versions[] array with the field changes (before, after, history_id) and the task's place in the hierarchy (task-in-space, task-in-folder, task-in-list) [net EV-007]. A clone can use the same pattern: one change log entry per field write, which also feeds the activity feed and undo.

Enum samples seen: priority "2" (High); status.type open, custom, closed; versions[].object_type task [net EV-007][net EV-014].

Custom fields

-
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
POST/customFields/v2/field?ignore_existingCreate in the field form{name, description, type, type_config{...per type}, required, required_on_subtasks, pinned, hide_from_guests, private, permission_level, members[], groups[], default_value, subcategory_id}the field: {id(uuid), name, type, type_id, type_config, userid, date_created, team_id, deleted, required, pinned, private, linked_subcategory, automation_count, ...}[net EV-099]
PUT/field/v3/experience/workspaces/:id/fields/:id/locationsRight after create{new_locations[{parent{type: 6 (List), id}, required, required_on_subtasks, hide_from_guests}]}204[net EV-099]
PUT/customFields/v2/field/:idSaving a formula (field-level)the field with type_config{formula, simple, version, is_dynamic, return_types[], calculation_state}, entity{type: "subcategory", id}the field (type_id 17 for formula)[net EV-112]
GET/customFields/v2/field?subcategory_id&hierarchy_fields&incl_belowOpening a task or the formfields of the location[net EV-099]
POST/customFields/v1/task/:id/field/:idSetting any value{value, value_options?, value_richtext}; value per type in EV-112{historyIds[], suppressedHistoryCount, version{object_type: task, data{changes[{field, before, after}], relationships[]}}}[net EV-112]
DELETE/customFields/v1/task/:id/field/:idClearing a valuenoneas above[net EV-112]
GET/entitlements/v1/team/:id/entitlements/custom_field_valuesAfter each value is set{type: "counter", entitled, planLimits, limit, usage, usageLeft}[net EV-112]
PUT/user/v1/userPicking a country in a Phone fieldthe user's profile with the countrynot recorded[obs EV-131][net EV-112]
(DELETE)/customFields/v2/field/:id?delete_all=trueDelete field after the confirm dialogmethod inferred from the CORS preflightnot recorded[net EV-112]
+
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
POST/customFields/v2/field?ignore_existingCreate in the field form{name, description, type, type_config{...per type}, required, required_on_subtasks, pinned, hide_from_guests, private, permission_level, members[], groups[], default_value, subcategory_id}the field: {id(uuid), name, type, type_id, type_config, userid, date_created, team_id, deleted, required, pinned, private, linked_subcategory, automation_count, ...}[net EV-099]
PUT/field/v3/experience/workspaces/:id/fields/:id/locationsRight after create{new_locations[{parent{type: 6 (List), id}, required, required_on_subtasks, hide_from_guests}]}204[net EV-099]
PUT/customFields/v2/field/:idSaving a formula (field-level)the field with type_config{formula, simple, version, is_dynamic, return_types[], calculation_state}, entity{type: "subcategory", id}the field (type_id 17 for formula)[net EV-112]
GET/customFields/v2/field?subcategory_id&hierarchy_fields&incl_belowOpening a task or the formfields of the location[net EV-099]
POST/customFields/v1/task/:id/field/:idSetting any value{value, value_options?, value_richtext}; value per type in EV-112{historyIds[], suppressedHistoryCount, version{object_type: task, data{changes[{field, before, after}], relationships[]}}}[net EV-112]
DELETE/customFields/v1/task/:id/field/:idClearing a valuenoneas above[net EV-112]
GET/entitlements/v1/team/:id/entitlements/custom_field_valuesAfter each value is set{type: "counter", entitled, planLimits, limit, usage, usageLeft}[net EV-112]
PUT/user/v1/userPicking a country in a Phone fieldthe user's profile with the countrynot recorded[obs EV-131][net EV-112]
(DELETE)/customFields/v2/field/:id?delete_all=trueDelete field after the confirm dialogmethod inferred from the CORS preflightnot recorded[net EV-112]

Type strings recorded in this study: drop_down, number, currency [net EV-099] and formula (type_id 17) [net EV-112]. The other internal type strings were not recorded; the public API names 17 of them [doc SRC-001].

Not captured

  • Task creation from the inline form and status creation (Add group): the recorder was not installed at that moment.
  • WebSocket frames (realtime): the socket opens before a page script can wrap it; realtime is recorded as UI behavior (R-018).
-

08

Design system

Colors, typography, spacing, radius, shadow and motion as the product uses them.

Theme(s) studied: dark only (the user's preference; light was not switched on, to avoid a personal-preference write). Window: 1710 × 981 CSS px, device pixel ratio 2.

+

08Design system

Colors, typography, spacing, radius, shadow and motion as the product uses them.

Color

background.mainrgb(17,17,17)--cu-background-main
background.subtlergb(25,25,25)--cu-background-subtle
background.elevatedrgba(255,255,255,.035)--cu-background-elevated
background.hoverrgba(255,255,255,.07)--cu-background-main-hover
background.tooltiprgb(42,42,42)--cu-background-tooltip
background.successrgb(48,164,108)--cu-background-success
background.warningrgb(255,197,61)--cu-background-warning
background.dangerrgb(210,30,36)--cu-background-danger
content.defaultrgb(238,238,238)--cu-content-default
content.secondaryrgb(180,180,180)--cu-content-secondary
content.tertiaryrgb(123,123,123)--cu-content-tertiary
content.placeholderrgb(110,110,110)--cu-content-placeholder
content.dangerrgb(255,133,137)--cu-content-danger
content.warningrgb(255,204,77)--cu-content-warning
border.defaultrgb(42,42,42)--cu-border-default
border.lowrgb(34,34,34)--cu-border-low-contrast
border.inputrgb(110,110,110)--cu-border-input
brandrgb(102,71,240)
status.completergb(44,140,94)

Theme(s) studied: dark only (the user's preference; light was not switched on, to avoid a personal-preference write). Window: 1710 × 981 CSS px, device pixel ratio 2.

Values come from tokens.js and element styles on the board [obs EV-035]. Variables are declared on body.dark-theme, so a clone should scope theme tokens to a class, not :root. The clone must pick its own names and palette: this table is a reference for density and contrast, not something to copy.

Color

-
TokenLightDarkVariableUsed forEvidence
background.mainnot capturedrgb(17,17,17)--cu-background-mainpage[obs EV-035]
background.subtlenot capturedrgb(25,25,25)--cu-background-subtlecards, menus[obs EV-035]
background.elevatednot capturedrgba(255,255,255,.035)--cu-background-elevatedraised surfaces[obs EV-035]
background.hovernot capturedrgba(255,255,255,.07)--cu-background-main-hoverhover[obs EV-035]
background.tooltipnot capturedrgb(42,42,42)--cu-background-tooltiptooltips[obs EV-035]
background.successnot capturedrgb(48,164,108)--cu-background-successsuccess fills[obs EV-035]
background.warningnot capturedrgb(255,197,61)--cu-background-warningwarning fills[obs EV-035]
background.dangernot capturedrgb(210,30,36)--cu-background-dangerdelete buttons[obs EV-035][obs EV-126]
content.defaultnot capturedrgb(238,238,238)--cu-content-defaulttext, card titles[obs EV-035]
content.secondarynot capturedrgb(180,180,180)--cu-content-secondarysecondary text[obs EV-035]
content.tertiarynot capturedrgb(123,123,123)--cu-content-tertiarymeta text[obs EV-035]
content.placeholdernot capturedrgb(110,110,110)--cu-content-placeholderplaceholders[obs EV-035]
content.dangernot capturedrgb(255,133,137)--cu-content-dangeroverdue dates[obs EV-035][obs EV-010]
content.warningnot capturedrgb(255,204,77)--cu-content-warningdue today[obs EV-035][obs EV-010]
border.defaultnot capturedrgb(42,42,42)--cu-border-defaultborders[obs EV-035]
border.lownot capturedrgb(34,34,34)--cu-border-low-contrastcard field toggles[obs EV-035]
border.inputnot capturedrgb(110,110,110)--cu-border-inputinputs[obs EV-035]
brandnot capturedrgb(102,71,240)not mappedin-progress status, links, checked boxes[obs EV-035][obs EV-121]
status.completenot capturedrgb(44,140,94)not mappedclosed status pill[obs EV-035]
+
TokenLightDarkVariableUsed forEvidence
background.mainnot capturedrgb(17,17,17)--cu-background-mainpage[obs EV-035]
background.subtlenot capturedrgb(25,25,25)--cu-background-subtlecards, menus[obs EV-035]
background.elevatednot capturedrgba(255,255,255,.035)--cu-background-elevatedraised surfaces[obs EV-035]
background.hovernot capturedrgba(255,255,255,.07)--cu-background-main-hoverhover[obs EV-035]
background.tooltipnot capturedrgb(42,42,42)--cu-background-tooltiptooltips[obs EV-035]
background.successnot capturedrgb(48,164,108)--cu-background-successsuccess fills[obs EV-035]
background.warningnot capturedrgb(255,197,61)--cu-background-warningwarning fills[obs EV-035]
background.dangernot capturedrgb(210,30,36)--cu-background-dangerdelete buttons[obs EV-035][obs EV-126]
content.defaultnot capturedrgb(238,238,238)--cu-content-defaulttext, card titles[obs EV-035]
content.secondarynot capturedrgb(180,180,180)--cu-content-secondarysecondary text[obs EV-035]
content.tertiarynot capturedrgb(123,123,123)--cu-content-tertiarymeta text[obs EV-035]
content.placeholdernot capturedrgb(110,110,110)--cu-content-placeholderplaceholders[obs EV-035]
content.dangernot capturedrgb(255,133,137)--cu-content-dangeroverdue dates[obs EV-035][obs EV-010]
content.warningnot capturedrgb(255,204,77)--cu-content-warningdue today[obs EV-035][obs EV-010]
border.defaultnot capturedrgb(42,42,42)--cu-border-defaultborders[obs EV-035]
border.lownot capturedrgb(34,34,34)--cu-border-low-contrastcard field toggles[obs EV-035]
border.inputnot capturedrgb(110,110,110)--cu-border-inputinputs[obs EV-035]
brandnot capturedrgb(102,71,240)not mappedin-progress status, links, checked boxes[obs EV-035][obs EV-121]
status.completenot capturedrgb(44,140,94)not mappedclosed status pill[obs EV-035]

Typography

-
TokenFamilySizeWeightLine heightUsed forEvidence
font.familysystem UI stack (-apple-system, Segoe UI Variable Text, Roboto, Helvetica, Arial)everything; no web fonts[obs EV-035]
size scale6, 8, 10, 11, 12, 14, 16, 18 px (--cu-font-size-1..8)[obs EV-035]
card.titlesystem14px50020pxcard titles[obs EV-035]
status.pillsystem11px50011pxstatus pills[obs EV-035]
body.smallsystem12px50016pxmeta and chips[obs EV-035]
weights400, 500, 600, 700[obs EV-035]
+
TokenFamilySizeWeightLine heightUsed forEvidence
font.familysystem UI stack (-apple-system, Segoe UI Variable Text, Roboto, Helvetica, Arial)everything; no web fonts[obs EV-035]
size scale6, 8, 10, 11, 12, 14, 16, 18 px (--cu-font-size-1..8)[obs EV-035]
card.titlesystem14px50020pxcard titles[obs EV-035]
status.pillsystem11px50011pxstatus pills[obs EV-035]
body.smallsystem12px50016pxmeta and chips[obs EV-035]
weights400, 500, 600, 700[obs EV-035]

Spacing, radius, shadow

-
TokenValueVariableUsed forEvidence
space.12pxtight gaps[obs EV-035]
space.24pxmost common gap[obs EV-035]
space.38pxcolumn header padding, footer gap[obs EV-035]
radius.small6pxpills, field toggles (most common)[obs EV-035]
radius.card10pxboard cards[obs EV-035]
radius.pill666pxround pills[obs EV-035]
shadow.card0 0 1px rgba(255,255,255,.33), 0 1px 2px rgba(0,0,0,.055)cards[obs EV-035]
shadow.popover0 4px 6px -1px rgba(0,0,0,.1), 0 2px 4px -2px rgba(0,0,0,.1)popovers[obs EV-035]
focus.ring0 0 0 1px rgb(238,238,238), 0 0 0 3px rgb(49,49,49)card field toggles[obs EV-035][obs EV-033]
border.size1px, 2px--cu-border-size-1/2[obs EV-035]
+
TokenValueVariableUsed forEvidence
space.12pxtight gaps[obs EV-035]
space.24pxmost common gap[obs EV-035]
space.38pxcolumn header padding, footer gap[obs EV-035]
radius.small6pxpills, field toggles (most common)[obs EV-035]
radius.card10pxboard cards[obs EV-035]
radius.pill666pxround pills[obs EV-035]
shadow.card0 0 1px rgba(255,255,255,.33), 0 1px 2px rgba(0,0,0,.055)cards[obs EV-035]
shadow.popover0 4px 6px -1px rgba(0,0,0,.1), 0 2px 4px -2px rgba(0,0,0,.1)popovers[obs EV-035]
focus.ring0 0 0 1px rgb(238,238,238), 0 0 0 3px rgb(49,49,49)card field toggles[obs EV-035][obs EV-033]
border.size1px, 2px--cu-border-size-1/2[obs EV-035]

Motion

-
TokenDurationEasingUsed forEvidence
motion.pop0.125scubic-bezier(0.17,0.67,0.55,1.09)scale on press[obs EV-035]
motion.slide0.2scubic-bezier(0.785,0.135,0.15,0.86)panels, min-width[obs EV-035]
motion.move0.3scubic-bezier(0.17,0.67,0.55,1.09)transforms[obs EV-035]
+
TokenDurationEasingUsed forEvidence
motion.pop0.125scubic-bezier(0.17,0.67,0.55,1.09)scale on press[obs EV-035]
motion.slide0.2scubic-bezier(0.785,0.135,0.15,0.86)panels, min-width[obs EV-035]
motion.move0.3scubic-bezier(0.17,0.67,0.55,1.09)transforms[obs EV-035]

Z-index layers

-
LayerValueUsed forEvidence
base1, 2stacked card parts[obs EV-035]
panels15, 700sticky headers, side panels[obs EV-035]
overlays999, 1000popovers and dialogs[obs EV-035]
+
LayerValueUsed forEvidence
base1, 2stacked card parts[obs EV-035]
panels15, 700sticky headers, side panels[obs EV-035]
overlays999, 1000popovers and dialogs[obs EV-035]

Icons

-
NameSizeWhere usedEvidence
card field toggles24 × 24 boxassignee, date, priority, tag on cards[obs EV-035]
custom field type iconsabout 16 pxFields section rows and card rows[obs EV-117][obs EV-121]
+
NameSizeWhere usedEvidence
card field toggles24 × 24 boxassignee, date, priority, tag on cards[obs EV-035]
custom field type iconsabout 16 pxFields section rows and card rows[obs EV-117][obs EV-121]

Breakpoints and layout

-
WidthChangeEvidence
1710 CSS pxColumn 264 px (Medium cards), card 246 px[obs EV-035][obs EV-046]
Other widthsNot tested (the user's window was not resized)
-

09

Build plan

What to build and in what order, the acceptance tests, and what to copy, avoid and improve.

Updated: 2026-10-16 · Status: draft for the three studied areas

+
WidthChangeEvidence
1710 CSS pxColumn 264 px (Medium cards), card 246 px[obs EV-035][obs EV-046]
Other widthsNot tested (the user's window was not resized)
+

09Build plan

What to build and in what order, the acceptance tests, and what to copy, avoid and improve.

Updated: 2026-10-16 · Status: draft for the three studied areas

Problem and users

Small and medium businesses in Brazil that plan and track team work: an owner or manager sets up lists and fields, a few team members move tasks across a board and fill in task details. They want a board that reflects their own workflow (statuses), task records they can extend with their own fields (money in BRL, phone numbers, addresses, dropdowns) and an interface in Portuguese with Brazilian formats.

Launch blockers

From clone/barriers.md, severity blocks launch and adds lead time, with who clears each one and when.

-
BarrierSeverityOwnerStart by
BR-001 LGPD processor duties and transfersblocks launchFounder with counselWeek 1
BR-002 NFS-e national standard and CBS/IBS fieldsblocks launchFounder with accountant and an invoicing providerWeek 1
BR-010 Own name and visual identityblocks launchFounder and designerWeek 1
BR-011 ClickUp terms reviewadds lead timeCounsel (Q-005)Before any public launch
BR-003 Recurring billing (Pix Automático, boleto, cards)adds lead timeFounder with a payment providerWeek 2
BR-005 Microsoft publisher verificationadds lead timeEngineeringOnly if Outlook sync is in the first release
BR-006 Slack reviewadds lead timeEngineeringAfter 10 active workspaces
+
BarrierSeverityOwnerStart by
BR-001 LGPD processor duties and transfersblocks launchFounder with counselWeek 1
BR-002 NFS-e national standard and CBS/IBS fieldsblocks launchFounder with accountant and an invoicing providerWeek 1
BR-010 Own name and visual identityblocks launchFounder and designerWeek 1
BR-011 ClickUp terms reviewadds lead timeCounsel (Q-005)Before any public launch
BR-003 Recurring billing (Pix Automático, boleto, cards)adds lead timeFounder with a payment providerWeek 2
BR-005 Microsoft publisher verificationadds lead timeEngineeringOnly if Outlook sync is in the first release
BR-006 Slack reviewadds lead timeEngineeringAfter 10 active workspaces

Core loop

  1. Create a list with statuses; the board shows one column per status (R-001).
  2. Create tasks in a column (R-010), edit fields on the card (R-004 to R-007, R-017), move them by drag or by completing (R-003, R-019).
  3. Open a task (R-020): description (R-025), subtasks (R-028), checklist (R-030), dependencies (R-029), comments (R-026), custom fields (R-043 to R-047).
  4. Define the list's own fields (R-033) and show them on cards (R-048 to R-050).

Scope by priority

-
PriorityFeatureRulesScreensNotes
P1F-001 Board columns by statusR-001, R-002, R-009, R-011S-001
P1F-002 Card and inline editsR-003 to R-007, R-017S-001
P1F-003 Create in a columnR-010S-001
P1F-004 Customize view, draftsR-008, R-012 to R-015S-001Decide whether to keep drafts (see implications)
P1F-005 Drag and dropR-019S-001From docs only; Q-003
P1F-009 to F-014 Task viewR-020 to R-032S-002
P1F-015 Fields sectionR-043, R-044S-002
P1F-016 Field types and formR-033, R-034, R-040S-002, S-003Start with the 17 non-AI types the API documents
P1F-017 Values per typeR-035 to R-038, R-045 to R-047S-002BRL and Brazilian phone formats by default
P1F-018 Fields on cardsR-048 to R-050S-001
P1F-019 Required fieldsR-041, R-042S-002Offer on every plan (implications)
P1F-020 Delete, Trash, restoreR-051 to R-054S-002, S-00530-day Trash with values kept
P1F-021 Field manager and scopeR-055S-003List and Space locations first
P2F-007 Many itemsR-016S-001Paging per column
P2F-024, F-025 Statuses and tagsR-011, R-006S-001
P2F-026 RealtimeR-018S-001BR-013
P3F-022 Usage limitsR-037Only if the pricing needs a field-use cap
P3F-023 AI fieldsBR-014; later
+
PriorityFeatureRulesScreensNotes
P1F-001 Board columns by statusR-001, R-002, R-009, R-011S-001
P1F-002 Card and inline editsR-003 to R-007, R-017S-001
P1F-003 Create in a columnR-010S-001
P1F-004 Customize view, draftsR-008, R-012 to R-015S-001Decide whether to keep drafts (see implications)
P1F-005 Drag and dropR-019S-001From docs only; Q-003
P1F-009 to F-014 Task viewR-020 to R-032S-002
P1F-015 Fields sectionR-043, R-044S-002
P1F-016 Field types and formR-033, R-034, R-040S-002, S-003Start with the 17 non-AI types the API documents
P1F-017 Values per typeR-035 to R-038, R-045 to R-047S-002BRL and Brazilian phone formats by default
P1F-018 Fields on cardsR-048 to R-050S-001
P1F-019 Required fieldsR-041, R-042S-002Offer on every plan (implications)
P1F-020 Delete, Trash, restoreR-051 to R-054S-002, S-00530-day Trash with values kept
P1F-021 Field manager and scopeR-055S-003List and Space locations first
P2F-007 Many itemsR-016S-001Paging per column
P2F-024, F-025 Statuses and tagsR-011, R-006S-001
P2F-026 RealtimeR-018S-001BR-013
P3F-022 Usage limitsR-037Only if the pricing needs a field-use cap
P3F-023 AI fieldsBR-014; later

Non-goals

  • Docs, chat, goals, dashboards, automations, time tracking, other view types (out of the studied scope).
  • AI fields and AI suggestions in the first release.
  • Copying ClickUp's names, icons, colors or copy (BR-010; see clone/implications.md).

Data model

@@ -1060,17 +1060,17 @@

Build order

Open questions

See questions.md, especially Q-003 (drag details), Q-006 (what Brazilian buyers require), Q-008 to Q-010 (limits and required fields).

Acceptance tests

One test per rule the clone must reproduce. A test passes when the clone shows the same behavior as the rule. Rules marked "improve" in clone/implications.md are reproduced in their improved form.

-
TestRuleFeatureSummaryClone status
T-001R-001F-001The board shows one column per status of the list, empty ones included, in status ordertodo
T-002R-002F-001Column counts include every task of the group; the sidebar list count leaves out closed taskstodo
T-003R-003F-002Mark complete on a card moves the task to the closed status and offers Undotodo
T-004R-004F-002The card date chip uses relative text and an urgency colortodo
T-005R-005F-002The date picker saves when it closes, not when a day is clickedtodo
T-006R-006F-025Typing an unknown tag on a card creates a Space tag and applies it when the picker closestodo
T-007R-007F-002Assigning yourself prompts to add the task to your personal prioritiestodo
T-008R-008F-004View changes are drafts until Save view; a reload drops them without warningtodo
T-009R-009F-001The column menu offers Archive all and Select all only for columns with taskstodo
T-010R-010F-003A task created inside a column takes that column's status and the form stays opentodo
T-011R-011F-024Adding a group on a list that inherits statuses asks where the new status appliestodo
T-012R-012F-004Grouping by a field other than status adds a status chip to cards and a column for empty valuestodo
T-013R-013F-004A subgroup splits the board into collapsible swimlanestodo
T-014R-014F-004Card size sets the column widthtodo
T-015R-015F-004Show empty fields and Stack fields change the card bodytodo
T-016R-016F-007Columns load tasks in pages while scrollingtodo
T-017R-017F-002Priority has four fixed levels stored as numberstodo
T-018R-018F-026Changes appear in other open tabs without reloadtodo
T-019R-019F-005Dragging a card to another column changes its group valuetodo
T-020R-033F-016A field created from a task belongs to that task's listtodo
T-021R-034F-016The type menu puts popular and AI types first; Rollup is not a type of its owntodo
T-022R-035F-016, F-017Number and money formats are set per field, not by the user's languagetodo
T-023R-036F-017Picking a country in a Phone field changes the user's profile countrytodo
T-024R-037F-022On Free Forever each value written counts once against 60 uses per workspacetodo
T-025R-038F-016, F-017A Formula field is defined once per field and takes the money format of a money inputtodo
T-026R-039F-016, F-017, F-018Tasks and Relationship fields live in the Relate menu, not in the Fields sectiontodo
T-027R-040F-016A Relationship field must point at another listtodo
T-028R-041F-019Required and Pinned do nothing on Free Forever except point to an upgradetodo
T-029R-042F-019A required field blocks task creation where it is used (documented)todo
T-030R-043F-015The task view lists a location's fields in one Fields sectiontodo
T-031R-044F-017Each value saves on its own and adds an activity linetodo
T-032R-045F-017Each type has its own editor in the Fields sectiontodo
T-033R-046F-017Location values store the address and the coordinatestodo
T-034R-047F-017A typed signature is drawn in a script font and records who signedtodo
T-035R-048F-018On a card every shown custom field takes its own row with the type icontodo
T-036R-049F-018Custom field values can be edited on the cardtodo
T-037R-050F-018Showing custom fields on cards is a view drafttodo
T-038R-051F-020Deleting a field warns with the task count and sends it to Trash without Undotodo
T-039R-052F-020Restoring a field from Trash brings its values backtodo
T-040R-053F-020Trash holds deleted lists, tasks, tags and fields for 30 daystodo
T-041R-054F-020, F-021Deleting a list takes its list-level fields with ittodo
T-042R-055F-021The Custom Field Manager groups fields by type and lists their locationstodo
T-043R-020F-009Clicking a card opens the task at its own URL, over the boardtodo
T-044R-021F-009The task layout is a personal preference shared by every task and workspacetodo
T-045R-022F-009The header arrows step through tasks in the board's ordertodo
T-046R-023F-009The status picker groups statuses by typetodo
T-047R-024F-009The next-status arrow moves a task one status forwardtodo
T-048R-025F-010The description saves while typing, and "- " starts a bullet listtodo
T-049R-026F-014A comment posts to the activity stream; the composer stays empty for the nexttodo
T-050R-027F-009Opening and using a task marks it as viewedtodo
T-051R-028F-011Subtasks are created inline and show as a table with a progress counttodo
T-052R-029F-013A dependency shows on both tasks and on both cardstodo
T-053R-030F-012Create checklist creates an empty checklist at oncetodo
T-054R-031F-012Resolved checklist items hide behind "Show completed" and update countstodo
T-055R-032F-009Escape in an empty inline input closes the task viewtodo
+
TestRuleFeatureSummaryClone status
T-001R-001F-001The board shows one column per status of the list, empty ones included, in status ordertodo
T-002R-002F-001Column counts include every task of the group; the sidebar list count leaves out closed taskstodo
T-003R-003F-002Mark complete on a card moves the task to the closed status and offers Undotodo
T-004R-004F-002The card date chip uses relative text and an urgency colortodo
T-005R-005F-002The date picker saves when it closes, not when a day is clickedtodo
T-006R-006F-025Typing an unknown tag on a card creates a Space tag and applies it when the picker closestodo
T-007R-007F-002Assigning yourself prompts to add the task to your personal prioritiestodo
T-008R-008F-004View changes are drafts until Save view; a reload drops them without warningtodo
T-009R-009F-001The column menu offers Archive all and Select all only for columns with taskstodo
T-010R-010F-003A task created inside a column takes that column's status and the form stays opentodo
T-011R-011F-024Adding a group on a list that inherits statuses asks where the new status appliestodo
T-012R-012F-004Grouping by a field other than status adds a status chip to cards and a column for empty valuestodo
T-013R-013F-004A subgroup splits the board into collapsible swimlanestodo
T-014R-014F-004Card size sets the column widthtodo
T-015R-015F-004Show empty fields and Stack fields change the card bodytodo
T-016R-016F-007Columns load tasks in pages while scrollingtodo
T-017R-017F-002Priority has four fixed levels stored as numberstodo
T-018R-018F-026Changes appear in other open tabs without reloadtodo
T-019R-019F-005Dragging a card to another column changes its group valuetodo
T-020R-033F-016A field created from a task belongs to that task's listtodo
T-021R-034F-016The type menu puts popular and AI types first; Rollup is not a type of its owntodo
T-022R-035F-016, F-017Number and money formats are set per field, not by the user's languagetodo
T-023R-036F-017Picking a country in a Phone field changes the user's profile countrytodo
T-024R-037F-022On Free Forever each value written counts once against 60 uses per workspacetodo
T-025R-038F-016, F-017A Formula field is defined once per field and takes the money format of a money inputtodo
T-026R-039F-016, F-017, F-018Tasks and Relationship fields live in the Relate menu, not in the Fields sectiontodo
T-027R-040F-016A Relationship field must point at another listtodo
T-028R-041F-019Required and Pinned do nothing on Free Forever except point to an upgradetodo
T-029R-042F-019A required field blocks task creation where it is used (documented)todo
T-030R-043F-015The task view lists a location's fields in one Fields sectiontodo
T-031R-044F-017Each value saves on its own and adds an activity linetodo
T-032R-045F-017Each type has its own editor in the Fields sectiontodo
T-033R-046F-017Location values store the address and the coordinatestodo
T-034R-047F-017A typed signature is drawn in a script font and records who signedtodo
T-035R-048F-018On a card every shown custom field takes its own row with the type icontodo
T-036R-049F-018Custom field values can be edited on the cardtodo
T-037R-050F-018Showing custom fields on cards is a view drafttodo
T-038R-051F-020Deleting a field warns with the task count and sends it to Trash without Undotodo
T-039R-052F-020Restoring a field from Trash brings its values backtodo
T-040R-053F-020Trash holds deleted lists, tasks, tags and fields for 30 daystodo
T-041R-054F-020, F-021Deleting a list takes its list-level fields with ittodo
T-042R-055F-021The Custom Field Manager groups fields by type and lists their locationstodo
T-043R-020F-009Clicking a card opens the task at its own URL, over the boardtodo
T-044R-021F-009The task layout is a personal preference shared by every task and workspacetodo
T-045R-022F-009The header arrows step through tasks in the board's ordertodo
T-046R-023F-009The status picker groups statuses by typetodo
T-047R-024F-009The next-status arrow moves a task one status forwardtodo
T-048R-025F-010The description saves while typing, and "- " starts a bullet listtodo
T-049R-026F-014A comment posts to the activity stream; the composer stays empty for the nexttodo
T-050R-027F-009Opening and using a task marks it as viewedtodo
T-051R-028F-011Subtasks are created inline and show as a table with a progress counttodo
T-052R-029F-013A dependency shows on both tasks and on both cardstodo
T-053R-030F-012Create checklist creates an empty checklist at oncetodo
T-054R-031F-012Resolved checklist items hide behind "Show completed" and update countstodo
T-055R-032F-009Escape in an empty inline input closes the task viewtodo

Copy

-
AreaItemWhyRefs
BoardOne column per status, empty columns shown, counts per columnClear picture of the workflow at a glanceR-001, R-002
BoardInline edits on cards with optimistic updates and Undo on completeFast triage without opening tasksR-003, R-017, R-024
BoardCreate a task inside a column takes that column's statusNatural for kanban usersR-010
Task viewEvery field saves on its own; one activity line per change with old and new valueNo lost edits, full audit trailR-044, E-014
Custom fieldsNumber and money format per field; BRL with Brazilian separatorsBrazilian SMBs need R$ 1.234,56 by defaultR-035
Custom fieldsLocation with address plus coordinatesField service and sales visitsR-046
Custom fieldsDelete goes to a 30-day Trash and restore brings values backSafe cleanupR-051, R-052
DataOne change record per field write (versions[] with before and after)Feeds activity, undo and webhooksE-014
+
AreaItemWhyRefs
BoardOne column per status, empty columns shown, counts per columnClear picture of the workflow at a glanceR-001, R-002
BoardInline edits on cards with optimistic updates and Undo on completeFast triage without opening tasksR-003, R-017, R-024
BoardCreate a task inside a column takes that column's statusNatural for kanban usersR-010
Task viewEvery field saves on its own; one activity line per change with old and new valueNo lost edits, full audit trailR-044, E-014
Custom fieldsNumber and money format per field; BRL with Brazilian separatorsBrazilian SMBs need R$ 1.234,56 by defaultR-035
Custom fieldsLocation with address plus coordinatesField service and sales visitsR-046
Custom fieldsDelete goes to a 30-day Trash and restore brings values backSafe cleanupR-051, R-052
DataOne change record per field write (versions[] with before and after)Feeds activity, undo and webhooksE-014

Avoid

-
AreaItemWhyRefs
Custom fieldsSaving the user's profile country from a phone field's flag menuA side effect the user cannot see or expectR-036, B-013
Custom fieldsToggles that silently refuse to switch on (Required on the free plan)Feels broken; say why or hide itR-041, B-014
Custom fieldsRelationship-type fields that live outside the Fields sectionUsers look for all fields in one placeR-039, B-018
BoardView drafts dropped on reload without a warningLost workR-008, B-001
Task viewEscape in an inline input closing the whole taskLost contextR-032, B-010
TrashSearch still listing deleted tasksConfusing after cleanupB-016
PricingCharging for Tag Manager or Required fields in the basic tiersSmall teams need both to keep data cleanB-017, R-041
BrandClickUp names, icons, colors and copyTrademark and look and feel (BR-010)BR-010
+
AreaItemWhyRefs
Custom fieldsSaving the user's profile country from a phone field's flag menuA side effect the user cannot see or expectR-036, B-013
Custom fieldsToggles that silently refuse to switch on (Required on the free plan)Feels broken; say why or hide itR-041, B-014
Custom fieldsRelationship-type fields that live outside the Fields sectionUsers look for all fields in one placeR-039, B-018
BoardView drafts dropped on reload without a warningLost workR-008, B-001
Task viewEscape in an inline input closing the whole taskLost contextR-032, B-010
TrashSearch still listing deleted tasksConfusing after cleanupB-016
PricingCharging for Tag Manager or Required fields in the basic tiersSmall teams need both to keep data cleanB-017, R-041
BrandClickUp names, icons, colors and copyTrademark and look and feel (BR-010)BR-010

Improve

-
AreaItemHowRefs
Custom fieldsRequired fieldsOffer on all plans; show which fields are missing when a task is createdR-042, Q-010
Custom fieldsDelete fieldShow the task count at once, offer Undo in the toastR-051, B-015
Custom fieldsPhoneDefault country from the workspace (Brazil), never from a field editR-036
BoardDrag and dropKeyboard alternative to move a card (status menu, shortcuts)R-019, B-005
BoardView draftsWarn before leaving with unsaved view changes, or autosave personal viewsR-008
AccessibilityCard controls and field rowsAccessible names and visible focus on every controlB-004
LocalizationPortuguese UI, BRL, dd/mm/yyyy, Brazilian phone masks by defaultTarget marketR-035
-

10

Before you launch

Approvals, licenses and certifications to start early, and what a new product cannot copy. Building can start now; these decide when you can sell.

Clone target market: small and medium businesses in Brazil (see 00-charter.md). Scope: the board, the task view and custom fields, plus what any SaaS needs to sell in Brazil. Not legal advice. A legal reading without a source is [inf] with a question for counsel in questions.md.

+
AreaItemHowRefs
Custom fieldsRequired fieldsOffer on all plans; show which fields are missing when a task is createdR-042, Q-010
Custom fieldsDelete fieldShow the task count at once, offer Undo in the toastR-051, B-015
Custom fieldsPhoneDefault country from the workspace (Brazil), never from a field editR-036
BoardDrag and dropKeyboard alternative to move a card (status menu, shortcuts)R-019, B-005
BoardView draftsWarn before leaving with unsaved view changes, or autosave personal viewsR-008
AccessibilityCard controls and field rowsAccessible names and visible focus on every controlB-004
LocalizationPortuguese UI, BRL, dd/mm/yyyy, Brazilian phone masks by defaultTarget marketR-035
+

10Before you launch

Approvals, licenses and certifications to start early, and what a new product cannot copy. Building can start now; these decide when you can sell.

Clone target market: small and medium businesses in Brazil (see 00-charter.md). Scope: the board, the task view and custom fields, plus what any SaaS needs to sell in Brazil. Not legal advice. A legal reading without a source is [inf] with a question for counsel in questions.md.

Summary

Launch blockers first. One row per barrier; details below.

-
BarrierCategorySeverityMarket weightBlocksLead time
BR-001 LGPD duties of a processor, and transfers out of BrazilRegulationblocks launchrequired to sellthe whole productweeks (contracts, records, incident procedure)
BR-002 Electronic service invoices (NFS-e national standard, CBS/IBS fields)The clone's own operationblocks launchrequired to sellcharging customersweeks to months (municipal registration, certificate, provider)
BR-010 Trademark and look and feelIntellectual property and termsblocks launchrequired to sellbrand, UI skinweeks (own name, own visual identity)
BR-011 ClickUp terms on reverse engineering and competitive API useIntellectual property and termsadds lead timen/ahow research is donecounsel review
BR-003 Recurring billing customers expect (Pix Automático, boleto, cards)The clone's own operationadds lead timerequired to sellsubscriptionsweeks (payment provider onboarding)
BR-004 Google OAuth verification (Calendar sensitive; Gmail and Drive restricted)Permissioned integrationblocks featureimportantcalendar sync, Drive files, Gmaildays (sensitive) to weeks plus a yearly security assessment (restricted)
BR-005 Microsoft publisher verification (Outlook, Teams)Permissioned integrationadds lead timeimportantOutlook calendar and mail, Teamsweeks (partner program account)
BR-006 Slack Marketplace reviewPermissioned integrationadds lead timeminorSlack listing10 active workspaces first, then up to 10 weeks
BR-007 WhatsApp Business PlatformPermissioned integrationblocks featureimportantWhatsApp notifications and task creationweeks (business verification, Tech Provider review)
BR-008 Security certifications buyers may ask forCertificationsadds costminorlarger SMB dealsmonths (SOC 2 or ISO 27001 audit)
BR-009 Enterprise must-haves (SSO, SCIM, audit log, data residency)Certificationsadds costminorupmarket dealsmonths
BR-013 Realtime collaboration and regional hostingInfrastructure and operating costadds costimportantlive board updatesbuild time
BR-014 AI features depend on paid LLM providersInfrastructure and operating costadds costminorAI fields, AI pickersdays (provider contract)
BR-012 Integrations, templates and user baseData, content and network effectsmoatimportantswitching from ClickUpongoing
+
BarrierCategorySeverityMarket weightBlocksLead time
BR-001 LGPD duties of a processor, and transfers out of BrazilRegulationblocks launchrequired to sellthe whole productweeks (contracts, records, incident procedure)
BR-002 Electronic service invoices (NFS-e national standard, CBS/IBS fields)The clone's own operationblocks launchrequired to sellcharging customersweeks to months (municipal registration, certificate, provider)
BR-010 Trademark and look and feelIntellectual property and termsblocks launchrequired to sellbrand, UI skinweeks (own name, own visual identity)
BR-011 ClickUp terms on reverse engineering and competitive API useIntellectual property and termsadds lead timen/ahow research is donecounsel review
BR-003 Recurring billing customers expect (Pix Automático, boleto, cards)The clone's own operationadds lead timerequired to sellsubscriptionsweeks (payment provider onboarding)
BR-004 Google OAuth verification (Calendar sensitive; Gmail and Drive restricted)Permissioned integrationblocks featureimportantcalendar sync, Drive files, Gmaildays (sensitive) to weeks plus a yearly security assessment (restricted)
BR-005 Microsoft publisher verification (Outlook, Teams)Permissioned integrationadds lead timeimportantOutlook calendar and mail, Teamsweeks (partner program account)
BR-006 Slack Marketplace reviewPermissioned integrationadds lead timeminorSlack listing10 active workspaces first, then up to 10 weeks
BR-007 WhatsApp Business PlatformPermissioned integrationblocks featureimportantWhatsApp notifications and task creationweeks (business verification, Tech Provider review)
BR-008 Security certifications buyers may ask forCertificationsadds costminorlarger SMB dealsmonths (SOC 2 or ISO 27001 audit)
BR-009 Enterprise must-haves (SSO, SCIM, audit log, data residency)Certificationsadds costminorupmarket dealsmonths
BR-013 Realtime collaboration and regional hostingInfrastructure and operating costadds costimportantlive board updatesbuild time
BR-014 AI features depend on paid LLM providersInfrastructure and operating costadds costminorAI fields, AI pickersdays (provider contract)
BR-012 Integrations, templates and user baseData, content and network effectsmoatimportantswitching from ClickUpongoing

BR-001 LGPD duties of a processor, and transfers out of Brazil

  • Category: regulation and licensing
  • Blocks: every feature that stores customer workspaces (F-001 to F-026)
  • Gatekeeper: ANPD (Autoridade Nacional de Proteção de Dados)
  • Severity: blocks launch
  • Market weight: required to sell [inf] Q-006
  • What it takes: as processor (operador), follow the customer's instructions (Art. 39), keep records of processing (Art. 37), apply security measures (Art. 46), support incident notices (Art. 48) [doc SRC-053]. Small companies may skip appointing an encarregado but must offer a contact channel (Res. 2/2022) [doc SRC-055]. Hosting outside Brazil needs ANPD standard contractual clauses adopted without changes; only the EU has an adequacy decision (Res. 32/2026) [doc SRC-054][doc SRC-056]. Fines up to 2% of Brazil revenue, capped at R$ 50 million per infraction [doc SRC-053].
  • Lead time and cost: weeks; mostly legal work [inf] Q-005
  • Mitigation: host in a Brazilian cloud region (ClickUp lists none in its subprocessors [doc SRC-041]) or sign the ANPD clauses with the cloud provider; publish a DPA and privacy policy; name a contact channel.
  • Evidence: [doc SRC-053][doc SRC-054][doc SRC-055][doc SRC-056][doc SRC-041]

BR-002 Electronic service invoices (NFS-e national standard, CBS/IBS fields)

@@ -1099,164 +1099,31 @@

Summary

  • Category: infrastructure and operating cost
  • Blocks: F-026 (live updates across tabs and users)
  • Gatekeeper: none
  • Severity: adds cost
  • Market weight: important [inf] Q-006
  • What it takes: board changes propagate to other open sessions without reload [obs EV-032]; the web app uses regional gateways (an EU host served the test workspace) [net EV-005]; ClickUp hosts on AWS in the US, Ireland, Germany, Australia and Singapore [doc SRC-041].
  • Lead time and cost: engineering time and a realtime service
  • Mitigation: one Brazilian region at launch; a managed realtime service.
  • Evidence: [obs EV-032][net EV-005][doc SRC-041]

BR-014 AI features depend on paid LLM providers

  • Category: infrastructure and operating cost
  • Blocks: F-023 (AI fields) and the AI shortcuts in pickers (Assign with AI, Prioritize with AI, Ask AI to build filters) [obs EV-041][obs EV-006][obs EV-039]
  • Gatekeeper: LLM providers
  • Severity: adds cost
  • Market weight: minor [inf] Q-006
  • What it takes: ClickUp lists 12 LLM subprocessors [doc SRC-041] and meters AI through credits per plan [doc SRC-035][doc SRC-044].
  • Lead time and cost: per-use fees
  • Mitigation: leave AI out of the first release; add it later behind credits.
  • Evidence: [doc SRC-041][doc SRC-035][doc SRC-044][obs EV-041]
-

11

Cross-cutting topics

Behavior that spans many screens: search, notifications, permissions and more.

Topic: hidden writes

Actions in this product that change data or state without a Save button.

-
PatternWhereClassEvidence
Card field pickers save at once (priority, assignee) or when the picker closes (dates, tags)Board cardA2[net EV-007][net EV-014]
✓ in the card's hover toolbar completes the task with one clickBoard cardA2[obs EV-012]
The hover toolbar buttons are in the Tab order even without hover; Enter on them actsBoard cardA2[obs EV-034]
"+ Add group" creates a status (List only or Entire Space)BoardA4 when Entire Space[obs EV-037]
Tags typed in a card picker are created at Space levelBoard cardA4[obs EV-040][net EV-014]
Assigning yourself offers "Don't ask again", a personal preferenceBoard cardA3[obs EV-042]
View option changes are drafts: nothing is saved until "Save view", and a reload drops the draft (the opposite risk: losing work)Board toolbar and CustomizeA1[obs EV-017][net EV-014]
"Autosave for me" turns every later view change into a saved changeCustomize viewA3/A4[obs EV-019]
Creating a list opens an AI "List settings" offer that generates task types, views, fields and statuses unless declinedCreate ListA4[obs EV-047]
Onboarding a workspace creates a Space, a List and two chat channelsWorkspace creationA2[obs EV-048]
Picking a country in a Phone field's flag menu saves the user's profile country (all workspaces), even with no number typedTask Fields sectionA3[obs EV-130][obs EV-131]
Custom field values save on change (checkbox click, picker choice, slider drag, blur) and each one spends a Free plan useTask Fields section, card rowsA2[net EV-112]
Configuring a Formula value edits the field definition for every task in its locationsTask Fields sectionA4 at workspace or space level[net EV-112]
Deleting a tag from a task's tag picker deletes it in the whole SpaceTag pickerA4[obs EV-136]
Opening a task marks it viewed (PUT .../viewed)Task viewA3 (product telemetry, not restorable)[net EV-058]
Using Create menus writes a per-user UI entry (PUT /growth-v1/.../dynamic_ui/entries/globalCreateBtn)Global Create menuA3 (product telemetry, not restorable)[net EV-140]
+

11Cross-cutting topics

Behavior that spans many screens: search, notifications, permissions and more.

Topic: hidden writes

Actions in this product that change data or state without a Save button.

+
PatternWhereClassEvidence
Card field pickers save at once (priority, assignee) or when the picker closes (dates, tags)Board cardA2[net EV-007][net EV-014]
✓ in the card's hover toolbar completes the task with one clickBoard cardA2[obs EV-012]
The hover toolbar buttons are in the Tab order even without hover; Enter on them actsBoard cardA2[obs EV-034]
"+ Add group" creates a status (List only or Entire Space)BoardA4 when Entire Space[obs EV-037]
Tags typed in a card picker are created at Space levelBoard cardA4[obs EV-040][net EV-014]
Assigning yourself offers "Don't ask again", a personal preferenceBoard cardA3[obs EV-042]
View option changes are drafts: nothing is saved until "Save view", and a reload drops the draft (the opposite risk: losing work)Board toolbar and CustomizeA1[obs EV-017][net EV-014]
"Autosave for me" turns every later view change into a saved changeCustomize viewA3/A4[obs EV-019]
Creating a list opens an AI "List settings" offer that generates task types, views, fields and statuses unless declinedCreate ListA4[obs EV-047]
Onboarding a workspace creates a Space, a List and two chat channelsWorkspace creationA2[obs EV-048]
Picking a country in a Phone field's flag menu saves the user's profile country (all workspaces), even with no number typedTask Fields sectionA3[obs EV-130][obs EV-131]
Custom field values save on change (checkbox click, picker choice, slider drag, blur) and each one spends a Free plan useTask Fields section, card rowsA2[net EV-112]
Configuring a Formula value edits the field definition for every task in its locationsTask Fields sectionA4 at workspace or space level[net EV-112]
Deleting a tag from a task's tag picker deletes it in the whole SpaceTag pickerA4[obs EV-136]
Opening a task marks it viewed (PUT .../viewed)Task viewA3 (product telemetry, not restorable)[net EV-058]
Using Create menus writes a per-user UI entry (PUT /growth-v1/.../dynamic_ui/entries/globalCreateBtn)Global Create menuA3 (product telemetry, not restorable)[net EV-140]

Not tested

  • Keyboard shortcuts on the board (SRC-046 lists them); notification inbox; "Remind me in Inbox".
-

12

Findings

Problems and strengths noticed in the product during the study.

Problems

-
IDFindingSeverityWhereEvidence
B-001View changes (collapse, card size, grouping) are lost on reload without any warning; "Save view" is the only cueMediumS-001[obs EV-017][obs EV-046]
B-002Tasks created quickly one after another can land out of order (v-03 above v-02)LowS-001, S-004[obs EV-012]
B-003The list group count lagged during fast creation (29 shown while 54 existed) until reloadLowS-004[obs EV-046]
B-004Card controls lack accessible names (open area, field toggles, Add subtask); the title link has no focus ringMediumC-001[obs EV-011][obs EV-034]
B-005No keyboard way to move a card or to move focus between cards; drag is mouse-onlyMediumS-001[obs EV-034][obs EV-046]
B-006The hover toolbar covers the end of the card titleLowC-001[obs EV-030]
B-007The view Fields panel lists 7 workspace custom fields that the Custom Field Manager does not show (no way to see where they live)MediumC-003, S-003[obs EV-044][obs EV-045]
B-008Creating a list opens an AI settings offer that starts generating before the user agreesLowCreate List[obs EV-047]
B-010Escape in an empty inline input (checklist item) closes the whole task view instead of only the inputMediumS-002[obs EV-068]
B-011Inline markdown for bold (**text**) typed in one go is not converted, while list markdown isLowC-012[obs EV-055]
B-012Opening and editing tasks sends a 'viewed' write on every task: a hidden write that feeds recently viewed listsLowS-002[net EV-058]
B-013Choosing a country in a Phone field silently changes the user's profile country for every workspaceMediumC-019[obs EV-130][obs EV-131]
B-014"Required in tasks" does not turn on in Free Forever and gives no message beyond a tooltip; Pinned jumps to an upgrade dialogMediumC-018[obs EV-082][obs EV-083]
B-015Deleting a field has no Undo; the confirm dialog shows the task count only after a delay, so a fast click confirms without itLowC-018[obs EV-126][obs EV-127]
B-016Global search kept listing tasks of a deleted list minutes after the deleteLowSearch[obs EV-138]
B-017Tag Manager is Business Plus; on Free the only way to delete a Space tag is from a task's tag picker, so an unused tag needs a task to reach itLowTags[obs EV-135][obs EV-136]
B-018Tasks and Relationship fields are created as custom fields but appear only in the Relate menu and a Related tab, not in the Fields section with the othersLowC-017[obs EV-117][obs EV-118]
B-009Many entry points push AI (Assign with AI, Prioritize with AI, Ask AI to build filters, AI fields suggestions) into basic pickersLowC-005, C-009[obs EV-006][obs EV-041][obs EV-039]
+

12Findings

Problems and strengths noticed in the product during the study.

Problems

+
IDFindingSeverityWhereEvidence
B-001View changes (collapse, card size, grouping) are lost on reload without any warning; "Save view" is the only cueMediumS-001[obs EV-017][obs EV-046]
B-002Tasks created quickly one after another can land out of order (v-03 above v-02)LowS-001, S-004[obs EV-012]
B-003The list group count lagged during fast creation (29 shown while 54 existed) until reloadLowS-004[obs EV-046]
B-004Card controls lack accessible names (open area, field toggles, Add subtask); the title link has no focus ringMediumC-001[obs EV-011][obs EV-034]
B-005No keyboard way to move a card or to move focus between cards; drag is mouse-onlyMediumS-001[obs EV-034][obs EV-046]
B-006The hover toolbar covers the end of the card titleLowC-001[obs EV-030]
B-007The view Fields panel lists 7 workspace custom fields that the Custom Field Manager does not show (no way to see where they live)MediumC-003, S-003[obs EV-044][obs EV-045]
B-008Creating a list opens an AI settings offer that starts generating before the user agreesLowCreate List[obs EV-047]
B-010Escape in an empty inline input (checklist item) closes the whole task view instead of only the inputMediumS-002[obs EV-068]
B-011Inline markdown for bold (**text**) typed in one go is not converted, while list markdown isLowC-012[obs EV-055]
B-012Opening and editing tasks sends a 'viewed' write on every task: a hidden write that feeds recently viewed listsLowS-002[net EV-058]
B-013Choosing a country in a Phone field silently changes the user's profile country for every workspaceMediumC-019[obs EV-130][obs EV-131]
B-014"Required in tasks" does not turn on in Free Forever and gives no message beyond a tooltip; Pinned jumps to an upgrade dialogMediumC-018[obs EV-082][obs EV-083]
B-015Deleting a field has no Undo; the confirm dialog shows the task count only after a delay, so a fast click confirms without itLowC-018[obs EV-126][obs EV-127]
B-016Global search kept listing tasks of a deleted list minutes after the deleteLowSearch[obs EV-138]
B-017Tag Manager is Business Plus; on Free the only way to delete a Space tag is from a task's tag picker, so an unused tag needs a task to reach itLowTags[obs EV-135][obs EV-136]
B-018Tasks and Relationship fields are created as custom fields but appear only in the Relate menu and a Related tab, not in the Fields section with the othersLowC-017[obs EV-117][obs EV-118]
B-009Many entry points push AI (Assign with AI, Prioritize with AI, Ask AI to build filters, AI fields suggestions) into basic pickersLowC-005, C-009[obs EV-006][obs EV-041][obs EV-039]

Strengths

  • Every card field edits in place with optimistic updates, and completing shows Undo [obs EV-012].
  • Changes reach other open tabs without reload [obs EV-032].
  • Adding a status now asks for its scope (list or space) instead of silently changing the Space [obs EV-037].
  • Column paging keeps large lists responsive [obs EV-046].
  • Number and money formats per field: BRL with Brazilian separators works out of the box [obs EV-102][obs EV-103].
  • Restoring a deleted field from Trash brings its values back [obs EV-129].
  • Every field change writes one activity line with the old and new value [obs EV-117].
  • Location fields resolve real addresses through Google Places and keep coordinates [obs EV-114][net EV-112].
-

13

Open questions

What the study could not confirm, and how to answer it.

IDQuestionWhy it mattersHow to answerStatus
Q-001Confirm: do card field values (chips) render later than card titles in a visible tab, and by how much?Perceived performance target for the cloneOpen the board in a foreground tab and record a video or Performance traceopen
Q-002Confirm: where do the 7 "Custom Fields in Workspace" listed in the view Fields panel come from (chat posts, meeting notes, docs)?Data model: hidden system fields per object typeInspect /customFields/v2/field response or open a chat post's fieldsopen
Q-003Confirm: drag and drop details: status change on drop, order within a column, multi-card drag, drop preview and animation, whether columns can be reorderedCore board interaction (F-005)A human performs drags while the agent records, or a Playwright session with real mouse eventsopen
Q-004Confirm: board Sort options and how sort interacts with manual orderView model (sorting.fields)Open Sort, apply one, reloadopen
Q-005Counsel: does building a clone from this study conflict with ClickUp's Terms 1.5 (no reverse engineering) and 4.13, and with the Developer Terms ban on competitive use?Legal risk of the whole projectBrazilian counsel reads SRC-038 and SRC-040open
Q-006Confirm market weights: which of these do Brazilian SMB buyers require before buying a work-management tool: WhatsApp, Google and Microsoft calendar sync, Slack, BRL pricing with Pix or boleto, NFS-e, SOC 2, SSO?Orders the PRD build list (barriers BR-001 to BR-014)Interviews or a short survey with 10 to 20 target buyers; sales callsopen
Q-007Confirm costs and lead times for: an NFS-e provider with the national API, Pix Automático through a Brazilian payment provider, a SOC 2 Type 1 audit, enterprise SSO and SCIMBudget and roadmapQuotes from two providers eachopen
Q-008Confirm: does deleting a field (or a value) give Free Forever uses back, and what happens at 60 (block, warning, read-only)?Plan limits the clone may copy or avoidWatch the entitlement counter while deleting a field with values; fill values up to 60 in a throwaway workspaceopen
Q-009Confirm: do Formula fields count as uses? The docs say yes (SRC-043); the counter did not move when a formula was configuredAccurate free-plan modelSet inputs on a new task and compare the counter before and after the formula computesopen
Q-010Confirm: required-field enforcement on Business: where it blocks (inline create, task view, import, API), the message, and subtasksP1 feature named by the requesterBusiness trial in an L1 accountopen
Q-011Confirm: the HTTP method and response of field delete and of Restore from TrashAPI parity for delete and restoreRepeat with the api-shapes recorder installed on the Trash pageopen
Q-012Confirm: Rollup fields, Button fields with an automation, and AI fields (credits, refresh, errors)Remaining field typesL1 account with AI credits; build a related list for rollupsopen
-

14

About this study

The goal, scope and terms of the study, the vocabulary of the product, and every public source used.

Charter

Date: 2026-10-16

-
ItemValue
GoalDocument ClickUp's board view, task detail view and custom fields well enough that a team that never used ClickUp can rebuild them, and say what would block such a clone from launching
Requested byThe product owner of this study (a founder in Brazil), through a parent agent session
ScopeBoard view, task detail view, custom fields (create each type, fill, required, delete with values, rendering on the board and in the task). Barrier scan for these features
Out of scopeList, calendar, Gantt and other views; docs, chat, goals, dashboards, AI features; automations beyond their entry points; mobile and desktop apps
Clone target marketSmall and medium businesses in Brazil (stated by the requester)
PrioritiesP1: the three named areas. P2: the core task loop they rest on (create, open, edit, complete). P3: every custom field type
ModeUnattended. No questions to the user; blocks go to "Needs human" in STATUS.md
Environment levelL2 if creating a workspace is free (no billing, no trial, no terms); otherwise L3 in a private space
Write authorization"Run a real reverse engineering study of ClickUp with RES"; "Environment: L2, a new empty ClickUp workspace named '🧪 [RE] ClickUp study' under [the user's] login, only if creation is free"
KB languageEnglish (the example is public)
Terms of serviceSee "Terms" below
+

13Open questions

What the study could not confirm, and how to answer it.

IDQuestionWhy it mattersHow to answerStatus
Q-001Confirm: do card field values (chips) render later than card titles in a visible tab, and by how much?Perceived performance target for the cloneOpen the board in a foreground tab and record a video or Performance traceopen
Q-002Confirm: where do the 7 "Custom Fields in Workspace" listed in the view Fields panel come from (chat posts, meeting notes, docs)?Data model: hidden system fields per object typeInspect /customFields/v2/field response or open a chat post's fieldsopen
Q-003Confirm: drag and drop details: status change on drop, order within a column, multi-card drag, drop preview and animation, whether columns can be reorderedCore board interaction (F-005)A human performs drags while the agent records, or a Playwright session with real mouse eventsopen
Q-004Confirm: board Sort options and how sort interacts with manual orderView model (sorting.fields)Open Sort, apply one, reloadopen
Q-005Counsel: does building a clone from this study conflict with ClickUp's Terms 1.5 (no reverse engineering) and 4.13, and with the Developer Terms ban on competitive use?Legal risk of the whole projectBrazilian counsel reads SRC-038 and SRC-040open
Q-006Confirm market weights: which of these do Brazilian SMB buyers require before buying a work-management tool: WhatsApp, Google and Microsoft calendar sync, Slack, BRL pricing with Pix or boleto, NFS-e, SOC 2, SSO?Orders the PRD build list (barriers BR-001 to BR-014)Interviews or a short survey with 10 to 20 target buyers; sales callsopen
Q-007Confirm costs and lead times for: an NFS-e provider with the national API, Pix Automático through a Brazilian payment provider, a SOC 2 Type 1 audit, enterprise SSO and SCIMBudget and roadmapQuotes from two providers eachopen
Q-008Confirm: does deleting a field (or a value) give Free Forever uses back, and what happens at 60 (block, warning, read-only)?Plan limits the clone may copy or avoidWatch the entitlement counter while deleting a field with values; fill values up to 60 in a throwaway workspaceopen
Q-009Confirm: do Formula fields count as uses? The docs say yes (SRC-043); the counter did not move when a formula was configuredAccurate free-plan modelSet inputs on a new task and compare the counter before and after the formula computesopen
Q-010Confirm: required-field enforcement on Business: where it blocks (inline create, task view, import, API), the message, and subtasksP1 feature named by the requesterBusiness trial in an L1 accountopen
Q-011Confirm: the HTTP method and response of field delete and of Restore from TrashAPI parity for delete and restoreRepeat with the api-shapes recorder installed on the Trash pageopen
Q-012Confirm: Rollup fields, Button fields with an automation, and AI fields (credits, refresh, errors)Remaining field typesL1 account with AI credits; build a related list for rollupsopen
+

14About this study

The goal, scope and terms of the study, the vocabulary of the product, and every public source used.

Charter

Date: 2026-10-16

+
ItemValue
GoalDocument ClickUp's board view, task detail view and custom fields well enough that a team that never used ClickUp can rebuild them, and say what would block such a clone from launching
Requested byThe product owner of this study (a founder in Brazil), through a parent agent session
ScopeBoard view, task detail view, custom fields (create each type, fill, required, delete with values, rendering on the board and in the task). Barrier scan for these features
Out of scopeList, calendar, Gantt and other views; docs, chat, goals, dashboards, AI features; automations beyond their entry points; mobile and desktop apps
Clone target marketSmall and medium businesses in Brazil (stated by the requester)
PrioritiesP1: the three named areas. P2: the core task loop they rest on (create, open, edit, complete). P3: every custom field type
ModeUnattended. No questions to the user; blocks go to "Needs human" in STATUS.md
Environment levelL2 if creating a workspace is free (no billing, no trial, no terms); otherwise L3 in a private space
Write authorization"Run a real reverse engineering study of ClickUp with RES"; "Environment: L2, a new empty ClickUp workspace named '🧪 [RE] ClickUp study' under [the user's] login, only if creation is free"
KB languageEnglish (the example is public)
Terms of serviceSee "Terms" below

Terms

-
DocumentClauseURLSource
Terms of Service1.5: users may not disassemble, decompile or reverse engineer the Servicehttps://clickup.com/terms[doc SRC-038]
Terms of Service3.9 and 4.13: no scraping and no derivative or competing uses of the Servicehttps://clickup.com/terms[doc SRC-038]
Developer Terms3: no API use for benchmarking or a competitive purposehttps://clickup.com/terms/developer-terms[doc SRC-040]
+
DocumentClauseURLSource
Terms of Service1.5: users may not disassemble, decompile or reverse engineer the Servicehttps://clickup.com/terms[doc SRC-038]
Terms of Service3.9 and 4.13: no scraping and no derivative or competing uses of the Servicehttps://clickup.com/terms[doc SRC-038]
Developer Terms3: no API use for benchmarking or a competitive purposehttps://clickup.com/terms/developer-terms[doc SRC-040]

This study observed only the UI of the user's own test workspace and did not call the public API. Whether a clone built from it is allowed is the user's decision with counsel (BR-011, Q-005); it is listed under "Needs human" in STATUS.md. The study followed the user's original instruction.

-

Glossary

TermDefinitionEvidence
WorkspaceTop container of an account's work; has members, plan and billing. API name: team[obs EV-001][doc SRC-023]
SpaceContainer inside a workspace holding folders and lists; owns statuses, tags and ClickApps that lists inherit[obs EV-037][doc SRC-018]
FolderOptional container of lists inside a Space[doc SRC-008]
ListContainer of tasks; every task lives in at least one list[doc SRC-017]
ViewA saved way to show a location's tasks (List, Board, Calendar...); has grouping, filters, sorting, columns and settings[net EV-014][doc SRC-028]
BoardView type that shows tasks as cards in columns, one column per group value[obs EV-012]
GroupThe field that makes the board's columns (status by default)[obs EV-025]
SubgroupA second grouping field that adds swimlanes (rows)[obs EV-027]
CardA task as shown on the board[obs EV-013]
StatusWorkflow state of a task; types open, custom (active), done and closed[net EV-014][doc SRC-018]
Custom fieldA user-defined task attribute with a type (Dropdown, Money, Date, ...) defined at a location[obs EV-004][doc SRC-008]
Use (custom field)One value written to a custom field on a task; Free Forever allows 60 per workspace[doc SRC-005]
Custom Field ManagerSettings screen that lists custom fields by location and task type[obs EV-045][doc SRC-006]
ClickAppA feature switch per workspace or space (WIP limits, custom task IDs, ...)[doc SRC-011][doc SRC-019]
Save viewButton that turns view draft changes into the saved view for everyone[obs EV-017][doc SRC-013]
Me modeView filter showing only the current user's tasks[obs EV-022]
Task typeKind of task (Task, Milestone, Form Response, Meeting Note); custom fields can be bound to it[obs EV-045]
Location (custom field)Where a field lives: Workspace, Space, Folder or List; a field shows on every task there[net EV-099][doc SRC-008]
Fields sectionThe block of custom fields in the task view[obs EV-117]
Formula fieldA field computed from other fields, defined once for all tasks of its locations[obs EV-116][net EV-112]
Tasks / Relationship fieldFields that link tasks; they appear in the Relate menu and a Related tab[obs EV-118][obs EV-119]
TrashSettings page that keeps deleted lists, tasks, tags and fields for 30 days[obs EV-137]
EntitlementThe server-side counter of a plan limit, such as custom field uses[net EV-112]
+

Glossary

TermDefinitionEvidence
WorkspaceTop container of an account's work; has members, plan and billing. API name: team[obs EV-001][doc SRC-023]
SpaceContainer inside a workspace holding folders and lists; owns statuses, tags and ClickApps that lists inherit[obs EV-037][doc SRC-018]
FolderOptional container of lists inside a Space[doc SRC-008]
ListContainer of tasks; every task lives in at least one list[doc SRC-017]
ViewA saved way to show a location's tasks (List, Board, Calendar...); has grouping, filters, sorting, columns and settings[net EV-014][doc SRC-028]
BoardView type that shows tasks as cards in columns, one column per group value[obs EV-012]
GroupThe field that makes the board's columns (status by default)[obs EV-025]
SubgroupA second grouping field that adds swimlanes (rows)[obs EV-027]
CardA task as shown on the board[obs EV-013]
StatusWorkflow state of a task; types open, custom (active), done and closed[net EV-014][doc SRC-018]
Custom fieldA user-defined task attribute with a type (Dropdown, Money, Date, ...) defined at a location[obs EV-004][doc SRC-008]
Use (custom field)One value written to a custom field on a task; Free Forever allows 60 per workspace[doc SRC-005]
Custom Field ManagerSettings screen that lists custom fields by location and task type[obs EV-045][doc SRC-006]
ClickAppA feature switch per workspace or space (WIP limits, custom task IDs, ...)[doc SRC-011][doc SRC-019]
Save viewButton that turns view draft changes into the saved view for everyone[obs EV-017][doc SRC-013]
Me modeView filter showing only the current user's tasks[obs EV-022]
Task typeKind of task (Task, Milestone, Form Response, Meeting Note); custom fields can be bound to it[obs EV-045]
Location (custom field)Where a field lives: Workspace, Space, Folder or List; a field shows on every task there[net EV-099][doc SRC-008]
Fields sectionThe block of custom fields in the task view[obs EV-117]
Formula fieldA field computed from other fields, defined once for all tasks of its locations[obs EV-116][net EV-112]
Tasks / Relationship fieldFields that link tasks; they appear in the Relate menu and a Related tab[obs EV-118][obs EV-119]
TrashSettings page that keeps deleted lists, tasks, tags and fields for 30 days[obs EV-137]
EntitlementThe server-side counter of a plan limit, such as custom field uses[net EV-112]

Sources

Public sources read during recon (Phase 3). help.clickup.com refused direct fetches; articles were read through its public help-center API, and the table links the article pages.

-
IDTitleURLTypeRead onGives
SRC-001ClickUp API: Custom Fields (guide)https://developer.clickup.com/docs/customfieldsapi2026-10-1617 API field types, value shapes, type_config, Free plan 60-use rule
SRC-002Help: Custom Field typeshttps://help.clickup.com/hc/en-us/articles/6303499162647-Custom-Field-typesdocs2026-10-1623 UI field types, options, char limits, option limits
SRC-003Help: Make Custom Fields requiredhttps://help.clickup.com/hc/en-us/articles/30407234676887-Make-Custom-Fields-requireddocs2026-10-16Required fields: plan, when enforced, settings
SRC-004Help: Remove or delete Custom Fieldshttps://help.clickup.com/hc/en-us/articles/22769580660887-Remove-or-delete-Custom-Fieldsdocs2026-10-16Remove vs delete, Trash, 30-day restore, Automations impact
SRC-005Help: Custom Fields useshttps://help.clickup.com/hc/en-us/articles/10993484102167-Custom-Fields-usesdocs2026-10-16What counts as a "use", behavior at the limit
SRC-006Help: Intro to Custom Field Managerhttps://help.clickup.com/hc/en-us/articles/13066263096727-Intro-to-Custom-Field-Managerdocs2026-10-16Manager entry points, columns, filters, move/merge plan gate
SRC-007Help: Show Custom Fields in tasks and viewshttps://help.clickup.com/hc/en-us/articles/6330455628439-Show-Custom-Fields-in-tasks-and-viewsdocs2026-10-16Fields section in task view, empty fields, board/list display
SRC-008Help: Intro to Custom Fieldshttps://help.clickup.com/hc/en-us/articles/6303536766231-Intro-to-Custom-Fieldsdocs2026-10-16Locations, inheritance, plan table (pin, task-type fields), roles
SRC-009Help: Customize Board viewhttps://help.clickup.com/hc/en-us/articles/35342044832279-Customize-Board-viewdocs2026-10-16Board Customize menu: card size, cover, fields, toggles
SRC-010Help: Use subgroups in Board viewhttps://help.clickup.com/hc/en-us/articles/8352728309271-Use-subgroups-in-Board-viewdocs2026-10-16Swimlanes (subgroups)
SRC-011Help: Work in Progress Limitshttps://help.clickup.com/hc/en-us/articles/6304619369623-Work-in-Progress-Limitsdocs2026-10-16WIP limits: plan, measures, warning colors
SRC-012Help: Create and share a Board viewhttps://help.clickup.com/hc/en-us/articles/6310080798615-Create-and-share-a-Board-viewdocs2026-10-16Group-by options, drag to status, private/public views
SRC-013Help: Save view changeshttps://help.clickup.com/hc/en-us/articles/6310370965911-Save-view-changesdocs2026-10-16Save view, Autosave, Save as new view, Revert
SRC-014Help: Views feature availability and limitshttps://help.clickup.com/hc/en-us/articles/32274881672599-Views-feature-availability-and-limitsdocs2026-10-16Per-plan view limits (private, protected, default views)
SRC-015Help: Export List and Table viewshttps://help.clickup.com/hc/en-us/articles/6310174308631-Export-List-and-Table-viewsdocs2026-10-16CSV/Excel export incl. custom fields
SRC-016Help: Task layoutshttps://help.clickup.com/hc/en-us/articles/29665520762647-Task-layoutsdocs2026-10-16Full screen, Modal, Sidebar task layouts
SRC-017Help: Intro to taskshttps://help.clickup.com/hc/en-us/articles/10552031987735-Intro-to-tasksdocs2026-10-16Parts of a task, sections of task view
SRC-018Help: Manage task statuseshttps://help.clickup.com/hc/en-us/articles/6309452618647-Manage-task-statusesdocs2026-10-16Status groups, inheritance, permissions
SRC-019Help: Create Custom Task IDshttps://help.clickup.com/hc/en-us/articles/6304361756951-Create-Custom-Task-IDsdocs2026-10-16Custom task ID format, plan
SRC-020ClickUp API: Rate limitshttps://developer.clickup.com/docs/rate-limitsapi2026-10-16Requests/minute per plan, headers
SRC-021Help: Intro to Dependency Relationshipshttps://help.clickup.com/hc/en-us/articles/6309155073303-Intro-to-Dependency-Relationshipsdocs2026-10-16Blocks / blocked by, warning and reschedule ClickApps
SRC-022Help: Intro to Relationshipshttps://help.clickup.com/hc/en-us/articles/6304528030743-Intro-to-Relationshipsdocs2026-10-16Task links, relationship columns (ex-Rollup), 300-link limit
SRC-023ClickUp API: Get Taskhttps://developer.clickup.com/reference/gettaskapi2026-10-16Task object fields and types
SRC-024ClickUp API: Set Custom Field Valuehttps://developer.clickup.com/reference/setcustomfieldvalueapi2026-10-16Endpoint, value shapes incl. Files and Button
SRC-025ClickUp API: Get List Custom Fields (Get Accessible Custom Fields)https://developer.clickup.com/reference/getaccessiblecustomfieldsapi2026-10-16Field object shape, applied_objects
SRC-026ClickUp API docs index (llms.txt)https://developer.clickup.com/llms.txtapi2026-10-16Full endpoint list; no create-field endpoint
SRC-027ClickUp API: Webhookshttps://developer.clickup.com/docs/webhooksapi2026-10-16Webhook event names, location filters
SRC-028ClickUp API: Create List Viewhttps://developer.clickup.com/reference/createlistviewapi2026-10-16View object: type enum, grouping, divide, settings
SRC-029ClickUp API: Create Taskhttps://developer.clickup.com/reference/createtaskapi2026-10-16Create body, custom_fields, check_required_custom_fields
SRC-030ClickUp API: Task webhook payloadshttps://developer.clickup.com/docs/webhooktaskpayloadsapi2026-10-16taskUpdated history_items, custom field change shape
SRC-031ClickUp API: Tasks (guide)https://developer.clickup.com/docs/tasksapi2026-10-16Priority enum, time units, Update Task vs custom fields
SRC-032ClickUp API: Get Listhttps://developer.clickup.com/reference/getlistapi2026-10-16List object, statuses array
SRC-033ClickUp API: Get Spacehttps://developer.clickup.com/reference/getspaceapi2026-10-16Space object, features (ClickApps)
SRC-034ClickUp API: Remove Custom Field Valuehttps://developer.clickup.com/reference/removecustomfieldvalueapi2026-10-16DELETE value endpoint
SRC-035ClickUp Pricinghttps://clickup.com/pricingpricing2026-10-16Two plan sets, prices USD, limits
SRC-036ClickUp Pricing (pt-BR)https://clickup.com/pt-BR/pricingpricing2026-10-16Currency shown to Portuguese locale (USD)
SRC-037Help: Downgrade your planhttps://help.clickup.com/hc/en-us/articles/13673035695127-Downgrade-your-plandocs2026-10-16New plan names (Core = Unlimited, Max)
SRC-038ClickUp Terms of Servicehttps://clickup.com/termsterms2026-10-16Reverse engineering, copying, scraping clauses
SRC-039ClickUp Securityhttps://clickup.com/securitysecurity2026-10-16Certifications, data residency, encryption
SRC-040ClickUp Developer Termshttps://clickup.com/terms/developer-termsterms2026-10-16API license restrictions, competitive use, marks
SRC-041ClickUp Subprocessorshttps://clickup.com/terms/dpa/subprocessorssecurity2026-10-1653 subprocessors, hosting regions, payment processors
SRC-042Help: Intro to single sign-on (SSO)https://help.clickup.com/hc/en-us/articles/6305043992343-Intro-to-single-sign-on-SSOdocs2026-10-16SSO plan gating (search API snippets)
SRC-043Help: Intro to Formula Fieldshttps://help.clickup.com/hc/en-us/articles/6308656424983-Intro-to-Formula-Fieldsdocs2026-10-16Formula inputs, outputs, limits
SRC-044Help: What are AI Fields?https://help.clickup.com/hc/en-us/articles/18450100382871-What-are-AI-Fieldsdocs2026-10-16AI field kinds, refresh rules, credits
SRC-045Help: Convert Custom Fieldshttps://help.clickup.com/hc/en-us/articles/14277190461207-Convert-Custom-Fieldsdocs2026-10-16Type conversion matrix, 25,000-task cap
SRC-046Help: Use keyboard shortcutshttps://help.clickup.com/hc/en-us/articles/6309030550167-Use-keyboard-shortcutsdocs2026-10-16Shortcut list
SRC-047Help: How do I import my work into ClickUp?https://help.clickup.com/hc/en-us/articles/6311099045783-How-do-I-import-my-work-into-ClickUpdocs2026-10-16Native importers
SRC-048Help: Export task datahttps://help.clickup.com/hc/en-us/articles/6310551109527-Export-task-datadocs2026-10-16Workspace CSV export columns
SRC-049ClickUp Integrationshttps://clickup.com/integrationsdocs2026-10-161,000+ integrations claim, Google/Microsoft/Slack listings
SRC-050ClickUp Templateshttps://clickup.com/templatesdocs2026-10-161,000+ templates claim
SRC-051ClickUp Feedback: WhatsApp Automation and Direct Integrationhttps://feedback.clickup.com/integrations/p/whatsapp-automation-and-direct-integrationcommunity2026-10-16WhatsApp request status "future", ~2.5k votes
SRC-052ClickUp Trademark Guidelineshttps://clickup.com/brand/trademark-guidelinesterms2026-10-16Prohibited uses of the ClickUp mark
SRC-053Lei 13.709/2018 (LGPD), consolidated text, Câmara dos Deputadoshttps://www2.camara.leg.br/legin/fed/lei/2018/lei-13709-14-agosto-2018-787077-normaatualizada-pl.htmlregulator2026-10-16Arts. 5, 33, 37, 39, 41, 46, 48, 52
SRC-054ANPD: Regulamentações da ANPDhttps://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpdregulator2026-10-16List of ANPD resolutions in force
SRC-055Resolução CD/ANPD nº 2/2022 (copy on gov.br)https://www.gov.br/palmares/pt-br/midias/arquivos-menu-acesso-a-informacao/legislacao/resolucao-cd-anpd-n2-2022.pdfregulator2026-10-16Small-agent relief, encarregado waiver (search)
SRC-056ANPD: Transferência Internacional de Dadoshttps://www.gov.br/anpd/pt-br/assuntos/assuntos-internacionais/transferencia-internacional-de-dadosregulator2026-10-16Transfer mechanisms, SCC deadline (search)
SRC-057Receita Federal: NFS-e Nacional obrigatória para ME e EPP a partir de 1º/11/2026https://www.gov.br/receitafederal/pt-br/assuntos/noticias/2026/agosto/simples-nacional-nfs-e-nacional-sera-obrigatoria-para-me-e-epp-a-partir-de-1o-de-novembro-de-2026/regulator2026-10-16NFS-e national issuer obligation, CBS/IBS for Simples from 2027
SRC-058CGIBS: campos de IBS e CBS obrigatórios a partir de 03/08/2026https://www.cgibs.gov.br/novo-marco-da-reforma-tributaria-inicia-em-03-de-agosto-com-preenchimento-obrigatorio-dos-campos-relativos-ao-ibs-e-a-cbsregulator2026-10-16IBS/CBS invoice fields, test rates, rejection
SRC-059TCU: Reforma Tributáriahttps://sites.tcu.gov.br/reforma-tributaria/regulator2026-10-16CBS/IBS transition timeline, end of ISS
SRC-060BCB: Guia de implementação do Pix Automático v1.3https://www.bcb.gov.br/content/estabilidadefinanceira/pix/automatico/guia_pix_automatico.pdfregulator2026-10-16Pix Automático flows, receiver rules, fees, timing
SRC-061Google: Restricted scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verificationprovider-docs2026-10-16Restricted scope review, CASA, annual reassessment
SRC-062Google: Sensitive scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verificationprovider-docs2026-10-16Sensitive scope review, Calendar example, 3-5 days
SRC-063Google: Gmail API scopeshttps://developers.google.com/workspace/gmail/api/auth/scopesprovider-docs2026-10-16Gmail scope classification
SRC-064Google: Drive API scopeshttps://developers.google.com/workspace/drive/api/guides/api-specific-authprovider-docs2026-10-16Drive scope classification, drive.file
SRC-065Microsoft: Publisher verification overviewhttps://learn.microsoft.com/en-us/entra/identity-platform/publisher-verification-overviewprovider-docs2026-10-16Requirements, consent effect, cost
SRC-066Slack: Marketplace review guidehttps://docs.slack.dev/slack-marketplace/slack-marketplace-review-guideprovider-docs2026-10-1610-workspace minimum, review timelines
SRC-067Meta: WhatsApp Business Platform pricinghttps://developers.facebook.com/docs/whatsapp/pricingprovider-docs2026-10-16Per-message pricing, service window, BRL billing
SRC-068Meta: Get started for Tech Providers (WhatsApp)https://developers.facebook.com/docs/whatsapp/solution-providers/get-started-for-tech-providersprovider-docs2026-10-16Tech Provider requirements for SaaS
SRC-069Help: Tasks feature availability and limitshttps://help.clickup.com/hc/en-us/articles/29664799512855-Tasks-feature-availability-and-limitsdocs2026-10-16Task performance limits, multi-List limits
SRC-070ClickUp AI / LLM info pagehttps://clickup.com/ai-llm-info-pagedocs2026-10-165M+ teams, $300M ARR (2025) claims
-

15

Evidence

Every statement cites its evidence: [obs EV-###] seen in the product, [net EV-###] captured on the network, [doc SRC-###] public documentation, [inf] an inference with an open question.

-
Generated by RES (Reverse Engineering SaaS) from the knowledge base in this folder. The launch analysis is research, not legal advice. Rebuild from behavior; do not copy the original product's code, assets or brand.
+
IDTitleURLTypeRead onGives
SRC-001ClickUp API: Custom Fields (guide)https://developer.clickup.com/docs/customfieldsapi2026-10-1617 API field types, value shapes, type_config, Free plan 60-use rule
SRC-002Help: Custom Field typeshttps://help.clickup.com/hc/en-us/articles/6303499162647-Custom-Field-typesdocs2026-10-1623 UI field types, options, char limits, option limits
SRC-003Help: Make Custom Fields requiredhttps://help.clickup.com/hc/en-us/articles/30407234676887-Make-Custom-Fields-requireddocs2026-10-16Required fields: plan, when enforced, settings
SRC-004Help: Remove or delete Custom Fieldshttps://help.clickup.com/hc/en-us/articles/22769580660887-Remove-or-delete-Custom-Fieldsdocs2026-10-16Remove vs delete, Trash, 30-day restore, Automations impact
SRC-005Help: Custom Fields useshttps://help.clickup.com/hc/en-us/articles/10993484102167-Custom-Fields-usesdocs2026-10-16What counts as a "use", behavior at the limit
SRC-006Help: Intro to Custom Field Managerhttps://help.clickup.com/hc/en-us/articles/13066263096727-Intro-to-Custom-Field-Managerdocs2026-10-16Manager entry points, columns, filters, move/merge plan gate
SRC-007Help: Show Custom Fields in tasks and viewshttps://help.clickup.com/hc/en-us/articles/6330455628439-Show-Custom-Fields-in-tasks-and-viewsdocs2026-10-16Fields section in task view, empty fields, board/list display
SRC-008Help: Intro to Custom Fieldshttps://help.clickup.com/hc/en-us/articles/6303536766231-Intro-to-Custom-Fieldsdocs2026-10-16Locations, inheritance, plan table (pin, task-type fields), roles
SRC-009Help: Customize Board viewhttps://help.clickup.com/hc/en-us/articles/35342044832279-Customize-Board-viewdocs2026-10-16Board Customize menu: card size, cover, fields, toggles
SRC-010Help: Use subgroups in Board viewhttps://help.clickup.com/hc/en-us/articles/8352728309271-Use-subgroups-in-Board-viewdocs2026-10-16Swimlanes (subgroups)
SRC-011Help: Work in Progress Limitshttps://help.clickup.com/hc/en-us/articles/6304619369623-Work-in-Progress-Limitsdocs2026-10-16WIP limits: plan, measures, warning colors
SRC-012Help: Create and share a Board viewhttps://help.clickup.com/hc/en-us/articles/6310080798615-Create-and-share-a-Board-viewdocs2026-10-16Group-by options, drag to status, private/public views
SRC-013Help: Save view changeshttps://help.clickup.com/hc/en-us/articles/6310370965911-Save-view-changesdocs2026-10-16Save view, Autosave, Save as new view, Revert
SRC-014Help: Views feature availability and limitshttps://help.clickup.com/hc/en-us/articles/32274881672599-Views-feature-availability-and-limitsdocs2026-10-16Per-plan view limits (private, protected, default views)
SRC-015Help: Export List and Table viewshttps://help.clickup.com/hc/en-us/articles/6310174308631-Export-List-and-Table-viewsdocs2026-10-16CSV/Excel export incl. custom fields
SRC-016Help: Task layoutshttps://help.clickup.com/hc/en-us/articles/29665520762647-Task-layoutsdocs2026-10-16Full screen, Modal, Sidebar task layouts
SRC-017Help: Intro to taskshttps://help.clickup.com/hc/en-us/articles/10552031987735-Intro-to-tasksdocs2026-10-16Parts of a task, sections of task view
SRC-018Help: Manage task statuseshttps://help.clickup.com/hc/en-us/articles/6309452618647-Manage-task-statusesdocs2026-10-16Status groups, inheritance, permissions
SRC-019Help: Create Custom Task IDshttps://help.clickup.com/hc/en-us/articles/6304361756951-Create-Custom-Task-IDsdocs2026-10-16Custom task ID format, plan
SRC-020ClickUp API: Rate limitshttps://developer.clickup.com/docs/rate-limitsapi2026-10-16Requests/minute per plan, headers
SRC-021Help: Intro to Dependency Relationshipshttps://help.clickup.com/hc/en-us/articles/6309155073303-Intro-to-Dependency-Relationshipsdocs2026-10-16Blocks / blocked by, warning and reschedule ClickApps
SRC-022Help: Intro to Relationshipshttps://help.clickup.com/hc/en-us/articles/6304528030743-Intro-to-Relationshipsdocs2026-10-16Task links, relationship columns (ex-Rollup), 300-link limit
SRC-023ClickUp API: Get Taskhttps://developer.clickup.com/reference/gettaskapi2026-10-16Task object fields and types
SRC-024ClickUp API: Set Custom Field Valuehttps://developer.clickup.com/reference/setcustomfieldvalueapi2026-10-16Endpoint, value shapes incl. Files and Button
SRC-025ClickUp API: Get List Custom Fields (Get Accessible Custom Fields)https://developer.clickup.com/reference/getaccessiblecustomfieldsapi2026-10-16Field object shape, applied_objects
SRC-026ClickUp API docs index (llms.txt)https://developer.clickup.com/llms.txtapi2026-10-16Full endpoint list; no create-field endpoint
SRC-027ClickUp API: Webhookshttps://developer.clickup.com/docs/webhooksapi2026-10-16Webhook event names, location filters
SRC-028ClickUp API: Create List Viewhttps://developer.clickup.com/reference/createlistviewapi2026-10-16View object: type enum, grouping, divide, settings
SRC-029ClickUp API: Create Taskhttps://developer.clickup.com/reference/createtaskapi2026-10-16Create body, custom_fields, check_required_custom_fields
SRC-030ClickUp API: Task webhook payloadshttps://developer.clickup.com/docs/webhooktaskpayloadsapi2026-10-16taskUpdated history_items, custom field change shape
SRC-031ClickUp API: Tasks (guide)https://developer.clickup.com/docs/tasksapi2026-10-16Priority enum, time units, Update Task vs custom fields
SRC-032ClickUp API: Get Listhttps://developer.clickup.com/reference/getlistapi2026-10-16List object, statuses array
SRC-033ClickUp API: Get Spacehttps://developer.clickup.com/reference/getspaceapi2026-10-16Space object, features (ClickApps)
SRC-034ClickUp API: Remove Custom Field Valuehttps://developer.clickup.com/reference/removecustomfieldvalueapi2026-10-16DELETE value endpoint
SRC-035ClickUp Pricinghttps://clickup.com/pricingpricing2026-10-16Two plan sets, prices USD, limits
SRC-036ClickUp Pricing (pt-BR)https://clickup.com/pt-BR/pricingpricing2026-10-16Currency shown to Portuguese locale (USD)
SRC-037Help: Downgrade your planhttps://help.clickup.com/hc/en-us/articles/13673035695127-Downgrade-your-plandocs2026-10-16New plan names (Core = Unlimited, Max)
SRC-038ClickUp Terms of Servicehttps://clickup.com/termsterms2026-10-16Reverse engineering, copying, scraping clauses
SRC-039ClickUp Securityhttps://clickup.com/securitysecurity2026-10-16Certifications, data residency, encryption
SRC-040ClickUp Developer Termshttps://clickup.com/terms/developer-termsterms2026-10-16API license restrictions, competitive use, marks
SRC-041ClickUp Subprocessorshttps://clickup.com/terms/dpa/subprocessorssecurity2026-10-1653 subprocessors, hosting regions, payment processors
SRC-042Help: Intro to single sign-on (SSO)https://help.clickup.com/hc/en-us/articles/6305043992343-Intro-to-single-sign-on-SSOdocs2026-10-16SSO plan gating (search API snippets)
SRC-043Help: Intro to Formula Fieldshttps://help.clickup.com/hc/en-us/articles/6308656424983-Intro-to-Formula-Fieldsdocs2026-10-16Formula inputs, outputs, limits
SRC-044Help: What are AI Fields?https://help.clickup.com/hc/en-us/articles/18450100382871-What-are-AI-Fieldsdocs2026-10-16AI field kinds, refresh rules, credits
SRC-045Help: Convert Custom Fieldshttps://help.clickup.com/hc/en-us/articles/14277190461207-Convert-Custom-Fieldsdocs2026-10-16Type conversion matrix, 25,000-task cap
SRC-046Help: Use keyboard shortcutshttps://help.clickup.com/hc/en-us/articles/6309030550167-Use-keyboard-shortcutsdocs2026-10-16Shortcut list
SRC-047Help: How do I import my work into ClickUp?https://help.clickup.com/hc/en-us/articles/6311099045783-How-do-I-import-my-work-into-ClickUpdocs2026-10-16Native importers
SRC-048Help: Export task datahttps://help.clickup.com/hc/en-us/articles/6310551109527-Export-task-datadocs2026-10-16Workspace CSV export columns
SRC-049ClickUp Integrationshttps://clickup.com/integrationsdocs2026-10-161,000+ integrations claim, Google/Microsoft/Slack listings
SRC-050ClickUp Templateshttps://clickup.com/templatesdocs2026-10-161,000+ templates claim
SRC-051ClickUp Feedback: WhatsApp Automation and Direct Integrationhttps://feedback.clickup.com/integrations/p/whatsapp-automation-and-direct-integrationcommunity2026-10-16WhatsApp request status "future", ~2.5k votes
SRC-052ClickUp Trademark Guidelineshttps://clickup.com/brand/trademark-guidelinesterms2026-10-16Prohibited uses of the ClickUp mark
SRC-053Lei 13.709/2018 (LGPD), consolidated text, Câmara dos Deputadoshttps://www2.camara.leg.br/legin/fed/lei/2018/lei-13709-14-agosto-2018-787077-normaatualizada-pl.htmlregulator2026-10-16Arts. 5, 33, 37, 39, 41, 46, 48, 52
SRC-054ANPD: Regulamentações da ANPDhttps://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpdregulator2026-10-16List of ANPD resolutions in force
SRC-055Resolução CD/ANPD nº 2/2022 (copy on gov.br)https://www.gov.br/palmares/pt-br/midias/arquivos-menu-acesso-a-informacao/legislacao/resolucao-cd-anpd-n2-2022.pdfregulator2026-10-16Small-agent relief, encarregado waiver (search)
SRC-056ANPD: Transferência Internacional de Dadoshttps://www.gov.br/anpd/pt-br/assuntos/assuntos-internacionais/transferencia-internacional-de-dadosregulator2026-10-16Transfer mechanisms, SCC deadline (search)
SRC-057Receita Federal: NFS-e Nacional obrigatória para ME e EPP a partir de 1º/11/2026https://www.gov.br/receitafederal/pt-br/assuntos/noticias/2026/agosto/simples-nacional-nfs-e-nacional-sera-obrigatoria-para-me-e-epp-a-partir-de-1o-de-novembro-de-2026/regulator2026-10-16NFS-e national issuer obligation, CBS/IBS for Simples from 2027
SRC-058CGIBS: campos de IBS e CBS obrigatórios a partir de 03/08/2026https://www.cgibs.gov.br/novo-marco-da-reforma-tributaria-inicia-em-03-de-agosto-com-preenchimento-obrigatorio-dos-campos-relativos-ao-ibs-e-a-cbsregulator2026-10-16IBS/CBS invoice fields, test rates, rejection
SRC-059TCU: Reforma Tributáriahttps://sites.tcu.gov.br/reforma-tributaria/regulator2026-10-16CBS/IBS transition timeline, end of ISS
SRC-060BCB: Guia de implementação do Pix Automático v1.3https://www.bcb.gov.br/content/estabilidadefinanceira/pix/automatico/guia_pix_automatico.pdfregulator2026-10-16Pix Automático flows, receiver rules, fees, timing
SRC-061Google: Restricted scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verificationprovider-docs2026-10-16Restricted scope review, CASA, annual reassessment
SRC-062Google: Sensitive scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verificationprovider-docs2026-10-16Sensitive scope review, Calendar example, 3-5 days
SRC-063Google: Gmail API scopeshttps://developers.google.com/workspace/gmail/api/auth/scopesprovider-docs2026-10-16Gmail scope classification
SRC-064Google: Drive API scopeshttps://developers.google.com/workspace/drive/api/guides/api-specific-authprovider-docs2026-10-16Drive scope classification, drive.file
SRC-065Microsoft: Publisher verification overviewhttps://learn.microsoft.com/en-us/entra/identity-platform/publisher-verification-overviewprovider-docs2026-10-16Requirements, consent effect, cost
SRC-066Slack: Marketplace review guidehttps://docs.slack.dev/slack-marketplace/slack-marketplace-review-guideprovider-docs2026-10-1610-workspace minimum, review timelines
SRC-067Meta: WhatsApp Business Platform pricinghttps://developers.facebook.com/docs/whatsapp/pricingprovider-docs2026-10-16Per-message pricing, service window, BRL billing
SRC-068Meta: Get started for Tech Providers (WhatsApp)https://developers.facebook.com/docs/whatsapp/solution-providers/get-started-for-tech-providersprovider-docs2026-10-16Tech Provider requirements for SaaS
SRC-069Help: Tasks feature availability and limitshttps://help.clickup.com/hc/en-us/articles/29664799512855-Tasks-feature-availability-and-limitsdocs2026-10-16Task performance limits, multi-List limits
SRC-070ClickUp AI / LLM info pagehttps://clickup.com/ai-llm-info-pagedocs2026-10-165M+ teams, $300M ARR (2025) claims
+

15Evidence

Every statement cites its evidence: [obs EV-###] seen in the product, [net EV-###] captured on the network, [doc SRC-###] public documentation, [inf] an inference with an open question.

EV-002 Board view of an empty list: three status columns and Add group
EV-003 Fields side panel opened after creating a list: Create new tab with AI Suggestions, Popular and All field types
EV-006 Card hover toolbar and the priority picker opened from the card flag icon
EV-008 Date picker opened from a card: start and due inputs, quick options, month grid, Set Recurring
EV-009 Date picker with a start and due date selected (range highlighted)
EV-010 Card date chips: overdue in red (3 days ago), today in yellow, range Today - Mon; priority chip High
EV-012 After Mark complete on a card: card moved to COMPLETE, counts 53/1, toast Status changed with Undo; v-03 sits above v-02
EV-013 Card hover toolbar: Mark complete (tooltip), Add subtask, Rename, More
EV-015 Column menu (Group options) on a column with tasks: Collapse, Archive all, Automate status, Select all, Rename, Edit statuses
EV-016 Column menu on an empty column: no Archive all and no Select all
EV-017 Collapsed column as a vertical strip; Save view button appears in the toolbar (view draft)
EV-018 Board loading state: column header and card skeletons while the view re-queries
EV-019 Customize view side panel: name, More options, Fields, Filter, Group, Sort, Subtasks, Templates, view toggles (autosave, pin, private, protect, default), sharing
EV-020 Card size Small (draft): narrower columns, fields wrap; Save view visible; card options list (cover, stack fields, show empty fields, collapse empty columns)
EV-021 Card size Large (draft) and the Card cover options: Auto, None, Image (default), Task description
EV-022 Layout options panel: page and card layout toggles, task visibility, view settings, reset
EV-023 Stack fields on and Show empty fields off (draft): empty cards show only the title; filled fields stack one per row
EV-024 Card More menu: Copy link, Copy ID, New tab; Favorite, Rename, Unfollow, Remind me; Move to, Add to, Merge, Duplicate, Convert to, Custom Fields, Templates; Relationships, Task Type; Start timer, Send email to task; Archive, Delete; Sharing & Permissions
EV-025 Group by popover: field, direction, delete, Add subgroup; field options Status, Assignee, Priority, Tags, Due date, Task Type
EV-026 Board grouped by Priority (draft): Urgent, High, Normal, Low, No priority columns; cards show a status chip; Save view visible
EV-027 Group Priority with subgroup Status (draft): priority columns and collapsible status swimlanes with counts
EV-028 Bulk action bar after Select all in a column: count, clear, Status, Assignees, Dates, Custom Fields (disabled with no fields), Tags, Move/Add, Convert to Subtask, Copy, duplicate, archive, delete, More
EV-029 Inline create form inside a column: Task Name, Save (disabled while empty), Add assignee, Add dates, Add priority, Add tag
EV-030 After creating in IN PROGRESS: card at the top of the column with that status, form reopened below, toast Task created with Pin to bottom, Copy URL, View task
EV-031 Second tab 3 s after setting priority Low in the first tab: not updated yet
EV-032 Second tab about 8 s later, no reload: card shows Low
EV-033 Keyboard focus on a card field toggle (assignee): white rounded outline
EV-036 Add group form: color dot, Status name, confirm check button (Enter does not submit)
EV-037 Dialog after Add group: Where should this new status apply? List only (default) or Entire Space
EV-038 New status column [RE] REVIEW inserted before COMPLETE, name shown uppercase
EV-039 Filters popover: Ask AI to build filters, Saved filters, Select filter list (Status, Tags, Due date, Priority, Assignee, Archived, Assigned comment, Created by, Date closed, Date created...)
EV-040 Tag picker on a card with a new name typed: Select an option, Create <name>, settings gear
EV-041 Assignee picker on a card: Search or enter email, Me (avatar masked), Assign with AI
EV-042 After assigning yourself: a prompt to add the task to your priorities with Don't ask again and Add to priorities (name masked)
EV-043 View Fields panel (Add existing): Shown (Task Name, Assignee, Dates, Priority, Tags), Properties (Date closed, Date created, Date updated, Status, Task ID, Task Type, Time tracked), Custom Fields in Workspace
EV-044 Fields panel lists 7 Custom Fields in Workspace (Category x2, Likes, Mode, Summary x2, Type) that the Custom Field Manager does not show
EV-045 Custom Field Manager, All Custom Fields: No matching results found (same moment as EV-044)
EV-047 Right after Create List: List settings dialog with AI suggested Default Task Type, Default views, Custom Fields, Statuses (Generating...), No thanks, Apply suggestions; Fields panel opened on the right
EV-048 Sidebar of the new workspace: Space with one List, channels Welcome and General (cropped above the direct messages)
EV-051 Task view (Full screen) annotated: 1 header, 2 hero (type, title, AI bar), 3 fields grid, 4 description, 5 sections (fields, subtasks, relations, checklist, attachments), 6 activity sidebar with comment box
EV-052 Switch layout popover on hover: Modal, Full screen (current), Sidebar
EV-054 Status picker in the task view: search, groups Not started (TO DO), Active (IN PROGRESS, [RE] REVIEW), Closed (COMPLETE)
EV-055 Description editor: '- ' turned into a bullet list; **bold** typed inline stayed literal; history and full-screen icons
EV-056 Comment composer with text and toolbar (add, AI, attach, mention, assign, emoji, clip, task, doc, send with menu)
EV-057 Posted comment in the activity stream (author masked), Just now, reactions, Reply; composer placeholder changes
EV-059 Task view of an overdue task: Dates shows Start -> 3 days ago in red; empty fields read Empty (0.6 scale)
EV-060 216-character title wraps over four lines in the task view without truncation
EV-061 Add subtask opens the Subtasks section with Sort, expand, Suggest (AI), + and an input
EV-062 Subtasks section after two creates: 2 open with progress bar, table Name/Assignee/Priority, Add Task row; subtask count in the header; activity lines
EV-064 Relate items menu: Relate a Task or Doc, This task blocks..., This task is blocked by..., New custom relationship
EV-065 Blocked task after adding a dependency: Blocked by row under the fields (warning icon), relation count in the header, Related/Dependencies tabs with a Blocked by table
EV-066 The other task shows Blocking (red icon) and an activity line You marked this task as blocking
EV-067 Create checklist creates a checklist named Checklist at once (name in edit mode), Add item, Add checklist (0.6 scale)
EV-068 Board after task-view edits: description icon on a card, 2 subtasks toggle, dependency warning badge with count
EV-070 Card property badges: 2 subtasks toggle, waiting-on dependency (yellow warning 1), blocking (red 1), checklist progress 0/3
EV-071 Checklists section: 3 open with progress bar, named checklist, items with circles, Add item, Add checklist; activity aggregates 'added 3 items'; header checklist count
EV-072 After resolving one item: 2 open, the item hides under Show 1 completed; item hover actions
EV-073 Next-status arrow moved TO DO to IN PROGRESS; activity line with both status colors; Status changed toast with Undo; Collapse empty fields link
EV-074 Sidebar layout: board stays visible on the left, the task opens as a right panel; layout popover shows Sidebar selected
EV-075 Modal layout: centered overlay over a dimmed page, activity panel inside the modal
EV-076 Task view More menu: card menu items plus Description history and Print
EV-077 Task type menu: Task (default), Milestone, Form Response, Meeting Note; Recommended Asset, Campaign, Goal, Person, Resource; Create Task Type; Fill with AI
EV-078 After a full reload: description with bullets and the comment persisted; the task opened in Full screen again (0.5 scale)
EV-079 Add fields in the task view: search, Create new / Add existing, Popular types, All types starting with Button
EV-080 Create Dropdown form: type switcher, Field name, Dropdown options with color dots, Set default, delete, Add option, AI option generator, AI Autofill, Permissions and settings, Cancel, Create
EV-081 Field Permissions and settings: description, permissions, exceptions (creator masked), Required in tasks, Pinned, Visible to Guests and Limited Members, Belongs to the list
EV-082 Clicking Required in tasks on Free Forever: tooltip explains the rule, the switch stays off, no message
EV-083 Clicking Pinned on Free Forever opens Upgrade to Business to unlock Pinning Custom Fields (USD price); closed without choosing
EV-084 Number field form: Number format US (1,234.56) or EU (1.234,56)
EV-085 Money field form: currency BRL - Brazilian Real (R$), number format EU
EV-086 Voting field form: emoji type, Hide users who have voted
EV-087 Tasks field form: Relationship name, related to any task in the workspace or tasks from a specific List, Create rollup fields
EV-088 People field form: show people from the entire workspace, show guests, select multiple people (on), include teams
EV-089 Rating field form: emoji type (star), scale slider 1 to 5, default 3
EV-090 Progress (Auto) form: track completion of subtasks, checklists, assigned comments; tasks without action items show 100% when done
EV-091 Progress (Manual) form: start value 0, end value 100
EV-092 Labels form: options required (Create disabled until one exists), color dots, Set default, manual sort, AI option generator
EV-093 Relationship form: tasks from a specific List, related list required (the field's own list could not be chosen), create rollup fields from the related list
EV-094 Button form: name, button label and color, Action required: Add automation
EV-095 AI Summary preset: a Text area field with AI Autofill on and a prompt
EV-096 Create new type menu, top: AI Fields (Summary, Custom Text, Custom Dropdown), then All
EV-097 Create new type menu, bottom: Progress, Email, Phone, Categorize, Custom Dropdown, Translation, Sentiment, Tasks, Location, Rating, Voting, Signature, Button, Action Items, T-shirt Size
EV-098 Custom Field Manager, all fields grouped by type with a Create <type> field link per group; columns Name, Type, Created by (masked), Date Created, Location(s)
EV-100 Task view Fields section: one row per field with type icon; dropdown picker with search, colored options and drag handles
EV-101 Labels field holding two labels as colored pills; money shows the R$ prefix while empty
EV-102 Money field input in BRL with Brazilian separators: R$ 1.234,56
EV-103 Number field with European format shows 1.234,5
EV-104 Phone field input defaults to the flag and sample number of the profile country (masked: account data)
EV-105 Phone field after picking Brazil: (11) 90000-0000 with Brazilian mask
EV-106 People field picker: Me (avatar masked) and Keep typing a full email to invite; activity lines per field change
EV-107 Manual progress field as a slider at 61%
EV-108 Text area field edits in a large popover editor; voting shows a thumbs up with 0
EV-109 Voting field after one vote: thumbs up with 1; textarea value on two lines
EV-110 Signature field pad in Type mode renders the typed name in a script font; Clear, Cancel, Save
EV-111 Saved values: rating 2 of 3 stars, signature image, text, textarea, voting 1, website as domain with favicon
EV-113 Location field: typing a street shows one Google Places suggestion (Av. Paulista, São Paulo - SP, Brazil); people value masked
EV-114 Location saved as the formatted address; money and number with Brazilian and European separators
EV-115 Formula field simple editor: field, operator, field; message Select a second field to calculate; Advanced Editor toggle
EV-116 Formula number + money shows R$ 2.469,06, formatted as money; people value masked
EV-117 Task view with every field filled; activity log has one line per field change (people line masked)
EV-118 Relate menu lists the Tasks and Relationship custom fields under the dependency options, then New custom relationship
EV-119 Related section with a tab per relationship field ([RE] cf-tasks 1) and a table Name, Due date, Priority
EV-120 Board with all 22 custom fields shown (unsaved view draft): every field takes a row with its type icon; empty money and formula show R$ 0, rating three grey stars, voting 0, relationship fields an Add task button
EV-121 Card of [RE] all fields with every value: dropdown pill, text, textarea first line with ellipsis, number, money, date, checkbox, email, signature, voting, tasks chip with +, people (masked), rating, progress bars, labels, formula, phone, website, files dash, location truncated
EV-122 Clicking the dropdown pill on a card opens the same option picker inline; hovering the icon shows the field name and Custom Field
EV-123 Customize > Fields: Shown section grows as fields are toggled on; Properties; Custom Fields; Custom Fields in Workspace (7, not created by the study); Save view appears
EV-124 After a reload the board is back to its saved settings: no custom field rows, no Save view, search cleared
EV-125 Field settings popover from the row gear: type switcher, Advanced, name, options with manual sort, Add option, AI Autofill Off, delete icon, Cancel, Save
EV-126 Delete confirmation: This action will delete this Custom Field from 1 task. Admins are able to restore deleted fields from the Trash.
EV-127 After delete: the dropdown row is gone from the task and a toast says Field deleted successfully (no Undo)
EV-128 Settings > Trash: deleted field listed with Location (1 location), Deleted on, Deleted by (masked); filter Me on by default; 30-day notice; Clear all Trash
EV-129 After Restore from Trash the dropdown field is back on the task with its old value [RE] opt A
EV-130 On another task the empty phone field now defaults to Brazil: the country picked earlier was saved to the user profile, not to the field
EV-131 After picking the original country again (PUT /user/v1/user) and a reload, the phone field defaults to it (flag masked: account data); no phone value was saved
EV-132 Delete list confirmation: 54 tasks and templates within this List will be deleted; automations will become inactive
EV-133 Trash after deleting the list: one row for the list (tasks are not listed separately), Deleted by masked
EV-134 Custom Field Manager after deleting the list: All Custom Fields empty; sections Workspace Fields, Task Type Fields, Personal List, By Location, By Task Type
EV-135 Tag Manager on Free Forever opens Upgrade to Business Plus (USD price); closed without choosing
EV-136 Delete tag from the tag picker: Are you sure you want to delete the tag everywhere in this Space?
EV-137 Trash after teardown: the temporary task, the tag (tags go to Trash too) and the list; Deleted by masked; 30-day notice
EV-138 Global search for [RE] right after the list was deleted still lists its tasks (In Space)

Captures that are not images

Network shapes, script output and notes, kept in the knowledge base folder.

IDShowsFileSize
EV-001Integration list by category; none connected (text capture)evidence/EV-001-app-center-integrations.json1.9 KB
EV-004Custom field types listed in the Fields panel (text capture)evidence/EV-004-field-types-panel.json1.3 KB
EV-005Fetch requests on a full load of the board view (URL templates, no values)evidence/EV-005-network-board-load.txt2.8 KB
EV-007Network shape: set priority from a board card (PUT /tasks/v1/item)evidence/EV-007-net-card-set-priority.json2.1 KB
EV-011inventory.js on the board (trimmed, IDs scrubbed)evidence/EV-011-inventory-board.json5.3 KB
EV-014Network shapes for card actions: dates, assignee, tag, mark complete, collapse group draft, column pagingevidence/EV-014-net-board-card-actions.json6.6 KB
EV-034Keyboard focus order on a board card (text log)evidence/EV-034-board-keyboard-focus-order.txt0.9 KB
EV-035tokens.js on the board in dark theme, element styles and semantic variablesevidence/EV-035-tokens-board-dark.json5.0 KB
EV-046Probe log: counts, widths, virtual scroll, drag DOM, viewport (text)evidence/EV-046-board-probe-log.txt1.3 KB
EV-050Compact inventory of the task view: component tree and field test IDsevidence/EV-050-inventory-task-view.json3.3 KB
EV-053Network on task open: call list and the task detail shapeevidence/EV-053-net-task-open.json7.0 KB
EV-058Network shapes for posting a comment; task viewed write; history itemevidence/EV-058-net-comment.json2.6 KB
EV-063Network shape: create a subtask (task create endpoint), order indexes per groupingevidence/EV-063-net-create-subtask.json3.0 KB
EV-069Network shapes: dependency, checklist create, rename, itemsevidence/EV-069-net-dependency-checklist.json2.2 KB
EV-099Network shapes for creating a custom field: definition, location, type_config per typeevidence/EV-099-net-cf-create.json2.1 KB
EV-112Network shapes for setting each custom field value, and the usage counter responseevidence/EV-112-net-cf-values.json4.7 KB
EV-139Accessible name of a custom field value cell (text)evidence/EV-139-a11y-cf-value-button.txt0.2 KB
EV-140Per-user UI state write for the global Create button (text)evidence/EV-140-net-growth-ui-flag.txt0.4 KB
+
Generated by RES (Reverse Engineering SaaS) from the knowledge base in this folder. The launch analysis is research, not legal advice. Rebuild from behavior; do not copy the original product's code, assets or brand.
+

+ diff --git a/examples/pipedrive/REPORT.html b/examples/pipedrive/REPORT.html index 6465682..2186db2 100644 --- a/examples/pipedrive/REPORT.html +++ b/examples/pipedrive/REPORT.html @@ -6,487 +6,440 @@ Pipedrive: reverse engineering report + + + + + -
-

Reverse engineering report · RES

+
+
Reverse engineering study · Updated 2026-10-16 · Environment L3 · Phase 7 Close
+
+

RES · Reverse Engineering SaaS

Pipedrive

-

How Pipedrive works, how to rebuild it, and what to prepare before launch.

-
Updated 2026-10-16Environment L3Phase 7 Close
-
-
- +

Document Pipedrive's deals pipeline, activities and won/lost flows well enough that a team that never used it can rebuild them, and list what would stop a sellable CRM clone from launching

+ + +

Pipedrive, documented from the outside: 4 screens, 8 components, 4 user flows and 46 business rules, each tied to evidence.

  1. Covered. pipeline board, deal detail, activities and the next-activity rule, won, lost, deal creation, pipeline editor, deletion (F-001 to F-009): 46 rules, 4 screens, 8 components, 4 flows, 10 entities, 15 production barriers for a Brazilian SMB clone.
  2. Not covered. email and calendar sync, WhatsApp and e-signature (connecting them reaches people, A5: public sources only), company settings (A4, read only, not exercised), anything that needs a second user, the activities list beyond its toolbar.
  3. Decide. get counsel's view on Pipedrive's terms before building on this study (BR-001), and create a trial account (L1) to answer Q-001 to Q-009.
+
17
features
4
screens
8
components
4
user flows
46
business rules
10
entities
15
launch items
63
evidence files
-
-

Reading this as a person

This page is the readable report of the study. Start with the overview, then read in order: what the product does, how it looks and behaves, how to build it, and what to prepare before launch.

-

If you are an AI agent

Do not build from this page: it is generated for people. Open BUILD.md in this folder and follow its read order. The Markdown files next to it are the source of truth.

-
-

01

Overview

What was studied, how far the study went, and what needs your decision.

  • Covered: pipeline board, deal detail, activities and the next-activity rule, won, lost, deal creation, pipeline editor, deletion (F-001 to F-009): 46 rules, 4 screens, 8 components, 4 flows, 10 entities, 15 production barriers for a Brazilian SMB clone.
  • Not covered: email and calendar sync, WhatsApp and e-signature (connecting them reaches people, A5: public sources only), company settings (A4, read only, not exercised), anything that needs a second user, the activities list beyond its toolbar.
  • Decide: get counsel's view on Pipedrive's terms before building on this study (BR-001), and create a trial account (L1) to answer Q-001 to Q-009.
17features
4screens
8components
46business rules
10entities
15launch items
63evidence files

How far the study went: 48% done

61 done29 partial34 blocked4 todo

Needs your decision

  • Pipedrive Terms s.4.1 forbid reverse engineering and using the service to build a competing product (SRC-031). Decide with counsel whether this study may be used (BR-001, Q-010).
  • Create a dedicated trial account (L1) in a separate browser profile, with a second user, for permissions, realtime and notifications (Q-006, Q-009) and for the integrations (F-013 to F-016) with test mailboxes and calendars you own.
  • Check by hand whether the first click on Won, Lost and item menus is ignored in a focused window (Q-001).

Blocked

  • F-013 Email sync, F-014 Calendar sync, F-015 WhatsApp, F-016 E-signature: connecting accounts or sending documents is A5. Needs L1 with the user's own test accounts.
  • F-017 Company settings: A4 at L3; read only, not exercised.
  • F-012 Visibility as seen by other users: needs a second user (L1).
-

02

What the product does

Every feature found, its plan and priority, the screens it lives on, and how deeply each one was studied.

Priority: P1 named by the user, P2 core loop, P3 data model completeness, P4 collaboration, P5 admin and settings.

-
IDAreaFeaturePlanPriorityScreensBarriersStatusSource
F-001DealsPipeline board: stage columns, deal cards, activity status icons, default sort, weighted totals, rotting, drag targetsAll plansP1S-001BR-014done[obs EV-010] [doc SRC-001]
F-002DealsDeal detail view: header, stage bar, summary, composer, Focus, HistoryAll plansP1S-002BR-014done[obs EV-027] [doc SRC-007]
F-003ActivitiesActivity form, card popover, mark as done, day agendaAll plansP1S-001, S-002BR-003, BR-004done[obs EV-019] [doc SRC-008]
F-004ActivitiesSchedule-next-activity rule (prompt when the last open activity is done)All plans; disabling it is plan-gatedP1S-001, S-002nonedone[obs EV-022] [doc SRC-010]
F-005DealsWon flow: mark won, celebration and follow-up prompt, reopenAll plansP1S-002nonedone[obs EV-034]
F-006DealsLost flow: lost reason, comment as note, reopenAll plansP1S-002nonedone[obs EV-042] [doc SRC-011]
F-007DealsAdd deal form and its validationAll plansP2S-001nonedone[obs EV-050]
F-008DealsPipeline editor: stages, probabilities, rotting, delete stageAll plans; admins onlyP2S-003nonedone[obs EV-008] [doc SRC-004]
F-009DataDeleting deals, activities, notes, pipelines and organizations; 30-day restoreAll plansP2S-002, S-003, S-005nonepartial[obs EV-046] [doc SRC-015]
F-010ActivitiesActivities list view (toolbar, period tabs, type filter)All plansP2S-004nonepartial[obs EV-056]
F-011InterfaceQuick add menu and keyboard shortcutsAll plansP3S-001nonepartial[obs EV-055] [doc SRC-016]
F-012PermissionsItem visibility levels and visibility groupsGroups on Premium and UltimateP4S-001BR-013partial[obs EV-052] [doc SRC-041]
F-013IntegrationsEmail sync (Gmail, Microsoft 365, IMAP)Growth and upP5none studiedBR-002, BR-004, BR-012blocked[doc SRC-036]
F-014IntegrationsCalendar sync and activity invitesPaid plansP5none studiedBR-003, BR-004blocked[doc SRC-037] [doc SRC-009]
F-015IntegrationsWhatsApp through Meta's Business PlatformGrowth and upP5none studiedBR-005blocked[doc SRC-038]
F-016DocumentsSmart Docs e-signaturePremium and Ultimate, add-on belowP5none studiedBR-006blocked[doc SRC-039]
F-017SettingsCompany activity settings (won follow-up prompt), lost reasons, automationsAutomations from GrowthP5S-006nonepartial[doc SRC-010] [doc SRC-012]
-

Screen catalog

IDScreenURL patternEntry pointsFeaturesFile
S-001Pipeline board/pipeline/:id/user/everyone (/deals-default redirects to the last viewed pipeline)Sidebar > DealsF-001, F-003, F-004, F-007, F-011, F-012screens/S-001-pipeline-board.md
S-002Deal detail/deal/:idClick a card title; toast "View" after creating a dealF-002, F-003, F-004, F-005, F-006, F-009screens/S-002-deal-detail.md
S-003Pipeline editor/pipeline/:id/add (new), /pipeline/:id/edit (existing)Pipeline selector > New pipeline; pencil button on the boardF-008, F-009screens/S-003-pipeline-editor.md
S-004Activities list/activities/list/user/:idSidebar > ActivitiesF-010screens/S-004-activities-list.md
S-005Organization detail/organization/:idOrganization link on a card or dealF-009none (only its delete dialog was studied)
S-006Settings: activities, lost reasons, restore data/settings/activity_settings, /settings/company-settings/lost-reasons, /settings/restoreAccount menu > Company settings; Tools and appsF-009, F-017none (read only, company configuration)
-

Coverage by feature

Values: todo, partial, done, blocked, n/a. The work queue is this table, top to bottom.

-
FeatureAnatomyStatesInteractionsRulesDataNetworkKeyboard and a11yPersistenceDesignNotes
F-001 Pipeline boarddonedonepartialdonedonepartialpartialpartialdoneDrag did not complete (drop zones only); card customization and filters not opened; sort persistence not changed (shared preference)
F-002 Deal detaildonedonepartialdonedonedonepartialpartialpartialComposer tabs other than Activity not opened; Changelog tab not opened
F-003 ActivitiesdonedonedonedonedonedonepartialdonepartialGuests, location, video call and recurrence not tested (would reach people or need sync)
F-004 Next-activity ruledonedonedonedonedonedonen/adonedoneFrom the Activities list and calendar not tested
F-005 Won flowdonedonedonedonedonepartialn/adonedoneWon dropdown (create project) not opened; drag to Won not completed
F-006 Lost flowdonedonedonedonedonedonen/adonedoneFree-form reason never offered (Q-003)
F-007 Add deal formdonedonedonedonedonedonepartialdonepartialPerson creation and custom fields not exercised (company fields)
F-008 Pipeline editordonedonepartialdonedonen/an/adonepartialStage reorder by drag and duplicate pipeline not tested
F-009 Delete and restorepartialdonedonedonedonedonen/adonen/aRestore itself not exercised; Restore data read only
F-010 Activities listpartialpartialtodopartialn/atodotodotodopartialRows show production data: only the toolbar was captured
F-011 Quick add and shortcutsdonen/apartialdonen/an/apartialn/an/aShortcut keys not pressed (focus could hit production records)
F-012 Visibilitypartialn/apartialpartialdonen/an/ablockedn/aEffect on other users needs a second account (L1)
F-013 Email syncblockedblockedblockedblockedpartialblockedblockedblockedblockedConnecting a mailbox is A5; documented from public sources
F-014 Calendar syncblockedblockedblockedblockedpartialblockedblockedblockedblockedSync was inactive and stays so (A5); public sources only
F-015 WhatsAppblockedblockedblockedblockedn/ablockedblockedblockedblockedConnecting is A5; public sources only
F-016 E-signatureblockedblockedblockedblockedn/ablockedblockedblockedblockedSending a document reaches signers (A5); public sources only
F-017 Company settingspartialn/ablockedpartialn/an/an/an/an/aA4: read only, not exercised
-

03

Screens

Each screen: its layout, states, interactions, keyboard behavior and text. Open one to read it.

S-001 Pipeline board

Features: F-001, F-003, F-004, F-007, F-011, F-012 · URL: /pipeline/:id/user/everyone · Status: done

-

Purpose

-

The seller's daily work queue. One column per stage of the selected pipeline, one card per open deal, and on each card an icon that says whether the deal has a next step and when it is due. The default order puts what needs action today at the top of every column.

-

Entry points

+

01Overview

What needs your decision, how far the study went, and what comes next.

i

If you are an AI agent

Do not build from this page: it is generated for people. Open BUILD.md in this folder and follow its read order. The Markdown files next to it are the source of truth.

!
Needs your decision
  • Pipedrive Terms s.4.1 forbid reverse engineering and using the service to build a competing product (SRC-031). Decide with counsel whether this study may be used (BR-001, Q-010).
  • Create a dedicated trial account (L1) in a separate browser profile, with a second user, for permissions, realtime and notifications (Q-006, Q-009) and for the integrations (F-013 to F-016) with test mailboxes and calendars you own.
  • Check by hand whether the first click on Won, Lost and item menus is ignored in a focused window (Q-001).
×
Blocked
  • F-013 Email sync, F-014 Calendar sync, F-015 WhatsApp, F-016 E-signature: connecting accounts or sending documents is A5. Needs L1 with the user's own test accounts.
  • F-017 Company settings: A4 at L3; read only, not exercised.
  • F-012 Visibility as seen by other users: needs a second user (L1).

How far the study went: 48% of checks done

61 done29 partial34 blocked4 todo

Next actions

  1. In an L1 trial with two users: answer Q-001 to Q-009 (first-click behavior, restore of activities, free-form lost reasons, visibility for another user, realtime).
  2. Study the deal list view, the forecast view, card customization and drag-to-close (Not tested items of S-001) in L1.
  3. Start the month-one barriers from clone/prd.md: BR-007, BR-009, BR-005, BR-002.
+

02What the product does

Every feature found, its plan and priority, the screens it lives on, and how deeply each one was studied.

Priority: P1 named by the user, P2 core loop, P3 data model completeness, P4 collaboration, P5 admin and settings.

+
IDAreaFeaturePlanPriorityScreensBarriersStatusSource
F-001DealsPipeline board: stage columns, deal cards, activity status icons, default sort, weighted totals, rotting, drag targetsAll plansP1S-001BR-014done[obs EV-010] [doc SRC-001]
F-002DealsDeal detail view: header, stage bar, summary, composer, Focus, HistoryAll plansP1S-002BR-014done[obs EV-027] [doc SRC-007]
F-003ActivitiesActivity form, card popover, mark as done, day agendaAll plansP1S-001, S-002BR-003, BR-004done[obs EV-019] [doc SRC-008]
F-004ActivitiesSchedule-next-activity rule (prompt when the last open activity is done)All plans; disabling it is plan-gatedP1S-001, S-002nonedone[obs EV-022] [doc SRC-010]
F-005DealsWon flow: mark won, celebration and follow-up prompt, reopenAll plansP1S-002nonedone[obs EV-034]
F-006DealsLost flow: lost reason, comment as note, reopenAll plansP1S-002nonedone[obs EV-042] [doc SRC-011]
F-007DealsAdd deal form and its validationAll plansP2S-001nonedone[obs EV-050]
F-008DealsPipeline editor: stages, probabilities, rotting, delete stageAll plans; admins onlyP2S-003nonedone[obs EV-008] [doc SRC-004]
F-009DataDeleting deals, activities, notes, pipelines and organizations; 30-day restoreAll plansP2S-002, S-003, S-005nonepartial[obs EV-046] [doc SRC-015]
F-010ActivitiesActivities list view (toolbar, period tabs, type filter)All plansP2S-004nonepartial[obs EV-056]
F-011InterfaceQuick add menu and keyboard shortcutsAll plansP3S-001nonepartial[obs EV-055] [doc SRC-016]
F-012PermissionsItem visibility levels and visibility groupsGroups on Premium and UltimateP4S-001BR-013partial[obs EV-052] [doc SRC-041]
F-013IntegrationsEmail sync (Gmail, Microsoft 365, IMAP)Growth and upP5none studiedBR-002, BR-004, BR-012blocked[doc SRC-036]
F-014IntegrationsCalendar sync and activity invitesPaid plansP5none studiedBR-003, BR-004blocked[doc SRC-037] [doc SRC-009]
F-015IntegrationsWhatsApp through Meta's Business PlatformGrowth and upP5none studiedBR-005blocked[doc SRC-038]
F-016DocumentsSmart Docs e-signaturePremium and Ultimate, add-on belowP5none studiedBR-006blocked[doc SRC-039]
F-017SettingsCompany activity settings (won follow-up prompt), lost reasons, automationsAutomations from GrowthP5S-006nonepartial[doc SRC-010] [doc SRC-012]
+

Screen catalog

IDScreenURL patternEntry pointsFeaturesFile
S-001Pipeline board/pipeline/:id/user/everyone (/deals-default redirects to the last viewed pipeline)Sidebar > DealsF-001, F-003, F-004, F-007, F-011, F-012screens/S-001-pipeline-board.md
S-002Deal detail/deal/:idClick a card title; toast "View" after creating a dealF-002, F-003, F-004, F-005, F-006, F-009screens/S-002-deal-detail.md
S-003Pipeline editor/pipeline/:id/add (new), /pipeline/:id/edit (existing)Pipeline selector > New pipeline; pencil button on the boardF-008, F-009screens/S-003-pipeline-editor.md
S-004Activities list/activities/list/user/:idSidebar > ActivitiesF-010screens/S-004-activities-list.md
S-005Organization detail/organization/:idOrganization link on a card or dealF-009none (only its delete dialog was studied)
S-006Settings: activities, lost reasons, restore data/settings/activity_settings, /settings/company-settings/lost-reasons, /settings/restoreAccount menu > Company settings; Tools and appsF-009, F-017none (read only, company configuration)
+
Coverage by feature which parts of each feature were checked

Values: todo, partial, done, blocked, n/a. The work queue is this table, top to bottom.

+
FeatureAnatomyStatesInteractionsRulesDataNetworkKeyboard and a11yPersistenceDesignNotes
F-001 Pipeline boarddonedonepartialdonedonepartialpartialpartialdoneDrag did not complete (drop zones only); card customization and filters not opened; sort persistence not changed (shared preference)
F-002 Deal detaildonedonepartialdonedonedonepartialpartialpartialComposer tabs other than Activity not opened; Changelog tab not opened
F-003 ActivitiesdonedonedonedonedonedonepartialdonepartialGuests, location, video call and recurrence not tested (would reach people or need sync)
F-004 Next-activity ruledonedonedonedonedonedonen/adonedoneFrom the Activities list and calendar not tested
F-005 Won flowdonedonedonedonedonepartialn/adonedoneWon dropdown (create project) not opened; drag to Won not completed
F-006 Lost flowdonedonedonedonedonedonen/adonedoneFree-form reason never offered (Q-003)
F-007 Add deal formdonedonedonedonedonedonepartialdonepartialPerson creation and custom fields not exercised (company fields)
F-008 Pipeline editordonedonepartialdonedonen/an/adonepartialStage reorder by drag and duplicate pipeline not tested
F-009 Delete and restorepartialdonedonedonedonedonen/adonen/aRestore itself not exercised; Restore data read only
F-010 Activities listpartialpartialtodopartialn/atodotodotodopartialRows show production data: only the toolbar was captured
F-011 Quick add and shortcutsdonen/apartialdonen/an/apartialn/an/aShortcut keys not pressed (focus could hit production records)
F-012 Visibilitypartialn/apartialpartialdonen/an/ablockedn/aEffect on other users needs a second account (L1)
F-013 Email syncblockedblockedblockedblockedpartialblockedblockedblockedblockedConnecting a mailbox is A5; documented from public sources
F-014 Calendar syncblockedblockedblockedblockedpartialblockedblockedblockedblockedSync was inactive and stays so (A5); public sources only
F-015 WhatsAppblockedblockedblockedblockedn/ablockedblockedblockedblockedConnecting is A5; public sources only
F-016 E-signatureblockedblockedblockedblockedn/ablockedblockedblockedblockedSending a document reaches signers (A5); public sources only
F-017 Company settingspartialn/ablockedpartialn/an/an/an/an/aA4: read only, not exercised
+

03Screens

Each screen with its annotated anatomy, the screenshots taken of it, and the states it can be in. Click a picture to enlarge it.

S-001

Pipeline board

FeaturesF-001, F-003, F-004, F-007, F-011, F-012URL/pipeline/:id/user/everyoneStatusdone

The seller's daily work queue. One column per stage of the selected pipeline, one card per open deal, and on each card an icon that says whether the deal has a next step and when it is due. The default order puts what needs action today at the top of every column.

EV-011 Board anatomy with numbered regions (annotate.js)

Anatomy

  1. 1
    Board viewToolbar, quick-filter bar and stage columns
  2. 2
    Add deal split button C-007"+ Deal" opens the Add deal form; the arrow opens more create options
  3. 3
    Deal count"N deals" with an info icon whose tooltip is "Show deals total value"
  4. 4
    Pipeline selectorPipeline name with menu: other pipelines, Reorder pipelines, Pipeline visibility, Customize deal cards, Pipeline layout settings, New pipeline
  5. 5
    Edit pipelinePencil button that opens the pipeline editor (S-003)
  6. 6
    FilterSaved filters and users
  7. 7
    Quick filter bar"Add condition"
  8. 8
    SortDirection arrow and "Sort by: Next activity" menu; "Show closed deals" link to its left
  9. 9
    Stage headerStage name, weighted value total (balance icon), deal count; chevron shape between columns
  10. 10
    Deal card C-001Title, organization or person, owner avatar, value, rotting badge
  11. 11
    Activity status icon C-002One of four states; click opens a popover

More from this screen 19 screenshots

EV-049 Add deal form: core fields column (cropped)
EV-017 Tooltip of the info icon next to the deal count
EV-026 Sort menu (14 options; Next activity default) and the board re-sorted after reload
EV-010 Sandbox board: four activity states; rotting card; weighted stage totals; default sort
EV-012 Tooltip of the red overdue icon
EV-016 Rotting badge and its tooltip
Show 13 more
EV-053 Deal created from the form: toast with View; card on top of its stage with a NEW badge
EV-013 Tooltip of the yellow no-activity icon
EV-014 Tooltip of the grey upcoming icon
EV-015 Tooltip of the green today icon
EV-018 Popover of the no-activity icon
EV-019 Popover of a deal with three open activities (relative dates; done circles)
EV-020 Marking one of three activities done: strike-through; toast; no modal; icon turns grey; badge 29 to 28
EV-022 Schedule your next activity modal (form and day agenda)
EV-054 Dragging a card shows four drop zones at the bottom: Delete; Lost; Won; Move to
EV-003 New pipeline editor with its 5 default stages (100% each) and the Deal probability toggle on
EV-055 Quick add menu with one-key shortcuts
EV-024 After Cancel: the deal shows the yellow no-activity icon; board not re-sorted until reload
EV-021 Marking the last open activity done: toast and modal skeleton while loading

States

EmptyEmpty column with header "R$ 0"; "+" appears on column hover
LoadingToolbar first, cards after; the pipeline selector fills in last
TypicalMixed icons and values
Long textWraps to three lines; no truncation
RottingPink card and red "<1d" badge
New dealCard at the top of the stage with a NEW badge until reload

Not reached: Many items, Error, No permission, Plan-gated

Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Sidebar > Deals. /deals-default redirects to the last viewed pipeline [obs EV-001].
  • The pipeline selector in the toolbar switches pipelines [obs EV-011].
-

Anatomy

-

Anatomy

-
#RegionContentsComponentEvidence
1Board viewToolbar, quick-filter bar and stage columnsnone[obs EV-011]
2Add deal split button"+ Deal" opens the Add deal form; the arrow opens more create optionsC-007[obs EV-011] [obs EV-049]
3Deal count"N deals" with an info icon whose tooltip is "Show deals total value"none[obs EV-017]
4Pipeline selectorPipeline name with menu: other pipelines, Reorder pipelines, Pipeline visibility, Customize deal cards, Pipeline layout settings, New pipelinenone[obs EV-011]
5Edit pipelinePencil button that opens the pipeline editor (S-003)none[obs EV-011]
6FilterSaved filters and usersnone[obs EV-011]
7Quick filter bar"Add condition"none[obs EV-011]
8SortDirection arrow and "Sort by: Next activity" menu; "Show closed deals" link to its leftnone[obs EV-026]
9Stage headerStage name, weighted value total (balance icon), deal count; chevron shape between columnsnone[obs EV-010]
10Deal cardTitle, organization or person, owner avatar, value, rotting badgeC-001[obs EV-010]
11Activity status iconOne of four states; click opens a popoverC-002[obs EV-012]
-

View switcher (left of "+ Deal"): board, list, forecast and archive icons [obs EV-011].

-

Data shown

-
ElementEntity.fieldEvidence
Card titleE-001 Deal.title[obs EV-010]
Card second lineE-005 Organization.name (or the person's name)[obs EV-010]
Card valueE-001 Deal.value and currency, formatted R$ 1.234.567,89[obs EV-010]
Activity status iconearliest open E-002 Activity of the deal (due_date, due_time)[obs EV-010] [net EV-025]
Rotting badge "<1d"E-004 Stage.days_to_rotten against time in stage[obs EV-016]
Stage header totalΣ Deal.value × Stage.deal_probability ÷ 100[obs EV-010]
Deal countopen deals in the pipeline[obs EV-053]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyPipeline or stage with no dealsEmpty column with header "R$ 0"; "+" appears on column hover[obs EV-010]
LoadingOpen the boardToolbar first, cards after; the pipeline selector fills in last[obs EV-001]
TypicalSandbox pipeline with 11 dealsMixed icons and values[obs EV-010]
Many itemsnot reachednot tested (production volume seen only in counts)none
Long textTitle of 120 characters with emojiWraps to three lines; no truncation[obs EV-010]
Errornone seennot testednone
No permissionnonenot tested (needs a second user)none
Plan-gatednone on this screennonenone
RottingStage with rotting 0 daysPink card and red "<1d" badge[obs EV-016]
New dealSave the Add deal formCard at the top of the stage with a NEW badge until reload[obs EV-053]
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Hover a status iconTooltip: "View overdue activity", "View activity scheduled for today", "View upcoming activity" or "Schedule an activity"nonenone[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
Click a status iconPopover with open activities or "You have no activities scheduled for this deal"GET /api/v1/deals/:id/activitiesnone[obs EV-018] [obs EV-019] [net EV-025]
Click a done circle in the popoverActivity done; toast; maybe the next-activity modalPUT /api/v1/activities/:idaccount[obs EV-020] [obs EV-022] [net EV-025]
Drag a cardFour drop zones appear at the bottom: Delete, Lost, Won, Move tonone seen (drop not completed)none[obs EV-054]
Open the sort menu14 options, "Next activity (default)" checkednoneuser (not changed)[obs EV-026]
Click "+ Deal"Add deal formsee C-007none[obs EV-049]
Pipeline selector > New pipelinePipeline editor with defaultsnone until savecompany[obs EV-003]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
ShortcutsQuick add "+" with one-key shortcuts (C-007 for deals)[obs EV-055] [doc SRC-016]
Focus visiblenot testednone
EscapeCloses popovers and menus[obs EV-019]
Unlabeled controlsSeveral ghost buttons and the modal backdrops have no accessible name[obs EV-001]
-

Microcopy

-
ElementTextEvidence
Overdue icon tooltipView overdue activity[obs EV-012]
No-activity icon tooltipSchedule an activity[obs EV-013]
Future icon tooltipView upcoming activity[obs EV-014]
Today icon tooltipView activity scheduled for today[obs EV-015]
Rotting badge tooltipNo actions for <1 days[obs EV-016]
No-activity popoverYou have no activities scheduled for this deal / + Schedule an activity[obs EV-018]
Done toastActivity marked as done (subject)[obs EV-020]
Create toastNew deal "title" created · View[obs EV-053]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
Card titleE-001 Deal.title[obs EV-010]
Card second lineE-005 Organization.name (or the person's name)[obs EV-010]
Card valueE-001 Deal.value and currency, formatted R$ 1.234.567,89[obs EV-010]
Activity status iconearliest open E-002 Activity of the deal (due_date, due_time)[obs EV-010] [net EV-025]
Rotting badge "<1d"E-004 Stage.days_to_rotten against time in stage[obs EV-016]
Stage header totalΣ Deal.value × Stage.deal_probability ÷ 100[obs EV-010]
Deal countopen deals in the pipeline[obs EV-053]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Hover a status iconTooltip: "View overdue activity", "View activity scheduled for today", "View upcoming activity" or "Schedule an activity"nonenone[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
Click a status iconPopover with open activities or "You have no activities scheduled for this deal"GET /api/v1/deals/:id/activitiesnone[obs EV-018] [obs EV-019] [net EV-025]
Click a done circle in the popoverActivity done; toast; maybe the next-activity modalPUT /api/v1/activities/:idaccount[obs EV-020] [obs EV-022] [net EV-025]
Drag a cardFour drop zones appear at the bottom: Delete, Lost, Won, Move tonone seen (drop not completed)none[obs EV-054]
Open the sort menu14 options, "Next activity (default)" checkednoneuser (not changed)[obs EV-026]
Click "+ Deal"Add deal formsee C-007none[obs EV-049]
Pipeline selector > New pipelinePipeline editor with defaultsnone until savecompany[obs EV-003]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
ShortcutsQuick add "+" with one-key shortcuts (C-007 for deals)[obs EV-055] [doc SRC-016]
Focus visiblenot testednone
EscapeCloses popovers and menus[obs EV-019]
Unlabeled controlsSeveral ghost buttons and the modal backdrops have no accessible name[obs EV-001]
+

Microcopy

+
ElementTextEvidence
Overdue icon tooltipView overdue activity[obs EV-012]
No-activity icon tooltipSchedule an activity[obs EV-013]
Future icon tooltipView upcoming activity[obs EV-014]
Today icon tooltipView activity scheduled for today[obs EV-015]
Rotting badge tooltipNo actions for <1 days[obs EV-016]
No-activity popoverYou have no activities scheduled for this deal / + Schedule an activity[obs EV-018]
Done toastActivity marked as done (subject)[obs EV-020]
Create toastNew deal "title" created · View[obs EV-053]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)Status icon and order update in place after a popover action; the column order waits for a reload[obs EV-020] [obs EV-024]
Delays the user seesThe next-activity modal shows a skeleton for 2 to 3 seconds[obs EV-021]
-

Responsive

-
WidthChangeEvidence
1710 CSS pxFour columns fit without horizontal scroll[obs EV-010]
Other widthsnot tested (the user's own window was not resized)none
-

Not tested

-
  • Completing a drag (move, won, lost, delete): the automated drag showed the drop zones but did not drop.
  • Card customization, filters, "Show closed deals" and changing the sort: these persist for the user and were left alone.
  • List, forecast and archive views of the pipeline.
  • Realtime updates from another user (needs L1 with a second account).
  • Widths other than 1710 px.
-
S-002 Deal detail

Features: F-002, F-003, F-004, F-005, F-006, F-009 · URL: /deal/:id · Status: done

-

Purpose

-

Everything about one deal: its stage, its status, its contacts and fields on the left, and on the right the composer, the Focus block (what to do next) and the History timeline. Closing the deal (Won, Lost) and reopening happen here.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)Status icon and order update in place after a popover action; the column order waits for a reload[obs EV-020] [obs EV-024]
Delays the user seesThe next-activity modal shows a skeleton for 2 to 3 seconds[obs EV-021]
+

Responsive

+
WidthChangeEvidence
1710 CSS pxFour columns fit without horizontal scroll[obs EV-010]
Other widthsnot tested (the user's own window was not resized)none
+

Not tested

+
  • Completing a drag (move, won, lost, delete): the automated drag showed the drop zones but did not drop.
  • Card customization, filters, "Show closed deals" and changing the sort: these persist for the user and were left alone.
  • List, forecast and archive views of the pipeline.
  • Realtime updates from another user (needs L1 with a second account).
  • Widths other than 1710 px.
+
S-002

Deal detail

FeaturesF-002, F-003, F-004, F-005, F-006, F-009URL/deal/:idStatusdone

Everything about one deal: its stage, its status, its contacts and fields on the left, and on the right the composer, the Focus block (what to do next) and the History timeline. Closing the deal (Won, Lost) and reopening happen here.

EV-027 Deal detail anatomy: header; stage bar; summary; composer tabs; Focus; History

Anatomy

  1. 1
    HeaderTitle; owner (avatar, name, "Owner"); followers ("1 follower" menu); Won split button; Lost; layout button; "..." menu
  2. 2
    Stage bar C-006One chevron per stage with "N days · stage name"; current and past stages green; future grey; "Create project"
  3. 3
    BreadcrumbPipeline > stage
  4. 4
    SummaryValue; Products; empty fields as links: "Set deal probability", "+ Person", "Add labels", "Set expected close date", "Add sequence", "+ Project"; organization link; expected close date when set
  5. 5
    DetailsTip banners, then custom fields; after closing: Won time or Lost time and Lost reason
  6. 6
    ComposerTabs: Activity, Notes, Meeting scheduler, Call, WhatsApp, Email, Files, Documents, Invoice; "Click here to add an activity..."
  7. 7
    Focus C-003Open activities (type icon, done circle, subject, relative date, owner, organization, "..." menu) and pinned notes; "Expand all items" toggle
  8. 8
    HistoryFilters: All, Activities (n), Notes (n), WhatsApp, Emails, Files, Documents, Invoices, Changelog; timeline of done activities, notes and changes

More from this screen 17 screenshots

EV-010 Sandbox board: four activity states; rotting card; weighted stage totals; default sort
EV-053 Deal created from the form: toast with View; card on top of its stage with a NEW badge
EV-044 Deal more-actions menu
EV-028 Stage bar tooltip of the current stage (time in stage)
EV-029 Stage bar tooltip of a stage the deal has not reached
EV-038 Mark as Lost dialog
Show 11 more
EV-035 Won state: WON badge; Reopen; light stage bar; open activity still in Focus; Won time field
EV-042 Lost state: LOST badge; Reopen; light red stage bar; comment saved as a pinned note; activity still open
EV-057 Deal page Focus with a red OVERDUE badge on an activity due yesterday
EV-030 After saving the next activity from the modal: toast; Focus shows the new activity; History shows the done one
EV-058 Deal page Focus empty state after the last activity is done
EV-046 Deleted deal page: banner with permanent deletion date; DELETED badge; Restore; open activity still listed
EV-032 Stage moved by one click on the stage bar; Recommended first automation banner
EV-034 Won modal: celebration; deal card; close time; activities done; What's next choices
EV-037 Deal reopened: Won and Lost buttons back; stage bar dark
EV-045 Delete deal confirmation: lists notes; files; documents; invoices; not activities; 30-day restore
EV-048 Delete activity confirmation on a deleted deal

States

EmptyFocus: "No focus items yet. Scheduled activities, pinned notes, email drafts and scheduled emails will appear here." and "+ Schedule an activity"
LoadingHeader and sidebar render before Focus
TypicalFocus shows it with a relative date
OverdueRed OVERDUE badge and red "Yesterday at 10:00"
WonWON badge, Reopen, light green stage bar, green "Create project", Won time in Details
LostLOST badge, Reopen, light red stage bar, Lost time and reason, comment as pinned note
DeletedYellow banner with the permanent deletion date; DELETED badge; Restore; grey stage bar; composer locked: "Can't add activities to a deleted deal. Restore the deal to add activities."
No permissionneeds a second user

Not reached: Plan-gated

Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Click a card title on the board [obs EV-010].
  • "View" in the toast after creating a deal [obs EV-053].
-

Anatomy

-

Anatomy

-
#RegionContentsComponentEvidence
1HeaderTitle; owner (avatar, name, "Owner"); followers ("1 follower" menu); Won split button; Lost; layout button; "..." menunone[obs EV-027] [obs EV-044]
2Stage barOne chevron per stage with "N days · stage name"; current and past stages green; future grey; "Create project"C-006[obs EV-027] [obs EV-028] [obs EV-029]
3BreadcrumbPipeline > stagenone[obs EV-027]
4SummaryValue; Products; empty fields as links: "Set deal probability", "+ Person", "Add labels", "Set expected close date", "Add sequence", "+ Project"; organization link; expected close date when setnone[obs EV-027] [obs EV-038]
5DetailsTip banners, then custom fields; after closing: Won time or Lost time and Lost reasonnone[obs EV-035] [obs EV-042]
6ComposerTabs: Activity, Notes, Meeting scheduler, Call, WhatsApp, Email, Files, Documents, Invoice; "Click here to add an activity..."none[obs EV-027]
7FocusOpen activities (type icon, done circle, subject, relative date, owner, organization, "..." menu) and pinned notes; "Expand all items" toggleC-003[obs EV-027] [obs EV-057]
8HistoryFilters: All, Activities (n), Notes (n), WhatsApp, Emails, Files, Documents, Invoices, Changelog; timeline of done activities, notes and changesnone[obs EV-030]
-

Data shown

-
ElementEntity.fieldEvidence
Stage barE-003 Pipeline stages; E-001 Deal.stage_id, stage_change_time[obs EV-028] [net EV-033]
ValueE-001 Deal.value, currency[obs EV-027]
Expected close dateE-001 Deal.expected_close_date, long date format 10 de outubro de 2026[obs EV-027]
Focus itemsopen E-002 Activity rows and pinned E-007 Note rows[obs EV-042]
Historydone activities, notes, status changes, "Deal created"[obs EV-030]
Won time, Lost time, Lost reasonE-001 Deal.won_time, lost_time, lost_reason[obs EV-035] [obs EV-042]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyDeal with no open activityFocus: "No focus items yet. Scheduled activities, pinned notes, email drafts and scheduled emails will appear here." and "+ Schedule an activity"[obs EV-058]
LoadingOpen the pageHeader and sidebar render before Focus[obs EV-027]
TypicalOpen deal with one activityFocus shows it with a relative date[obs EV-027]
OverdueOpen activity due yesterdayRed OVERDUE badge and red "Yesterday at 10:00"[obs EV-057]
WonClick WonWON badge, Reopen, light green stage bar, green "Create project", Won time in Details[obs EV-035]
LostMark as lostLOST badge, Reopen, light red stage bar, Lost time and reason, comment as pinned note[obs EV-042]
DeletedDelete the dealYellow banner with the permanent deletion date; DELETED badge; Restore; grey stage bar; composer locked: "Can't add activities to a deleted deal. Restore the deal to add activities."[obs EV-046]
No permissionnot testedneeds a second usernone
Plan-gatednone seennonenone
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Click a later stage in the stage barDeal moves at once; "Recommended first automation" banner may appearGET .../missingRequiredFields, PUT /api/v1/deals/:idcompany[obs EV-032] [net EV-033]
Hover a stage"Stage · Been here for N minutes" or "This deal has not been in this stage yet"nonenone[obs EV-028] [obs EV-029]
Click the done circle in FocusActivity done; prompt if it was the last open onePUT /api/v1/activities/:idcompany[obs EV-030] [net EV-031]
Click WonStatus won; celebration modal after about 4 secondsPUT /api/v1/deals/:idcompany[obs EV-034] [obs EV-035]
Click LostMark as Lost dialogsee C-005company[obs EV-038]
Click ReopenStatus open again, at oncePUT /api/v1/deals/:id with statuscompany[obs EV-037] [net EV-063]
"..." menuDuplicate, Merge, Export as XLSX, Convert to a lead, Report inaccurate details, Archive (NEW), Delete, Manage sidebar sectionsnonenone[obs EV-044]
"..." > DeleteConfirmation, then the deleted stateDELETE /api/v1/deals/:idcompany, 30-day restore[obs EV-045] [net EV-047]
Focus item "..."Edit, Mark as done, Export as ICS, Deletenonenone[obs EV-048]
Followers menuThe followers (operator only), "Add a follower", "Stop following"nonenone[obs EV-027]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnone testednone
Focus visibleThe "..." button shows a focus ring after a click[obs EV-058]
EscapeCloses menus and the followers list[obs EV-044]
Unlabeled controlsItem menus are labeled "More actions"[net EV-025]
-

Microcopy

-
ElementTextEvidence
Focus empty stateNo focus items yet. Scheduled activities, pinned notes, email drafts and scheduled emails will appear here.[obs EV-058]
Current stage tooltipBeen here for 10 minutes[obs EV-028]
Future stage tooltipThis deal has not been in this stage yet[obs EV-029]
Automation bannerRecommended first automation · Automatically add an activity when deals reach this stage[obs EV-032]
Deleted bannerYour deal will be deleted permanently after (date). If needed, export the data before that.[obs EV-046]
Locked composerCan't add activities to a deleted deal. Restore the deal to add activities.[obs EV-046]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
Stage barE-003 Pipeline stages; E-001 Deal.stage_id, stage_change_time[obs EV-028] [net EV-033]
ValueE-001 Deal.value, currency[obs EV-027]
Expected close dateE-001 Deal.expected_close_date, long date format 10 de outubro de 2026[obs EV-027]
Focus itemsopen E-002 Activity rows and pinned E-007 Note rows[obs EV-042]
Historydone activities, notes, status changes, "Deal created"[obs EV-030]
Won time, Lost time, Lost reasonE-001 Deal.won_time, lost_time, lost_reason[obs EV-035] [obs EV-042]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Click a later stage in the stage barDeal moves at once; "Recommended first automation" banner may appearGET .../missingRequiredFields, PUT /api/v1/deals/:idcompany[obs EV-032] [net EV-033]
Hover a stage"Stage · Been here for N minutes" or "This deal has not been in this stage yet"nonenone[obs EV-028] [obs EV-029]
Click the done circle in FocusActivity done; prompt if it was the last open onePUT /api/v1/activities/:idcompany[obs EV-030] [net EV-031]
Click WonStatus won; celebration modal after about 4 secondsPUT /api/v1/deals/:idcompany[obs EV-034] [obs EV-035]
Click LostMark as Lost dialogsee C-005company[obs EV-038]
Click ReopenStatus open again, at oncePUT /api/v1/deals/:id with statuscompany[obs EV-037] [net EV-063]
"..." menuDuplicate, Merge, Export as XLSX, Convert to a lead, Report inaccurate details, Archive (NEW), Delete, Manage sidebar sectionsnonenone[obs EV-044]
"..." > DeleteConfirmation, then the deleted stateDELETE /api/v1/deals/:idcompany, 30-day restore[obs EV-045] [net EV-047]
Focus item "..."Edit, Mark as done, Export as ICS, Deletenonenone[obs EV-048]
Followers menuThe followers (operator only), "Add a follower", "Stop following"nonenone[obs EV-027]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnone testednone
Focus visibleThe "..." button shows a focus ring after a click[obs EV-058]
EscapeCloses menus and the followers list[obs EV-044]
Unlabeled controlsItem menus are labeled "More actions"[net EV-025]
+

Microcopy

+
ElementTextEvidence
Focus empty stateNo focus items yet. Scheduled activities, pinned notes, email drafts and scheduled emails will appear here.[obs EV-058]
Current stage tooltipBeen here for 10 minutes[obs EV-028]
Future stage tooltipThis deal has not been in this stage yet[obs EV-029]
Automation bannerRecommended first automation · Automatically add an activity when deals reach this stage[obs EV-032]
Deleted bannerYour deal will be deleted permanently after (date). If needed, export the data before that.[obs EV-046]
Locked composerCan't add activities to a deleted deal. Restore the deal to add activities.[obs EV-046]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)Focus and History update in place after an action; the "Notes (n)" counter stayed at 1 after deleting the note until reload[obs EV-042]
Delays the user seesThe won modal appears about 4 seconds after the click, after two report calls[obs EV-034]
-

Responsive

-
WidthChangeEvidence
1710 CSS pxTwo columns (sidebar about one third)[obs EV-027]
Other widthsnot testednone
-

Not tested

-
  • Composer tabs other than Activity (notes would create records; email and WhatsApp reach people).
  • Changelog tab, products, labels, sequences, projects and the layout switcher.
  • Editing fields inline in Summary and Details.
  • Adding a follower or a person (reaches or involves real people).
  • Restore from the deleted state.
-
S-003 Pipeline editor

Features: F-008, F-009 · URL: /pipeline/:id/add (new), /pipeline/:id/edit (existing) · Status: done

-

Purpose

-

Create or change a pipeline in place, on top of the board: its name, whether deal-level probability is allowed, and per stage the name, the win probability and the rotting period. Deleting a pipeline or a stage starts here.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)Focus and History update in place after an action; the "Notes (n)" counter stayed at 1 after deleting the note until reload[obs EV-042]
Delays the user seesThe won modal appears about 4 seconds after the click, after two report calls[obs EV-034]
+

Responsive

+
WidthChangeEvidence
1710 CSS pxTwo columns (sidebar about one third)[obs EV-027]
Other widthsnot testednone
+

Not tested

+
  • Composer tabs other than Activity (notes would create records; email and WhatsApp reach people).
  • Changelog tab, products, labels, sequences, projects and the layout switcher.
  • Editing fields inline in Summary and Details.
  • Adding a follower or a person (reaches or involves real people).
  • Restore from the deleted state.
+
S-003

Pipeline editor

FeaturesF-008, F-009URL/pipeline/:id/add (new), /pipeline/:id/edit (existing)Statusdone

Create or change a pipeline in place, on top of the board: its name, whether deal-level probability is allowed, and per stage the name, the win probability and the rotting period. Deleting a pipeline or a stage starts here.

EV-008 Sandbox pipeline editor filled: 4 stages; probabilities 10/25/50/80; rotting 0 days on stage 2

Anatomy

  1. 1
    Top bar"Pipeline name" input; "Deal probability" toggle with info tooltip; Cancel; Save changes; "..." menu (Duplicate pipeline, Delete pipeline) on an existing pipeline
  2. 2
    Stage columnHeader with name, probability and rotting summary ("25% · 0 days"); drag handle; Name; Probability with tooltip; "Rotting in (days)" toggle and number; "Delete Stage" at the bottom
  3. 3
    Insert buttons"+" between columns to add a stage there
  4. 4
    Add new stageRight panel: "Pipeline stages represent the steps in your sales process" and "+ New stage"

More from this screen 8 screenshots

EV-003 New pipeline editor with its 5 default stages (100% each) and the Deal probability toggle on
EV-011 Board anatomy with numbered regions (annotate.js)
EV-004 Tooltip of the pipeline-level Deal probability toggle
EV-005 Tooltip of the stage Probability field
EV-006 Tooltip of the stage Rotting toggle
EV-007 Confirmation dialog when deleting an empty stage in the editor
Show 2 more
EV-060 Delete pipeline dialog with the default Move deals option
EV-061 Delete pipeline dialog with Delete deals selected and its warning

States

EmptyName "New pipeline"; five stages Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started, each 100%, rotting off; deal probability on
TypicalFour stages 10/25/50/80%, rotting 0 days on one

Not reached: Loading, Many items, Long text, Error, No permission, Plan-gated

Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Pipeline selector > "+ New pipeline" opens a new pipeline with default stages [obs EV-003].
  • The pencil button on the board opens the current pipeline [obs EV-011].
-

Anatomy

-

Anatomy

-
#RegionContentsComponentEvidence
1Top bar"Pipeline name" input; "Deal probability" toggle with info tooltip; Cancel; Save changes; "..." menu (Duplicate pipeline, Delete pipeline) on an existing pipelinenone[obs EV-008] [obs EV-004]
2Stage columnHeader with name, probability and rotting summary ("25% · 0 days"); drag handle; Name; Probability with tooltip; "Rotting in (days)" toggle and number; "Delete Stage" at the bottomnone[obs EV-008] [obs EV-005] [obs EV-006]
3Insert buttons"+" between columns to add a stage therenone[obs EV-003]
4Add new stageRight panel: "Pipeline stages represent the steps in your sales process" and "+ New stage"none[obs EV-008]
-

Data shown

-
ElementEntity.fieldEvidence
Pipeline nameE-003 Pipeline.name[net EV-009]
Deal probability toggleE-003 Pipeline.is_deal_probability_enabled[net EV-009]
Stage name, probabilityE-004 Stage.name, deal_probability[net EV-009]
RottingE-004 Stage.is_deal_rot_enabled, days_to_rotten[net EV-009]
-

States

-
StateHow to reach itWhat it showsEvidence
EmptyNew pipelineName "New pipeline"; five stages Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started, each 100%, rotting off; deal probability on[obs EV-003]
Loadingnone seennonenone
TypicalFilled sandboxFour stages 10/25/50/80%, rotting 0 days on one[obs EV-008]
Many itemsnot testednonenone
Long textnot testednonenone
Errornot tested (empty name, probability over 100)nonenone
No permissionnot tested (only deal admins can edit pipelines per the docs)none[doc SRC-004]
Plan-gatednonenonenone
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Turn rotting onA number field appears with 0; header shows "🔔 0 days"none until savecompany[obs EV-008]
Delete Stage on an empty stageDialog "Delete (stage) stage · There are no deals in this stage right now." Cancel / Delete stagenone until savecompany[obs EV-007]
Save changes on a new pipelinePipeline created; the board returns to the pipeline viewed beforenot capturedcompany[inf] Q-004
"..." > Delete pipelineDialog asks what to do with the N deals; see C-008not capturedcompany[obs EV-060] [obs EV-061]
-

Keyboard and accessibility

-
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnonenone
Focus visibleInputs show a blue focus ring[obs EV-003]
Escapenot testednone
Unlabeled controlsnot checkednone
-

Microcopy

-
ElementTextEvidence
Deal probability tooltipWhen enabled in a chosen pipeline, you'll be able to configure individual Deal probability. This type of probability overrides stage probability...[obs EV-004]
Stage probability tooltipThis represents your confidence in winning a deal by the expected close date... The default probability for each stage is 100%...[obs EV-005]
Rotting tooltipRotting feature · Deal rotting alerts you to inactive deals by coloring them red. Set the rotting period here.[obs EV-006]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
Pipeline nameE-003 Pipeline.name[net EV-009]
Deal probability toggleE-003 Pipeline.is_deal_probability_enabled[net EV-009]
Stage name, probabilityE-004 Stage.name, deal_probability[net EV-009]
RottingE-004 Stage.is_deal_rot_enabled, days_to_rotten[net EV-009]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Turn rotting onA number field appears with 0; header shows "🔔 0 days"none until savecompany[obs EV-008]
Delete Stage on an empty stageDialog "Delete (stage) stage · There are no deals in this stage right now." Cancel / Delete stagenone until savecompany[obs EV-007]
Save changes on a new pipelinePipeline created; the board returns to the pipeline viewed beforenot capturedcompany[inf] Q-004
"..." > Delete pipelineDialog asks what to do with the N deals; see C-008not capturedcompany[obs EV-060] [obs EV-061]
+

Keyboard and accessibility

+
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnonenone
Focus visibleInputs show a blue focus ring[obs EV-003]
Escapenot testednone
Unlabeled controlsnot checkednone
+

Microcopy

+
ElementTextEvidence
Deal probability tooltipWhen enabled in a chosen pipeline, you'll be able to configure individual Deal probability. This type of probability overrides stage probability...[obs EV-004]
Stage probability tooltipThis represents your confidence in winning a deal by the expected close date... The default probability for each stage is 100%...[obs EV-005]
Rotting tooltipRotting feature · Deal rotting alerts you to inactive deals by coloring them red. Set the rotting period here.[obs EV-006]
+

Rules

-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)The editor replaces the board in place[obs EV-003]
Delays the user seesnone noticednone
-

Responsive

-
WidthChangeEvidence
1710 CSS pxFour stage columns and the add panel fit[obs EV-008]
-

Not tested

-
  • Reordering stages by drag, inserting a stage with "+", duplicating a pipeline.
  • Validation of empty names and out-of-range probabilities.
  • Deleting a stage that has deals (the docs say its deals are deleted).
  • Pipeline visibility settings (company configuration, A4).
-
S-004 Activities list

Features: F-010 · URL: /activities/list/user/:id · Status: draft

-

Purpose

-

A table of the user's activities across deals, filtered by period and type. Only the toolbar was studied: the rows are the team's real work.

-

Entry points

+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)The editor replaces the board in place[obs EV-003]
Delays the user seesnone noticednone
+

Responsive

+
WidthChangeEvidence
1710 CSS pxFour stage columns and the add panel fit[obs EV-008]
+

Not tested

+
  • Reordering stages by drag, inserting a stage with "+", duplicating a pipeline.
  • Validation of empty names and out-of-range probabilities.
  • Deleting a stage that has deals (the docs say its deals are deleted).
  • Pipeline visibility settings (company configuration, A4).
+
S-004

Activities list

FeaturesF-010URL/activities/list/user/:idStatusdraft

A table of the user's activities across deals, filtered by period and type. Only the toolbar was studied: the rows are the team's real work.

EV-056 Activities list toolbar: type filter; period tabs; count; columns (rows blurred)

Anatomy

  1. 1
    View switchList and calendar icons
  2. 2
    Create C-003"+ Activity" split button; "Meeting scheduler" menu
  3. 3
    CountRefresh icon, "N activities", info icon
  4. 4
    Owner filterFilter chip with the current user and a clear button
  5. 5
    Type filter"All" and one icon per active activity type
  6. 6
    Period tabsTo-do (selected by default), Overdue, Today, Tomorrow, This week, Next week, Select period
  7. 7
    TableColumns Done, Subject, Deal, Priority, Outcome, Contact person, Email, Phone; overdue subjects in red

More from this screen 1 screenshot

EV-010 Sandbox board: four activity states; rotting card; weighted stage totals; default sort

States

TypicalRows with overdue subjects in red

Not reached: Empty, Loading, Many items, Long text, Error, No permission, Plan-gated

Full screen notes entry points, data shown, interactions, keyboard and accessibility, microcopy, rules, realtime and performance, responsive, not tested

Entry points

  • Sidebar > Activities (the badge counts the user's overdue and due-today activities) [obs EV-010] [obs EV-056].
-

Anatomy

-

Toolbar

-
#RegionContentsComponentEvidence
1View switchList and calendar iconsnone[obs EV-056]
2Create"+ Activity" split button; "Meeting scheduler" menuC-003[obs EV-056]
3CountRefresh icon, "N activities", info iconnone[obs EV-056]
4Owner filterFilter chip with the current user and a clear buttonnone[obs EV-056]
5Type filter"All" and one icon per active activity typenone[obs EV-056]
6Period tabsTo-do (selected by default), Overdue, Today, Tomorrow, This week, Next week, Select periodnone[obs EV-056]
7TableColumns Done, Subject, Deal, Priority, Outcome, Contact person, Email, Phone; overdue subjects in rednone[obs EV-056]
-

Data shown

-
ElementEntity.fieldEvidence
RowsE-002 Activity with linked E-001 Deal and person[obs EV-056]
-

States

-
StateHow to reach itWhat it showsEvidence
Emptynot testednonenone
Loadingnot testednonenone
TypicalTo-do tabRows with overdue subjects in red[obs EV-056]
Many itemsnot testednonenone
Long textnot testednonenone
Errornot testednonenone
No permissionnot testednonenone
Plan-gatednonenonenone
-

Interactions

-
TriggerResultRequestPersistence scopeEvidence
Anynot tested (rows are production data)nonenonenone
-

Keyboard and accessibility

-
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnot testednone
Focus visiblenot testednone
Escapenot testednone
Unlabeled controlsnot testednone
-

Microcopy

-
ElementTextEvidence
Period tabsTo-do, Overdue, Today, Tomorrow, This week, Next week, Select period[obs EV-056]
-

Rules

+

Data shown

+
ElementEntity.fieldEvidence
RowsE-002 Activity with linked E-001 Deal and person[obs EV-056]
+

Interactions

+
TriggerResultRequestPersistence scopeEvidence
Anynot tested (rows are production data)nonenonenone
+

Keyboard and accessibility

+
CheckResultEvidence
Tab ordernot testednone
Arrow keysnot testednone
Shortcutsnot testednone
Focus visiblenot testednone
Escapenot testednone
Unlabeled controlsnot testednone
+

Microcopy

+
ElementTextEvidence
Period tabsTo-do, Overdue, Today, Tomorrow, This week, Next week, Select period[obs EV-056]
+

Rules

  • R-047 (rules/activities.md)
-

Realtime and performance

-
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)not testednone
Delays the user seesnot testednone
-

Responsive

-
WidthChangeEvidence
anynot testednone
-

Not tested

-
  • Everything beyond the toolbar: rows show the team's real activities, so the study stayed on the sandbox deal pages.
  • Calendar view, bulk actions, inline done, column settings.
-

04

Components

The reusable pieces of the interface and their states.

C-001 Deal card

Product name: data-test=pipeline-deal-tile · Used in: S-001 · Status: done

-

Anatomy

-

Anatomy

-
#PartContentEvidence
1TitleDeal title, bold, wraps without truncation[obs EV-010]
2Second lineOrganization name (or person) in grey[obs EV-010]
3FooterOwner avatar, rotting badge when rotten, value in bold[obs EV-010] [obs EV-016]
4Status iconC-002 on the right edge, vertically centered[obs EV-010]
5NEW badgeBlue pill after the title of a deal just created in this session view[obs EV-053]
-

Variants

-
VariantDifferenceEvidence
RottingPale pink background, red "<1d" pill before the value[obs EV-016]
Just createdNEW badge; placed first in its stage until reload[obs EV-053]
Long titleThree lines; card grows[obs EV-010]
-

States

-
StateVisual changeEvidence
DefaultWhite card, 8 px radius, light shadow[obs EV-002]
Hovernot measurednone
Focusnot measurednone
Pressednot measurednone
Selectednot measurednone
Disablednonenone
Loadingnonenone
Errornonenone
DraggingDrop zones appear at the bottom of the board[obs EV-054]
-

Measurements and tokens

-
PropertyValueTokenEvidence
Card sizeabout 342 × 75 px at 1710 px viewport (one-line title)none[obs EV-011]
Radius8 px--pd-radius-m[obs EV-002]
Shadowrgba(42, 54, 71, 0.05) 0 1px 2px 0none[obs EV-002]
TitleInter 14/21 600none[obs EV-002]
Secondary textInter 12/18 450, rgb(101, 104, 111)--pd-color-text-secondary[obs EV-002]
-

Behavior

-
  • Clicking the title opens S-002. Clicking the status icon opens C-002's popover instead of the deal [obs EV-019].
  • Dragging starts the drop-zone mode (Delete, Lost, Won, Move to) [obs EV-054].
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
none recordedtitle textnot testednot tested[obs EV-001]
-

Not tested

-
  • Hover, focus and selected styles; keyboard access to cards.
  • Card customization (up to 7 extra fields per user and pipeline per the docs [doc SRC-003]).
-
C-002 Activity status icon and popover

Product name: data-test=activity-status-indicator-:id · Used in: S-001 · Status: done

-

Anatomy

-

Popover

-
#PartContentEvidence
1Icon24 px circle: red with "<" (overdue), green with ">" (today), grey with ">" (future), yellow triangle with "!" (no open activity)[obs EV-010]
2TooltipOne line per state (see microcopy in S-001)[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
3Popover listOne row per open activity: done circle, type icon, subject, relative due ("Today at 09:00", "Tomorrow", "Due in 5 days") and owner[obs EV-019]
4Popover footer"+ Schedule an activity"[obs EV-019]
5Empty popover"You have no activities scheduled for this deal" and "+ Schedule an activity"[obs EV-018]
-

Variants

-
VariantDifferenceEvidence
OverdueRed; the overdue row's date in red[obs EV-019]
TodayGreen; date in green[obs EV-015]
FutureGrey[obs EV-014]
NoneYellow warning triangle[obs EV-013]
-

States

-
StateVisual changeEvidence
DefaultIcon only[obs EV-010]
HoverGrey halo and a dark tooltip[obs EV-012]
Focusnot measurednone
PressedPopover opens below[obs EV-019]
SelectedRow turns blue after its circle is clicked, subject struck through, green check[obs EV-020]
Disablednonenone
Loadingnone seennone
Errornonenone
-

Measurements and tokens

-
PropertyValueTokenEvidence
Icon size24 × 24 pxnone[obs EV-011]
Redrgb(216, 60, 56)--pd-color-negative-default[obs EV-002]
Greenrgb(45, 134, 71)--pd-color-primary-default[obs EV-002]
Yellowrgb(209, 184, 0)--pd-non-semantic-color-lemon-yellow-108[obs EV-002]
-

Behavior

-
  • The state follows the deal's earliest open activity; an activity due today whose time has passed is overdue (R-002).
  • Marking a row done updates the icon in place; if it was the last open activity the next-activity modal opens (R-013, R-014).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
buttontooltip textEscape closes the popovernot tested[obs EV-019]
-

Not tested

-
  • Keyboard opening of the popover; screen reader names of the rows.
-
C-003 Activity form modal

Product name: data-test=add-activity-form · Used in: S-001, S-002, S-004 · Status: done

-

Anatomy

-

Anatomy

-
#PartContentEvidence
1Title"Schedule your next activity" (after the last open activity is done) or "Schedule an activity" (other entry points)[obs EV-022] [obs EV-036]
2SubjectLarge input; placeholder is the selected type's name[obs EV-022]
3Type row12 type icons and a menu with the rest; the first type is selected[obs EV-022] [obs EV-036]
4WhenStart date, start time, end time, end date; date format "16 de out de 2026"[obs EV-022]
5PriorityMenu[obs EV-022]
6More"Add Location, Video call e Description" (progressive disclosure)[obs EV-022]
7AvailabilityFree/Busy menu with info icon[obs EV-022]
8NoteYellow text area[obs EV-022]
9OwnerUser menu, current user preselected[obs EV-022]
10LinksDeal (prefilled), People, Organization (prefilled from the deal)[obs EV-022]
11Footer"...", "Mark as done" checkbox, Cancel, Save[obs EV-022]
12Day agendaRight column: weekday and date with arrows, all-day items, hourly timeline, red current-time line, the user's other activities[obs EV-022]
13Context boxAfter winning: "Follow up after winning a deal · Schedule a follow-up activity to increase your chances for a deal with this client in the future. · Activity settings"[obs EV-036]
-

Variants

-
VariantDifferenceEvidence
Next activityTitle "Schedule your next activity"; opened by the system[obs EV-022]
Won follow-upTitle "Schedule an activity" with the context box[obs EV-036]
-

States

-
StateVisual changeEvidence
DefaultForm filled with defaults, Free[obs EV-022]
Hovernot measurednone
FocusSubject focused with a blue ring[obs EV-022]
Pressednonenone
SelectedTime chosen: 15-minute list with the chosen slot checked; Free becomes Busy[obs EV-023]
Disablednonenone
LoadingSkeleton bars for 2 to 3 seconds[obs EV-021]
Errornot testednone
-

Measurements and tokens

-
PropertyValueTokenEvidence
Modal widthabout 850 CSS px (form about 550, agenda about 300)none[net EV-025]
Note backgroundpale yellownot measured[obs EV-022]
-

Behavior

-
  • Defaults: type = first active type in company order; date today; no time; Free; owner = current user; deal and organization from context (R-016).
  • Clicking the start time fills the next 15-minute slot after now and switches to Busy; the agenda scrolls to the new block (R-017).
  • Save creates the activity and shows "Activity added · View" (R-018). Cancel saves nothing.
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
dialogtitle textEscape closes the time listyes (subject)[obs EV-023]
-

Not tested

-
  • Location, video call, description, guests (guests would receive invites), recurrence, "Mark as done" in the form, the "..." menu.
  • Validation errors (for example an end time before the start time).
-
C-004 Won celebration modal

Product name: none recorded · Used in: S-002 · Status: done

-

Anatomy

-

Anatomy

-
#PartContentEvidence
1IllustrationAnimated medal and confetti on a purple band (do not copy the art)[obs EV-034]
2Deal cardTitle, organization, owner avatar, WON pill, value, stage progress line[obs EV-034]
3Stats"Close time 0 days"; "Activities done 0"[obs EV-034]
4Question"What's next for this won deal?"[obs EV-034]
5Choices"Schedule follow-up activity · Plan next touchpoint"; "Create a project · Plan the delivery of the deal"[obs EV-034]
6Footer"Don't show me this again" checkbox; Close; close icon[obs EV-034]
-

Variants

-
VariantDifferenceEvidence
Animation offnot tested (personal preference)none
-

States

-
StateVisual changeEvidence
DefaultShown about 4 seconds after Won, after two report calls[obs EV-034]
Hovernot measurednone
Focusnot measurednone
Pressednonenone
Selectednonenone
Disablednonenone
Loadingnone seennone
Errornonenone
-

Measurements and tokens

-
PropertyValueTokenEvidence
Widthabout 600 px at 1502 px screenshot widthnone[obs EV-034]
-

Behavior

-
  • "Schedule follow-up activity" opens C-003 with the won context box (R-024).
  • "Don't show me this again" changes a personal preference (A3; not clicked).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
dialognot recordednot testednot testednone
-

Not tested

-
  • "Create a project", "Don't show me this again", Escape and keyboard order.
-
C-005 Mark as lost dialog

Product name: none recorded · Used in: S-002 · Status: done

-

Anatomy

-

Anatomy

-
#PartContentEvidence
1Title"Mark as Lost" with close icon[obs EV-038]
2Lost reasonSelect "Select a reason"; opens a searchable list of company reasons[obs EV-038] [obs EV-040]
3Comments"Comments (optional)" text area[obs EV-038]
4Link"Manage lost reasons on company settings page."[obs EV-038]
5Tip"Providing a lost reason can help you better understand trends or circumstances when you need to look back on your deal history." (dismissible)[obs EV-038]
6FooterCancel; red "Mark as lost"[obs EV-038]
-

Variants

-
VariantDifferenceEvidence
Predefined reasonsSearchable select; free text is not accepted[obs EV-041]
-

States

-
StateVisual changeEvidence
DefaultEmpty reason[obs EV-038]
Hovernot measurednone
FocusSearch input focused when the list opens[obs EV-040]
Pressednonenone
SelectedReason shown in the select[obs EV-042]
Disablednonenone
Loadingnonenone
ErrorRed border on the select when submitting without a reason; no message; nothing sent[obs EV-039]
-

Measurements and tokens

-
PropertyValueTokenEvidence
Error borderred--pd-color-negative-default[obs EV-039] [obs EV-002]
-

Behavior

-
  • Submitting sends the reason and the status, then creates a note pinned to the deal from the comment (R-029).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
comboboxLost reasonEnter does nothing when the search matches nothingyes[obs EV-041]
-

Not tested

-
  • Keyboard selection of a reason; the dialog with no predefined reasons (free-form text, Q-003).
-
C-006 Stage bar

Product name: none recorded · Used in: S-002 · Status: done

-

Anatomy

-

Stage bar

-
#PartContentEvidence
1Chevron per stage"N days · stage name"; past and current stages dark green, future grey with the name only[obs EV-027]
2TooltipCurrent: "stage · Been here for N minutes"; future: "This deal has not been in this stage yet"[obs EV-028] [obs EV-029]
-

Variants

-
VariantDifferenceEvidence
WonAll chevrons light green[obs EV-035]
LostAll chevrons light red[obs EV-042]
DeletedAll chevrons grey[obs EV-046]
-

States

-
StateVisual changeEvidence
DefaultOpen deal colors[obs EV-027]
HoverTooltip[obs EV-028]
Focusnot measurednone
PressedDeal moves to the clicked stage at once[obs EV-032]
SelectedCurrent stage is the last green chevron[obs EV-027]
Disablednot tested on closed dealsnone
Loadingnonenone
Errornonenone
-

Measurements and tokens

-
PropertyValueTokenEvidence
Heightabout 20 pxnone[obs EV-027]
-

Behavior

-
  • Stages before the one the deal was created in show as passed with "0 days" (R-031).
  • A click moves the deal without confirmation, after a required-field pre-check (R-030).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
not recordednot recordednot testednot testednone
-

Not tested

-
  • Clicking a stage on a won or lost deal; moving back to an earlier stage; what the pre-check shows when a required field is missing.
-
C-007 Add deal modal

Product name: none recorded · Used in: S-001 · Status: done

-

Anatomy

-

Core fields

-
#PartContentEvidence
1Contact personAutocomplete with info icon; focused on open[obs EV-049]
2OrganizationAutocomplete with info icon[obs EV-049]
3TitleText[obs EV-049]
4ValueNumber and currency select (company currency preselected); "Add products"[obs EV-049]
5PipelineCurrent pipeline[obs EV-049]
6Pipeline stageSegmented chevrons, first stage selected[obs EV-049]
7Label, Probability (%), Expected close date (DD/MM/YYYY), Owner, Source channel, Source channel IDFields[obs EV-049]
8Custom fieldsCompany deal fields, then Visible to[obs EV-052]
9Right columnPERSON (phone, email and person fields) and ORGANIZATION (organization fields) for new contacts[obs EV-050]
10FooterImport; usage counter "used/limit" with info icon; Cancel; Save[obs EV-050]
-

Variants

-
VariantDifferenceEvidence
Unmatched organizationNEW badge in the field; option "Add 'text' as new organization"[obs EV-051]
-

States

-
StateVisual changeEvidence
DefaultEmpty, contact person focused[obs EV-049]
Hovernot measurednone
FocusBlue ring[obs EV-049]
Pressednonenone
SelectedExisting organization chosen: NEW badge disappears[obs EV-051]
DisabledSave dims while validation errors show[obs EV-050]
LoadingSpinner in the organization field while searching[obs EV-051]
Error"A person or organization is required" under both fields[obs EV-050]
-

Measurements and tokens

-
PropertyValueTokenEvidence
Error textred, 12 px--pd-color-negative-default[obs EV-050] [obs EV-002]
-

Behavior

-
  • Save sends POST /api/v1/deals with pipeline, stage, owner, title, organization and visibility, then refreshes the stage count (R-040).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
dialogAdd dealnot testedyes[obs EV-049]
-

Not tested

-
  • Creating a person from the right column; products; labels; import; custom field validation.
-
C-008 Delete confirmations

Product name: none recorded · Used in: S-002, S-003, S-005 · Status: done

-

Anatomy

-

Pipeline delete

-
#PartContentEvidence
1Deal"Are you sure you want to delete this deal? Any notes, files, documents and invoices linked to this deal will also be deleted." Info box: restore from Restore data within 30 days. Cancel / Delete deal[obs EV-045]
2Note"Are you sure you want to delete this note? This action cannot be undone." Cancel / Delete[obs EV-043]
3Activity"Are you sure you want to delete this event?" (a line about Restore data appeared on one occasion). Cancel / Delete[obs EV-048]
4Stage (editor)"Delete (stage) stage · There are no deals in this stage right now." Cancel / Delete stage[obs EV-007]
5Pipeline"Delete (pipeline) pipeline · Before deleting this pipeline, please specify the following: 1. What would you like to do with the N deals in this pipeline?" Radio: Move deals to another pipeline (default, with a pipeline and stage select) / Delete deals; Delete pipeline disabled until valid[obs EV-060]
6Pipeline, delete dealsWarning: deleting removes the deals; restorable within 30 days; "View deals" link[obs EV-061]
7Organization"Are you sure you want to delete (name)? All notes, files, documents and invoices on this contact organization are deleted as well. Other linked items may remain but without a linked organization." Restore within 30 days[obs EV-062]
-

Variants

-
VariantDifferenceEvidence
DestructiveRed primary button with a trash icon[obs EV-061]
-

States

-
StateVisual changeEvidence
DefaultCentered dialog over a dimmed page[obs EV-045]
Hovernot measurednone
Focusnot measurednone
Pressednonenone
SelectedRadio checked[obs EV-061]
Disabled"Delete pipeline" pale until a choice is valid[obs EV-060]
LoadingFade-in of about half a second[obs EV-060]
Errornonenone
-

Measurements and tokens

-
PropertyValueTokenEvidence
Danger buttonrgb(216, 60, 56)--pd-color-negative-default[obs EV-002]
-

Behavior

-
  • The deal dialog does not mention activities, and activities survive the deal (R-032).
-

Keyboard and accessibility

-
RoleAccessible nameKeysFocus visibleEvidence
dialogtitle textnot testednot testednone
-

Not tested

-
  • Escape and Enter on these dialogs; deleting a person.
-

05

User flows

Step by step journeys through the product.

FL-001 Complete an activity and schedule the next one

User goal: finish today's task and keep the deal moving · Features: F-003, F-004 · Status: done

-

Steps

-
#ScreenUser actionSystem responseEvidence
1S-001Click the green or red status icon on a cardPopover lists the open activities[obs EV-019]
2S-001Click the done circle of the only open activityToast "Activity marked as done (subject)"; modal skeleton[obs EV-021]
3S-001Wait"Schedule your next activity" with deal and organization linked, first type, today, Free, day agenda[obs EV-022]
4S-001Click the start timeNext 15-minute slot filled; Busy[obs EV-023]
5S-002Type a subject and Save"Activity added · View"; activity in Focus[obs EV-030]
-

Branches and errors

-
At stepConditionWhat happensEvidence
2The deal has other open activitiesNo modal; the icon shows the next one[obs EV-020]
3User clicks CancelNothing saved; card shows the yellow warning; Focus empty state[obs EV-024] [obs EV-058]
1Done from the deal page Focus blockSame modal[obs EV-030]
-

Diagram

-
flowchart LR
+

Realtime and performance

+
CheckResultEvidence
A change in a second tab appears without reloadnot testednone
Loading pattern (skeleton, spinner, optimistic update)not testednone
Delays the user seesnot testednone
+

Responsive

+
WidthChangeEvidence
anynot testednone
+

Not tested

+
  • Everything beyond the toolbar: rows show the team's real activities, so the study stayed on the sandbox deal pages.
  • Calendar view, bulk actions, inline done, column settings.
+

04Components

The reusable pieces of the interface. Solid pills are variants and states seen in the product; dashed ones were not observed. Hover a pill for detail.

EV-010 Sandbox board: four activity states; rotting card; weighted stage totals; default sort
C-001

Deal card

Product namedata-test=pipeline-deal-tileUsed inS-001Statusdone

Variants

RottingJust createdLong title

States 2 of 9 observed

DefaultHoverFocusPressedSelectedDisabledLoadingErrorDragging

Behavior

  • Clicking the title opens S-002. Clicking the status icon opens C-002's popover instead of the deal [obs EV-019].
  • Dragging starts the drop-zone mode (Delete, Lost, Won, Move to) [obs EV-054].
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1TitleDeal title, bold, wraps without truncation[obs EV-010]
2Second lineOrganization name (or person) in grey[obs EV-010]
3FooterOwner avatar, rotting badge when rotten, value in bold[obs EV-010] [obs EV-016]
4Status iconC-002 on the right edge, vertically centered[obs EV-010]
5NEW badgeBlue pill after the title of a deal just created in this session view[obs EV-053]
+

Variants

+
VariantDifferenceEvidence
RottingPale pink background, red "<1d" pill before the value[obs EV-016]
Just createdNEW badge; placed first in its stage until reload[obs EV-053]
Long titleThree lines; card grows[obs EV-010]
+

States

+
StateVisual changeEvidence
DefaultWhite card, 8 px radius, light shadow[obs EV-002]
Hovernot measurednone
Focusnot measurednone
Pressednot measurednone
Selectednot measurednone
Disablednonenone
Loadingnonenone
Errornonenone
DraggingDrop zones appear at the bottom of the board[obs EV-054]
+

Measurements and tokens

+
PropertyValueTokenEvidence
Card sizeabout 342 × 75 px at 1710 px viewport (one-line title)none[obs EV-011]
Radius8 px--pd-radius-m[obs EV-002]
Shadowrgba(42, 54, 71, 0.05) 0 1px 2px 0none[obs EV-002]
TitleInter 14/21 600none[obs EV-002]
Secondary textInter 12/18 450, rgb(101, 104, 111)--pd-color-text-secondary[obs EV-002]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
none recordedtitle textnot testednot tested[obs EV-001]
+

Not tested

+
  • Hover, focus and selected styles; keyboard access to cards.
  • Card customization (up to 7 extra fields per user and pipeline per the docs [doc SRC-003]).
+
EV-019 Popover of a deal with three open activities (relative dates; done circles)
C-002

Activity status icon and popover

Product namedata-test=activity-status-indicator-:idUsed inS-001Statusdone

Variants

OverdueTodayFutureNone

States 4 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • The state follows the deal's earliest open activity; an activity due today whose time has passed is overdue (R-002).
  • Marking a row done updates the icon in place; if it was the last open activity the next-activity modal opens (R-013, R-014).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Icon24 px circle: red with "<" (overdue), green with ">" (today), grey with ">" (future), yellow triangle with "!" (no open activity)[obs EV-010]
2TooltipOne line per state (see microcopy in S-001)[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
3Popover listOne row per open activity: done circle, type icon, subject, relative due ("Today at 09:00", "Tomorrow", "Due in 5 days") and owner[obs EV-019]
4Popover footer"+ Schedule an activity"[obs EV-019]
5Empty popover"You have no activities scheduled for this deal" and "+ Schedule an activity"[obs EV-018]
+

Variants

+
VariantDifferenceEvidence
OverdueRed; the overdue row's date in red[obs EV-019]
TodayGreen; date in green[obs EV-015]
FutureGrey[obs EV-014]
NoneYellow warning triangle[obs EV-013]
+

States

+
StateVisual changeEvidence
DefaultIcon only[obs EV-010]
HoverGrey halo and a dark tooltip[obs EV-012]
Focusnot measurednone
PressedPopover opens below[obs EV-019]
SelectedRow turns blue after its circle is clicked, subject struck through, green check[obs EV-020]
Disablednonenone
Loadingnone seennone
Errornonenone
+

Measurements and tokens

+
PropertyValueTokenEvidence
Icon size24 × 24 pxnone[obs EV-011]
Redrgb(216, 60, 56)--pd-color-negative-default[obs EV-002]
Greenrgb(45, 134, 71)--pd-color-primary-default[obs EV-002]
Yellowrgb(209, 184, 0)--pd-non-semantic-color-lemon-yellow-108[obs EV-002]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
buttontooltip textEscape closes the popovernot tested[obs EV-019]
+

Not tested

+
  • Keyboard opening of the popover; screen reader names of the rows.
+
EV-022 Schedule your next activity modal (form and day agenda)
C-003

Activity form modal

Product namedata-test=add-activity-formUsed inS-001, S-002, S-004Statusdone

Variants

Next activityWon follow-up

States 4 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Defaults: type = first active type in company order; date today; no time; Free; owner = current user; deal and organization from context (R-016).
  • Clicking the start time fills the next 15-minute slot after now and switches to Busy; the agenda scrolls to the new block (R-017).
  • Save creates the activity and shows "Activity added · View" (R-018). Cancel saves nothing.
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Title"Schedule your next activity" (after the last open activity is done) or "Schedule an activity" (other entry points)[obs EV-022] [obs EV-036]
2SubjectLarge input; placeholder is the selected type's name[obs EV-022]
3Type row12 type icons and a menu with the rest; the first type is selected[obs EV-022] [obs EV-036]
4WhenStart date, start time, end time, end date; date format "16 de out de 2026"[obs EV-022]
5PriorityMenu[obs EV-022]
6More"Add Location, Video call e Description" (progressive disclosure)[obs EV-022]
7AvailabilityFree/Busy menu with info icon[obs EV-022]
8NoteYellow text area[obs EV-022]
9OwnerUser menu, current user preselected[obs EV-022]
10LinksDeal (prefilled), People, Organization (prefilled from the deal)[obs EV-022]
11Footer"...", "Mark as done" checkbox, Cancel, Save[obs EV-022]
12Day agendaRight column: weekday and date with arrows, all-day items, hourly timeline, red current-time line, the user's other activities[obs EV-022]
13Context boxAfter winning: "Follow up after winning a deal · Schedule a follow-up activity to increase your chances for a deal with this client in the future. · Activity settings"[obs EV-036]
+

Variants

+
VariantDifferenceEvidence
Next activityTitle "Schedule your next activity"; opened by the system[obs EV-022]
Won follow-upTitle "Schedule an activity" with the context box[obs EV-036]
+

States

+
StateVisual changeEvidence
DefaultForm filled with defaults, Free[obs EV-022]
Hovernot measurednone
FocusSubject focused with a blue ring[obs EV-022]
Pressednonenone
SelectedTime chosen: 15-minute list with the chosen slot checked; Free becomes Busy[obs EV-023]
Disablednonenone
LoadingSkeleton bars for 2 to 3 seconds[obs EV-021]
Errornot testednone
+

Measurements and tokens

+
PropertyValueTokenEvidence
Modal widthabout 850 CSS px (form about 550, agenda about 300)none[net EV-025]
Note backgroundpale yellownot measured[obs EV-022]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
dialogtitle textEscape closes the time listyes (subject)[obs EV-023]
+

Not tested

+
  • Location, video call, description, guests (guests would receive invites), recurrence, "Mark as done" in the form, the "..." menu.
  • Validation errors (for example an end time before the start time).
+
EV-034 Won modal: celebration; deal card; close time; activities done; What's next choices
C-004

Won celebration modal

Product namenone recordedUsed inS-002Statusdone

Variants

Animation off

States 1 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • "Schedule follow-up activity" opens C-003 with the won context box (R-024).
  • "Don't show me this again" changes a personal preference (A3; not clicked).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1IllustrationAnimated medal and confetti on a purple band (do not copy the art)[obs EV-034]
2Deal cardTitle, organization, owner avatar, WON pill, value, stage progress line[obs EV-034]
3Stats"Close time 0 days"; "Activities done 0"[obs EV-034]
4Question"What's next for this won deal?"[obs EV-034]
5Choices"Schedule follow-up activity · Plan next touchpoint"; "Create a project · Plan the delivery of the deal"[obs EV-034]
6Footer"Don't show me this again" checkbox; Close; close icon[obs EV-034]
+

Variants

+
VariantDifferenceEvidence
Animation offnot tested (personal preference)none
+

States

+
StateVisual changeEvidence
DefaultShown about 4 seconds after Won, after two report calls[obs EV-034]
Hovernot measurednone
Focusnot measurednone
Pressednonenone
Selectednonenone
Disablednonenone
Loadingnone seennone
Errornonenone
+

Measurements and tokens

+
PropertyValueTokenEvidence
Widthabout 600 px at 1502 px screenshot widthnone[obs EV-034]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
dialognot recordednot testednot testednone
+

Not tested

+
  • "Create a project", "Don't show me this again", Escape and keyboard order.
+
EV-038 Mark as Lost dialog
C-005

Mark as lost dialog

Product namenone recordedUsed inS-002Statusdone

Variants

Predefined reasons

States 4 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Submitting sends the reason and the status, then creates a note pinned to the deal from the comment (R-029).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Title"Mark as Lost" with close icon[obs EV-038]
2Lost reasonSelect "Select a reason"; opens a searchable list of company reasons[obs EV-038] [obs EV-040]
3Comments"Comments (optional)" text area[obs EV-038]
4Link"Manage lost reasons on company settings page."[obs EV-038]
5Tip"Providing a lost reason can help you better understand trends or circumstances when you need to look back on your deal history." (dismissible)[obs EV-038]
6FooterCancel; red "Mark as lost"[obs EV-038]
+

Variants

+
VariantDifferenceEvidence
Predefined reasonsSearchable select; free text is not accepted[obs EV-041]
+

States

+
StateVisual changeEvidence
DefaultEmpty reason[obs EV-038]
Hovernot measurednone
FocusSearch input focused when the list opens[obs EV-040]
Pressednonenone
SelectedReason shown in the select[obs EV-042]
Disablednonenone
Loadingnonenone
ErrorRed border on the select when submitting without a reason; no message; nothing sent[obs EV-039]
+

Measurements and tokens

+
PropertyValueTokenEvidence
Error borderred--pd-color-negative-default[obs EV-039] [obs EV-002]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
comboboxLost reasonEnter does nothing when the search matches nothingyes[obs EV-041]
+

Not tested

+
  • Keyboard selection of a reason; the dialog with no predefined reasons (free-form text, Q-003).
+
EV-028 Stage bar tooltip of the current stage (time in stage)
C-006

Stage bar

Product namenone recordedUsed inS-002Statusdone

Variants

WonLostDeleted

States 4 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Stages before the one the deal was created in show as passed with "0 days" (R-031).
  • A click moves the deal without confirmation, after a required-field pre-check (R-030).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Chevron per stage"N days · stage name"; past and current stages dark green, future grey with the name only[obs EV-027]
2TooltipCurrent: "stage · Been here for N minutes"; future: "This deal has not been in this stage yet"[obs EV-028] [obs EV-029]
+

Variants

+
VariantDifferenceEvidence
WonAll chevrons light green[obs EV-035]
LostAll chevrons light red[obs EV-042]
DeletedAll chevrons grey[obs EV-046]
+

States

+
StateVisual changeEvidence
DefaultOpen deal colors[obs EV-027]
HoverTooltip[obs EV-028]
Focusnot measurednone
PressedDeal moves to the clicked stage at once[obs EV-032]
SelectedCurrent stage is the last green chevron[obs EV-027]
Disablednot tested on closed dealsnone
Loadingnonenone
Errornonenone
+

Measurements and tokens

+
PropertyValueTokenEvidence
Heightabout 20 pxnone[obs EV-027]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
not recordednot recordednot testednot testednone
+

Not tested

+
  • Clicking a stage on a won or lost deal; moving back to an earlier stage; what the pre-check shows when a required field is missing.
+
EV-049 Add deal form: core fields column (cropped)
C-007

Add deal modal

Product namenone recordedUsed inS-001Statusdone

Variants

Unmatched organization

States 6 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • Save sends POST /api/v1/deals with pipeline, stage, owner, title, organization and visibility, then refreshes the stage count (R-040).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Contact personAutocomplete with info icon; focused on open[obs EV-049]
2OrganizationAutocomplete with info icon[obs EV-049]
3TitleText[obs EV-049]
4ValueNumber and currency select (company currency preselected); "Add products"[obs EV-049]
5PipelineCurrent pipeline[obs EV-049]
6Pipeline stageSegmented chevrons, first stage selected[obs EV-049]
7Label, Probability (%), Expected close date (DD/MM/YYYY), Owner, Source channel, Source channel IDFields[obs EV-049]
8Custom fieldsCompany deal fields, then Visible to[obs EV-052]
9Right columnPERSON (phone, email and person fields) and ORGANIZATION (organization fields) for new contacts[obs EV-050]
10FooterImport; usage counter "used/limit" with info icon; Cancel; Save[obs EV-050]
+

Variants

+
VariantDifferenceEvidence
Unmatched organizationNEW badge in the field; option "Add 'text' as new organization"[obs EV-051]
+

States

+
StateVisual changeEvidence
DefaultEmpty, contact person focused[obs EV-049]
Hovernot measurednone
FocusBlue ring[obs EV-049]
Pressednonenone
SelectedExisting organization chosen: NEW badge disappears[obs EV-051]
DisabledSave dims while validation errors show[obs EV-050]
LoadingSpinner in the organization field while searching[obs EV-051]
Error"A person or organization is required" under both fields[obs EV-050]
+

Measurements and tokens

+
PropertyValueTokenEvidence
Error textred, 12 px--pd-color-negative-default[obs EV-050] [obs EV-002]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
dialogAdd dealnot testedyes[obs EV-049]
+

Not tested

+
  • Creating a person from the right column; products; labels; import; custom field validation.
+
EV-061 Delete pipeline dialog with Delete deals selected and its warning
C-008

Delete confirmations

Product namenone recordedUsed inS-002, S-003, S-005Statusdone

Variants

Destructive

States 4 of 8 observed

DefaultHoverFocusPressedSelectedDisabledLoadingError

Behavior

  • The deal dialog does not mention activities, and activities survive the deal (R-032).
Full component notes anatomy, variants, states, measurements and tokens, keyboard and accessibility, not tested

Anatomy

+

+
#PartContentEvidence
1Deal"Are you sure you want to delete this deal? Any notes, files, documents and invoices linked to this deal will also be deleted." Info box: restore from Restore data within 30 days. Cancel / Delete deal[obs EV-045]
2Note"Are you sure you want to delete this note? This action cannot be undone." Cancel / Delete[obs EV-043]
3Activity"Are you sure you want to delete this event?" (a line about Restore data appeared on one occasion). Cancel / Delete[obs EV-048]
4Stage (editor)"Delete (stage) stage · There are no deals in this stage right now." Cancel / Delete stage[obs EV-007]
5Pipeline"Delete (pipeline) pipeline · Before deleting this pipeline, please specify the following: 1. What would you like to do with the N deals in this pipeline?" Radio: Move deals to another pipeline (default, with a pipeline and stage select) / Delete deals; Delete pipeline disabled until valid[obs EV-060]
6Pipeline, delete dealsWarning: deleting removes the deals; restorable within 30 days; "View deals" link[obs EV-061]
7Organization"Are you sure you want to delete (name)? All notes, files, documents and invoices on this contact organization are deleted as well. Other linked items may remain but without a linked organization." Restore within 30 days[obs EV-062]
+

Variants

+
VariantDifferenceEvidence
DestructiveRed primary button with a trash icon[obs EV-061]
+

States

+
StateVisual changeEvidence
DefaultCentered dialog over a dimmed page[obs EV-045]
Hovernot measurednone
Focusnot measurednone
Pressednonenone
SelectedRadio checked[obs EV-061]
Disabled"Delete pipeline" pale until a choice is valid[obs EV-060]
LoadingFade-in of about half a second[obs EV-060]
Errornonenone
+

Measurements and tokens

+
PropertyValueTokenEvidence
Danger buttonrgb(216, 60, 56)--pd-color-negative-default[obs EV-002]
+

Keyboard and accessibility

+
RoleAccessible nameKeysFocus visibleEvidence
dialogtitle textnot testednot testednone
+

Not tested

+
  • Escape and Enter on these dialogs; deleting a person.
+

05User flows

Step by step journeys. Each step shows the screen, what the user does and what the product answers; branches follow the steps.

FL-001

Complete an activity and schedule the next one

User goalfinish today's task and keep the deal movingFeaturesF-003, F-004Statusdone

5 steps. On a wide screen, scroll the strip sideways to see them all.

  1. Click the green or red status icon on a cardPopover lists the open activitiesEV-019
  2. Click the done circle of the only open activityToast "Activity marked as done (subject)"; modal skeletonEV-021
  3. Wait"Schedule your next activity" with deal and organization linked, first type, today, Free, day agendaEV-022
  4. Click the start timeNext 15-minute slot filled; BusyEV-023
  5. Type a subject and Save"Activity added · View"; activity in FocusEV-030

Branches and errors

Step 2
The deal has other open activitiesNo modal; the icon shows the next one
Step 3
User clicks CancelNothing saved; card shows the yellow warning; Focus empty state
Step 1
Done from the deal page Focus blockSame modal
!
Not tested

From the Activities list or calendar; with a person linked (participants); with guests.

Diagram source mermaid
flowchart LR
     A[Open activity due] --> B[Mark done]
     B --> C{Other open activities?}
     C -- yes --> D[Icon shows next activity]
     C -- no --> E[Schedule your next activity]
     E -- Save --> F[New activity in Focus]
-    E -- Cancel --> G[Deal without next step: yellow warning]
-

Not tested

-
  • From the Activities list or calendar; with a person linked (participants); with guests.
-
FL-002 Win a deal

User goal: record a closed sale and plan the next touchpoint · Features: F-005 · Status: done

-

Steps

-
#ScreenUser actionSystem responseEvidence
1S-002Click WonStatus won: WON badge, Reopen, light green stage bar, Won time[obs EV-035]
2S-002Wait about 4 secondsCelebration modal with close time, activities done and "What's next for this won deal?"[obs EV-034]
3S-002Choose "Schedule follow-up activity""Schedule an activity" form with the won context box, today and the first type[obs EV-036]
4S-002Cancel or SaveBack to the won deal; open activities remain open[obs EV-035]
-

Branches and errors

-
At stepConditionWhat happensEvidence
2Choose "Create a project"not testednone
1Later, click ReopenDeal open again[obs EV-037]
-

Diagram

-
flowchart LR
+    E -- Cancel --> G[Deal without next step: yellow warning]
+
FL-002

Win a deal

User goalrecord a closed sale and plan the next touchpointFeaturesF-005Statusdone
  1. Click WonStatus won: WON badge, Reopen, light green stage bar, Won timeEV-035
  2. Wait about 4 secondsCelebration modal with close time, activities done and "What's next for this won deal?"EV-034
  3. Choose "Schedule follow-up activity""Schedule an activity" form with the won context box, today and the first typeEV-036
  4. Cancel or SaveBack to the won deal; open activities remain openEV-035

Branches and errors

Step 2
Choose "Create a project"not tested
Step 1
Later, click ReopenDeal open again
!
Not tested

Won from the board drop zone or the Won dropdown ("Mark as won and create a project" [doc SRC-013]).

Diagram source mermaid
flowchart LR
     A[Open deal] -->|Won| B[Won state]
     B --> C[Celebration modal]
     C -->|Follow-up| D[Activity form]
     C -->|Close| B
-    B -->|Reopen| A
-

Not tested

-
  • Won from the board drop zone or the Won dropdown ("Mark as won and create a project" [doc SRC-013]).
-
FL-003 Lose a deal

User goal: close a deal as lost and keep the reason · Features: F-006 · Status: done

-

Steps

-
#ScreenUser actionSystem responseEvidence
1S-002Click LostMark as Lost dialog[obs EV-038]
2S-002Click "Mark as lost" without a reasonRed border on the reason; nothing sent[obs EV-039]
3S-002Open the reason list and pick a reasonSearchable list of company reasons[obs EV-040]
4S-002Type a comment and confirmStatus lost with the reason; comment saved as a pinned note; LOST badge and Reopen[obs EV-042]
-

Branches and errors

-
At stepConditionWhat happensEvidence
3Typed text matches no reasonNo option to use it; Enter does nothing[obs EV-041]
-

Diagram

-
flowchart LR
+    B -->|Reopen| A
+
FL-003

Lose a deal

User goalclose a deal as lost and keep the reasonFeaturesF-006Statusdone
  1. Click LostMark as Lost dialogEV-038
  2. Click "Mark as lost" without a reasonRed border on the reason; nothing sentEV-039
  3. Open the reason list and pick a reasonSearchable list of company reasonsEV-040
  4. Type a comment and confirmStatus lost with the reason; comment saved as a pinned note; LOST badge and ReopenEV-042

Branches and errors

Step 3
Typed text matches no reasonNo option to use it; Enter does nothing
!
Not tested

Lost from the board drop zone; reopening a lost deal (tested on a won deal only).

Diagram source mermaid
flowchart LR
     A[Open deal] -->|Lost| B[Dialog]
     B -->|no reason| B
     B -->|reason + comment| C[Lost state + pinned note]
-    C -->|Reopen| A
-

Not tested

-
  • Lost from the board drop zone; reopening a lost deal (tested on a won deal only).
-
FL-004 Create a deal from the board

User goal: add a new opportunity to a stage · Features: F-007 · Status: done

-

Steps

-
#ScreenUser actionSystem responseEvidence
1S-001Click "+ Deal"Add deal form, contact person focused, current pipeline and first stage[obs EV-049]
2S-001Type a title and Save"A person or organization is required" on both fields[obs EV-050]
3S-001Type an organization nameSuggestions; NEW badge while unmatched[obs EV-051]
4S-001Pick the existing organization, set Visible to, SaveToast with View; card on top of the stage with NEW[obs EV-052] [obs EV-053]
-

Branches and errors

-
At stepConditionWhat happensEvidence
3User saves with unmatched textA new organization would be created[obs EV-051]
-

Diagram

-
flowchart LR
+    C -->|Reopen| A
+
FL-004

Create a deal from the board

User goaladd a new opportunity to a stageFeaturesF-007Statusdone
  1. Click "+ Deal"Add deal form, contact person focused, current pipeline and first stageEV-049
  2. Type a title and Save"A person or organization is required" on both fieldsEV-050
  3. Type an organization nameSuggestions; NEW badge while unmatchedEV-051
  4. Pick the existing organization, set Visible to, SaveToast with View; card on top of the stage with NEWEV-052 EV-053

Branches and errors

Step 3
User saves with unmatched textA new organization would be created
!
Not tested

Creating a person in the form; the "+" in a stage column; the quick add shortcut D.

Diagram source mermaid
flowchart LR
     A[+ Deal] --> B[Form]
     B -->|no person or org| B
-    B -->|valid| C[Deal created at top of stage]
-

Not tested

-
  • Creating a person in the form; the "+" in a stage column; the quick add shortcut D.
-

06

How it behaves

Business rules observed in the product, each with its evidence. They become the acceptance tests of the new product.

Rules: activities and the next-activity prompt

R-013 Completing an activity while others remain open does not prompt

-
  • Given a deal with three open activities
  • When the user marks one done from the card popover
  • Then the row is struck through with a green check, the toast "Activity marked as done (subject)" appears, no modal opens, and the card icon updates to the next open activity
  • Evidence: [obs EV-020] [net EV-025]
  • Feature: F-004 · Screen: S-001
-

R-014 Completing the last open activity prompts for the next one

-
  • Given a deal with exactly one open activity
  • When the user marks it done from the card popover or from the deal page Focus block
  • Then the modal "Schedule your next activity" opens, linked to the deal and its organization, after a short skeleton
  • Evidence: [obs EV-021] [obs EV-022] [obs EV-030] [net EV-025] [doc SRC-010]
  • Feature: F-004 · Screen: S-001, S-002
-
ProbeInputResultEvidence
From the card popoverDeal EModal opened[obs EV-022]
From deal page FocusDeal CModal opened; saved[obs EV-030]
With other open activitiesDeal FNo modal[obs EV-020]
-

R-015 Cancelling the prompt leaves the deal without a next step

-
  • Given the "Schedule your next activity" modal
  • When the user clicks Cancel
  • Then nothing is created, the card shows the yellow warning icon, and the deal page Focus shows "No focus items yet" with "+ Schedule an activity"
  • Evidence: [obs EV-024] [obs EV-058]
  • Feature: F-004 · Screen: S-001, S-002
-

R-016 The prompt defaults to the first activity type, today and no time

-
  • Given the prompt opens after completing a call
  • When it renders
  • Then the selected type is the first active type in the company's type order (not the type just completed), the subject placeholder is that type's name, the date is today, the time is empty, availability is Free, the owner is the current user, and the deal and organization are linked
  • Evidence: [obs EV-022] [net EV-031]
  • Feature: F-004 · Screen: S-001, S-002
-

R-017 Choosing a time fills the next 15-minute slot and switches to Busy

-
  • Given the activity form with no time
  • When the user clicks the start time at 13:19
  • Then 13:30 is filled, a list of 15-minute slots opens, Free becomes Busy, and the day agenda shows the new block at 13:30
  • Evidence: [obs EV-023]
  • Feature: F-003 · Screen: S-001
-

R-018 Saving the prompt creates the activity and confirms it

-
  • Given the prompt with a subject
  • When the user clicks Save
  • Then the activity is created, the toast "Activity added · View" appears, and the activity shows in Focus
  • Evidence: [obs EV-030] [net EV-031]
  • Feature: F-004 · Screen: S-002
-

R-019 API defaults for activities

-
  • Given an activity created through the API
  • When it has a due time
  • Then busy is true; without a time busy is false; participants is empty when no person is linked; due_time is stored in UTC
  • Evidence: [net EV-009]
  • Feature: F-003 · Screen: S-002
-

R-020 The deal page marks overdue activities

-
  • Given an open activity due yesterday
  • When the deal page opens
  • Then the Focus item shows a red OVERDUE badge and a red "Yesterday at 10:00"
  • Evidence: [obs EV-057]
  • Feature: F-003 · Screen: S-002
-

R-021 Done activities move from Focus to History

-
  • Given an activity in Focus
  • When it is marked done
  • Then it leaves Focus and appears in History with a green check, and the History filter shows "Activities (1)"
  • Evidence: [obs EV-030]
  • Feature: F-003 · Screen: S-002
-

R-047 The activities list opens on To-do with period tabs and a type filter

-
  • Given the Activities list
  • When it opens
  • Then the To-do tab is selected, the other tabs are Overdue, Today, Tomorrow, This week, Next week and Select period, a type filter row offers All plus one icon per type, and a count shows "N activities"
  • Evidence: [obs EV-056]
  • Feature: F-010 · Screen: S-004
-

Rules: pipeline board

R-001 Each card shows one of four activity states

-
  • Given an open deal on the board
  • When the board renders
  • Then the card icon is red with "<" if its earliest open activity is overdue, green with ">" if it is due today, grey with ">" if it is in the future, and a yellow warning triangle if the deal has no open activity
  • Evidence: [obs EV-010] [obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015] [doc SRC-002]
  • Feature: F-001 · Screen: S-001
-
ProbeInputResultEvidence
Activity due yesterday 10:00Deal BRed icon, "View overdue activity"[obs EV-012]
Activity due today, no timeDeal EGreen icon, "View activity scheduled for today"[obs EV-015]
Activity in 5 daysDeal DGrey icon, "View upcoming activity"[obs EV-014]
No activityDeals A, KYellow triangle, "Schedule an activity"[obs EV-013]
-

R-002 An activity due today whose time has passed counts as overdue

-
  • Given a deal whose only overdue candidate is an activity due today at 09:00, viewed at 13:15
  • When the board renders
  • Then the card icon is red and the popover shows "Today at 09:00" in red
  • Evidence: [obs EV-010] [obs EV-019]
  • Feature: F-001 · Screen: S-001
-

R-003 The default order is overdue, today, no activity, future

-
  • Given a stage whose deals are in different activity states and the sort "Next activity (default)"
  • When the board loads
  • Then the cards are ordered overdue first, then due today, then deals with no open activity, then deals whose next activity is in the future
  • Evidence: [obs EV-010] [obs EV-026] [doc SRC-002]
  • Feature: F-001 · Screen: S-001
-
ProbeInputResultEvidence
Lead in stageB overdue, A and K none, D futureB, K, A, D[obs EV-010]
Proposal stage after one changeC today, E none, F futureC, E, F[obs EV-026]
-

R-004 Within "today", an activity without a time comes before a timed one

-
  • Given two deals with activities due today, one without a time and one at 17:00
  • When the board loads
  • Then the deal whose activity has no time is listed first
  • Evidence: [obs EV-010]
  • Feature: F-001 · Screen: S-001
-

R-005 Ties are broken by the newest deal first

-
  • Given deals in the same activity state and due date
  • When the board loads
  • Then the most recently created deal comes first
  • Evidence: [obs EV-010] [obs EV-059]
  • Feature: F-001 · Screen: S-001
-
ProbeInputResultEvidence
Three future deals due the same dayH, I, J created in that orderJ, I, H[obs EV-010]
Five deals with no activityA, B, D, K, L created in that orderL, K, D, B, A[obs EV-059]
-

R-006 The board does not re-sort after an in-place change until reload

-
  • Given a card whose activity state changes from the popover, or a deal just created
  • When the change is saved
  • Then the card keeps its position (a new deal goes to the top with a NEW badge) until the page is reloaded
  • Evidence: [obs EV-024] [obs EV-053] [obs EV-026]
  • Feature: F-001 · Screen: S-001
-

R-007 The stage header shows the weighted value of its deals

-
  • Given deals with values in a stage with probability P and no deal-level probability
  • When the board renders
  • Then the header shows Σ value × P ÷ 100 and the number of deals
  • Evidence: [obs EV-010] [doc SRC-006]
  • Feature: F-001 · Screen: S-001
-
ProbeInputResultEvidence
10% stage1.000 + 30.000 + 0 + 1.234.567,89R$ 126.556,79 · 4 deals[obs EV-010]
25% stage3.000R$ 750 · 1 deal[obs EV-010]
50% stage8.000 + 2.000 + 5.000R$ 7.500 · 3 deals[obs EV-010]
80% stage100 + 20.000 + 50.000R$ 56.080 · 3 deals[obs EV-010]
-

R-008 A stage with rotting at 0 days marks deals rotten at once

-
  • Given a stage with rotting on and 0 days
  • When a deal enters it
  • Then the card turns pale pink and shows a red "<1d" badge whose tooltip reads "No actions for <1 days"
  • Evidence: [obs EV-010] [obs EV-016] [net EV-009]
  • Feature: F-001 · Screen: S-001
-

R-009 Closed and deleted deals leave the board

-
  • Given a pipeline with a lost deal and a deleted deal
  • When the board loads
  • Then neither card is shown and the deal count excludes them
  • Evidence: [obs EV-053] [doc SRC-001]
  • Feature: F-001 · Screen: S-001
-

R-010 The status icon opens the deal's activity list

-
  • Given a card
  • When the user clicks its status icon
  • Then a popover lists the open activities with relative dates and done circles, plus "+ Schedule an activity"; with no activity it reads "You have no activities scheduled for this deal"
  • Evidence: [obs EV-018] [obs EV-019] [net EV-025]
  • Feature: F-001 · Screen: S-001
-

R-011 Dragging a card shows four drop zones

-
  • Given the board
  • When the user starts dragging a card
  • Then four zones appear along the bottom: Delete, Lost, Won, Move to
  • Evidence: [obs EV-054] [doc SRC-001]
  • Feature: F-001 · Screen: S-001
-

R-012 The Activities badge counts the user's overdue and due-today activities

-
  • Given the user's open activities
  • When one is created, completed or becomes due
  • Then the navigation badge equals the number of the user's open activities that are overdue or due today
  • Evidence: [obs EV-010] [obs EV-020] [obs EV-024] [obs EV-030]
  • Feature: F-003 · Screen: S-001
-
ProbeInputResultEvidence
Created 1 overdue and 3 due-today activitiesbadge 25 before29[obs EV-010]
Completed one due today2928[obs EV-020]
Completed another due today2827[obs EV-024]
Completed a third due today and created a follow-up due today2727 (net zero)[obs EV-030]
-

Rules: creating deals and visibility

R-037 A deal needs a person or an organization in the form

-
  • Given the Add deal form with only a title
  • When the user clicks Save
  • Then both contact fields show "A person or organization is required" with red borders and Save dims
  • Evidence: [obs EV-050]
  • Feature: F-007 · Screen: S-001
-

R-038 Unmatched organization text creates a new organization

-
  • Given text typed in the Organization field
  • When it does not exactly match an existing organization
  • Then the field shows a NEW badge and the list offers "Add 'text' as new organization"; picking the existing match removes the badge
  • Evidence: [obs EV-051]
  • Feature: F-007 · Screen: S-001
-

R-039 New deal defaults

-
  • Given the Add deal form opened from a pipeline board
  • When it opens
  • Then the pipeline is the current one, the first stage is selected, the owner is the current user, the currency is the company currency, and Visible to is "Item owner's visibility group"
  • Evidence: [obs EV-049] [obs EV-052]
  • Feature: F-007 · Screen: S-001
-

R-040 A saved deal appears at the top of its stage

-
  • Given a valid Add deal form
  • When the user saves
  • Then the deal is created, the toast 'New deal "title" created · View' appears, the details view does not open, and the card shows at the top of its stage with a NEW badge until reload
  • Evidence: [obs EV-053] [net EV-063]
  • Feature: F-007 · Screen: S-001
-

R-048 Visibility levels of an item

-
  • Given the Visible to field
  • When it opens
  • Then it offers Item owner (owner, Deals admins, followers, parent visibility groups), Item owner's visibility group, Item owner's visibility group and sub-groups, and All users
  • Evidence: [obs EV-052] [net EV-009]
  • Feature: F-012 · Screen: S-001
-

Rules: stages, won, lost, reopen and deletion

R-022 Won is one click and needs no confirmation

-
  • Given an open deal on its detail page
  • When the user clicks Won
  • Then the deal becomes won at once: WON badge and Reopen replace the buttons, the stage bar turns light green, "Create project" turns green, and Won time appears in Details
  • Evidence: [obs EV-035]
  • Feature: F-005 · Screen: S-002
-

R-023 Winning shows a celebration with next steps

-
  • Given the personal preference for the celebration is on
  • When a deal is marked won on its detail page
  • Then about 4 seconds later a modal shows the deal card, "Close time" and "Activities done", and asks "What's next for this won deal?" with "Schedule follow-up activity" and "Create a project", plus "Don't show me this again"
  • Evidence: [obs EV-034]
  • Feature: F-005 · Screen: S-002
-

R-024 The won follow-up opens with today and the first type

-
  • Given the company setting for the won follow-up popup names a type and a delay
  • When the user chooses "Schedule follow-up activity"
  • Then the form "Schedule an activity" opens with a "Follow up after winning a deal" box, today's date and the first activity type selected; the configured type and delay are not applied (setting read during the preflight, Q-018)
  • Evidence: [obs EV-036]
  • Feature: F-005 · Screen: S-002
-

R-025 Open activities stay open when a deal is won or lost

-
  • Given a deal with one open activity
  • When the deal is marked won or lost
  • Then the activity remains open in Focus; nothing asks what to do with it
  • Evidence: [obs EV-035] [obs EV-042] [doc SRC-030]
  • Feature: F-005, F-006 · Screen: S-002
-

R-026 Reopen returns a closed deal to open

-
  • Given a won deal
  • When the user clicks Reopen
  • Then the deal is open again at once, the Won and Lost buttons return and Won time disappears
  • Evidence: [obs EV-037] [net EV-063]
  • Feature: F-005 · Screen: S-002
-

R-027 Losing a deal requires a reason

-
  • Given the Mark as Lost dialog with no reason selected
  • When the user clicks "Mark as lost"
  • Then the reason select gets a red border, no message is shown and no request is sent
  • Evidence: [obs EV-039]
  • Feature: F-006 · Screen: S-002
-

R-028 With predefined reasons, the reason must come from the list

-
  • Given the company has predefined lost reasons and the setting "Allow free-form reasons" on
  • When the user types text that matches no reason and presses Enter
  • Then the list stays empty, no option to use the text appears, and the reason remains unset
  • Evidence: [obs EV-040] [obs EV-041]
  • Feature: F-006 · Screen: S-002
-

R-029 The lost comment becomes a note pinned to the deal

-
  • Given a reason and a comment in the dialog
  • When the user marks the deal lost
  • Then the deal gets status lost with the reason, and a note with the comment is created and pinned: it shows in Focus (yellow) and History, and Details shows Lost time and Lost reason
  • Evidence: [obs EV-042] [net EV-063] [doc SRC-011]
  • Feature: F-006 · Screen: S-002
-

R-030 Clicking a stage moves the deal at once

-
  • Given an open deal
  • When the user clicks a later stage in the stage bar
  • Then the app checks the target stage's required fields, moves the deal without confirmation, and may show a "Recommended first automation" banner for that stage
  • Evidence: [obs EV-032] [net EV-033]
  • Feature: F-002 · Screen: S-002
-

R-031 The stage bar shows time per stage

-
  • Given a deal created directly in the third stage
  • When its page opens
  • Then the first three chevrons are green with "0 days", the current stage tooltip reads "Been here for N minutes", and a later stage reads "This deal has not been in this stage yet"
  • Evidence: [obs EV-027] [obs EV-028] [obs EV-029]
  • Feature: F-002 · Screen: S-002
-

R-032 Deleting a deal does not delete its activities

-
  • Given an open deal with one open activity
  • When the user deletes the deal from its "..." menu
  • Then the dialog mentions notes, files, documents and invoices but not activities; the deal page turns to a deleted state with Restore and a permanent deletion date 30 days later; the activity stays open and not deleted (the docs say it is deleted)
  • Evidence: [obs EV-045] [obs EV-046] [net EV-047] [doc SRC-014]
  • Feature: F-009 · Screen: S-002
-

R-033 Activities of a deleted deal can be deleted from its page

-
  • Given a deleted deal that still lists an open activity in Focus
  • When the user chooses Delete in the activity's menu and confirms
  • Then the activity is deleted (the API reports is_deleted true)
  • Evidence: [obs EV-048] [net EV-047]
  • Feature: F-009 · Screen: S-002
-

R-034 Deleting a note asks for confirmation and cannot be undone

-
  • Given a pinned note on a deal
  • When the user chooses Delete in its menu
  • Then the dialog says "This action cannot be undone"; after confirming, the note disappears from Focus and History
  • Evidence: [obs EV-043]
  • Feature: F-009 · Screen: S-002
-

R-035 Deleting a pipeline requires a decision about its deals

-
  • Given a pipeline with deals
  • When the user chooses Delete pipeline in the editor
  • Then the dialog asks what to do with the N deals: "Move deals to another pipeline" (default, needs a pipeline and stage) or "Delete deals" (warning: restorable within 30 days); the delete button stays disabled until the choice is complete
  • Evidence: [obs EV-060] [obs EV-061]
  • Feature: F-009 · Screen: S-003
-

R-036 Deleting an organization keeps other linked items

-
  • Given an organization
  • When the user deletes it
  • Then the dialog says its notes, files, documents and invoices are deleted, other linked items remain without the organization, and it can be restored within 30 days
  • Evidence: [obs EV-062]
  • Feature: F-009 · Screen: S-005
-

Rules: pipeline editor

R-041 A new pipeline starts with five default stages

-
  • Given the pipeline selector
  • When the user chooses New pipeline
  • Then the editor opens with the name "New pipeline", deal probability on, and five stages (Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started) at 100% with rotting off
  • Evidence: [obs EV-003]
  • Feature: F-008 · Screen: S-003
-

R-042 Rotting accepts zero days

-
  • Given a stage in the editor
  • When the user turns rotting on
  • Then the days field starts at 0, the header shows "0 days", and saving keeps 0
  • Evidence: [obs EV-008] [net EV-009]
  • Feature: F-008 · Screen: S-003
-

R-043 Deleting an empty stage asks for confirmation

-
  • Given a stage with no deals in the editor
  • When the user clicks Delete Stage
  • Then a dialog says "There are no deals in this stage right now" with Cancel and Delete stage
  • Evidence: [obs EV-007]
  • Feature: F-008 · Screen: S-003
-

R-046 Quick add offers one-key shortcuts

-
  • Given the "+" button in the top bar
  • When the user opens it
  • Then it lists Person P, Organization O, Activity A, Deal D, Lead L, Note N, Product R, Project E
  • Evidence: [obs EV-055] [doc SRC-016]
  • Feature: F-011 · Screen: S-001
-

07

Data model

The entities behind the screens: fields, types, relations and who may do what.

E-001 Deal

Product term: Deal · Parent: E-004 Stage (within E-003 Pipeline) · Status: draft

+ B -->|valid| C[Deal created at top of stage]
+

06How it behaves

Business rules observed in the product, each with its evidence. They become the acceptance tests of the new product.

Activities and the next-activity prompt 10 rules

R-013 Completing an activity while others remain open does not prompt

Given
a deal with three open activities
When
the user marks one done from the card popover
Then
the row is struck through with a green check, the toast "Activity marked as done (subject)" appears, no modal opens, and the card icon updates to the next open activity
Evidence: [obs EV-020] [net EV-025]Feature: F-004 · Screen: S-001

R-014 Completing the last open activity prompts for the next one

Given
a deal with exactly one open activity
When
the user marks it done from the card popover or from the deal page Focus block
Then
the modal "Schedule your next activity" opens, linked to the deal and its organization, after a short skeleton
Evidence: [obs EV-021] [obs EV-022] [obs EV-030] [net EV-025] [doc SRC-010]Feature: F-004 · Screen: S-001, S-002
ProbeInputResultEvidence
From the card popoverDeal EModal opened[obs EV-022]
From deal page FocusDeal CModal opened; saved[obs EV-030]
With other open activitiesDeal FNo modal[obs EV-020]

R-015 Cancelling the prompt leaves the deal without a next step

Given
the "Schedule your next activity" modal
When
the user clicks Cancel
Then
nothing is created, the card shows the yellow warning icon, and the deal page Focus shows "No focus items yet" with "+ Schedule an activity"
Evidence: [obs EV-024] [obs EV-058]Feature: F-004 · Screen: S-001, S-002

R-016 The prompt defaults to the first activity type, today and no time

Given
the prompt opens after completing a call
When
it renders
Then
the selected type is the first active type in the company's type order (not the type just completed), the subject placeholder is that type's name, the date is today, the time is empty, availability is Free, the owner is the current user, and the deal and organization are linked
Evidence: [obs EV-022] [net EV-031]Feature: F-004 · Screen: S-001, S-002

R-017 Choosing a time fills the next 15-minute slot and switches to Busy

Given
the activity form with no time
When
the user clicks the start time at 13:19
Then
13:30 is filled, a list of 15-minute slots opens, Free becomes Busy, and the day agenda shows the new block at 13:30
Evidence: [obs EV-023]Feature: F-003 · Screen: S-001

R-018 Saving the prompt creates the activity and confirms it

Given
the prompt with a subject
When
the user clicks Save
Then
the activity is created, the toast "Activity added · View" appears, and the activity shows in Focus
Evidence: [obs EV-030] [net EV-031]Feature: F-004 · Screen: S-002

R-019 API defaults for activities

Given
an activity created through the API
When
it has a due time
Then
busy is true; without a time busy is false; participants is empty when no person is linked; due_time is stored in UTC
Evidence: [net EV-009]Feature: F-003 · Screen: S-002

R-020 The deal page marks overdue activities

Given
an open activity due yesterday
When
the deal page opens
Then
the Focus item shows a red OVERDUE badge and a red "Yesterday at 10:00"
Evidence: [obs EV-057]Feature: F-003 · Screen: S-002

R-021 Done activities move from Focus to History

Given
an activity in Focus
When
it is marked done
Then
it leaves Focus and appears in History with a green check, and the History filter shows "Activities (1)"
Evidence: [obs EV-030]Feature: F-003 · Screen: S-002

R-047 The activities list opens on To-do with period tabs and a type filter

Given
the Activities list
When
it opens
Then
the To-do tab is selected, the other tabs are Overdue, Today, Tomorrow, This week, Next week and Select period, a type filter row offers All plus one icon per type, and a count shows "N activities"
Evidence: [obs EV-056]Feature: F-010 · Screen: S-004
+

Pipeline board 12 rules

R-001 Each card shows one of four activity states

Given
an open deal on the board
When
the board renders
Then
the card icon is red with "<" if its earliest open activity is overdue, green with ">" if it is due today, grey with ">" if it is in the future, and a yellow warning triangle if the deal has no open activity
Evidence: [obs EV-010] [obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015] [doc SRC-002]Feature: F-001 · Screen: S-001
ProbeInputResultEvidence
Activity due yesterday 10:00Deal BRed icon, "View overdue activity"[obs EV-012]
Activity due today, no timeDeal EGreen icon, "View activity scheduled for today"[obs EV-015]
Activity in 5 daysDeal DGrey icon, "View upcoming activity"[obs EV-014]
No activityDeals A, KYellow triangle, "Schedule an activity"[obs EV-013]

R-002 An activity due today whose time has passed counts as overdue

Given
a deal whose only overdue candidate is an activity due today at 09:00, viewed at 13:15
When
the board renders
Then
the card icon is red and the popover shows "Today at 09:00" in red
Evidence: [obs EV-010] [obs EV-019]Feature: F-001 · Screen: S-001

R-003 The default order is overdue, today, no activity, future

Given
a stage whose deals are in different activity states and the sort "Next activity (default)"
When
the board loads
Then
the cards are ordered overdue first, then due today, then deals with no open activity, then deals whose next activity is in the future
Evidence: [obs EV-010] [obs EV-026] [doc SRC-002]Feature: F-001 · Screen: S-001
ProbeInputResultEvidence
Lead in stageB overdue, A and K none, D futureB, K, A, D[obs EV-010]
Proposal stage after one changeC today, E none, F futureC, E, F[obs EV-026]

R-004 Within "today", an activity without a time comes before a timed one

Given
two deals with activities due today, one without a time and one at 17:00
When
the board loads
Then
the deal whose activity has no time is listed first
Evidence: [obs EV-010]Feature: F-001 · Screen: S-001

R-005 Ties are broken by the newest deal first

Given
deals in the same activity state and due date
When
the board loads
Then
the most recently created deal comes first
Evidence: [obs EV-010] [obs EV-059]Feature: F-001 · Screen: S-001
ProbeInputResultEvidence
Three future deals due the same dayH, I, J created in that orderJ, I, H[obs EV-010]
Five deals with no activityA, B, D, K, L created in that orderL, K, D, B, A[obs EV-059]

R-006 The board does not re-sort after an in-place change until reload

Given
a card whose activity state changes from the popover, or a deal just created
When
the change is saved
Then
the card keeps its position (a new deal goes to the top with a NEW badge) until the page is reloaded
Evidence: [obs EV-024] [obs EV-053] [obs EV-026]Feature: F-001 · Screen: S-001

R-007 The stage header shows the weighted value of its deals

Given
deals with values in a stage with probability P and no deal-level probability
When
the board renders
Then
the header shows Σ value × P ÷ 100 and the number of deals
Evidence: [obs EV-010] [doc SRC-006]Feature: F-001 · Screen: S-001
ProbeInputResultEvidence
10% stage1.000 + 30.000 + 0 + 1.234.567,89R$ 126.556,79 · 4 deals[obs EV-010]
25% stage3.000R$ 750 · 1 deal[obs EV-010]
50% stage8.000 + 2.000 + 5.000R$ 7.500 · 3 deals[obs EV-010]
80% stage100 + 20.000 + 50.000R$ 56.080 · 3 deals[obs EV-010]

R-008 A stage with rotting at 0 days marks deals rotten at once

Given
a stage with rotting on and 0 days
When
a deal enters it
Then
the card turns pale pink and shows a red "<1d" badge whose tooltip reads "No actions for <1 days"
Evidence: [obs EV-010] [obs EV-016] [net EV-009]Feature: F-001 · Screen: S-001

R-009 Closed and deleted deals leave the board

Given
a pipeline with a lost deal and a deleted deal
When
the board loads
Then
neither card is shown and the deal count excludes them
Evidence: [obs EV-053] [doc SRC-001]Feature: F-001 · Screen: S-001

R-010 The status icon opens the deal's activity list

Given
a card
When
the user clicks its status icon
Then
a popover lists the open activities with relative dates and done circles, plus "+ Schedule an activity"; with no activity it reads "You have no activities scheduled for this deal"
Evidence: [obs EV-018] [obs EV-019] [net EV-025]Feature: F-001 · Screen: S-001

R-011 Dragging a card shows four drop zones

Given
the board
When
the user starts dragging a card
Then
four zones appear along the bottom: Delete, Lost, Won, Move to
Evidence: [obs EV-054] [doc SRC-001]Feature: F-001 · Screen: S-001

R-012 The Activities badge counts the user's overdue and due-today activities

Given
the user's open activities
When
one is created, completed or becomes due
Then
the navigation badge equals the number of the user's open activities that are overdue or due today
Evidence: [obs EV-010] [obs EV-020] [obs EV-024] [obs EV-030]Feature: F-003 · Screen: S-001
ProbeInputResultEvidence
Created 1 overdue and 3 due-today activitiesbadge 25 before29[obs EV-010]
Completed one due today2928[obs EV-020]
Completed another due today2827[obs EV-024]
Completed a third due today and created a follow-up due today2727 (net zero)[obs EV-030]
+

Creating deals and visibility 5 rules

R-037 A deal needs a person or an organization in the form

Given
the Add deal form with only a title
When
the user clicks Save
Then
both contact fields show "A person or organization is required" with red borders and Save dims
Evidence: [obs EV-050]Feature: F-007 · Screen: S-001

R-038 Unmatched organization text creates a new organization

Given
text typed in the Organization field
When
it does not exactly match an existing organization
Then
the field shows a NEW badge and the list offers "Add 'text' as new organization"; picking the existing match removes the badge
Evidence: [obs EV-051]Feature: F-007 · Screen: S-001

R-039 New deal defaults

Given
the Add deal form opened from a pipeline board
When
it opens
Then
the pipeline is the current one, the first stage is selected, the owner is the current user, the currency is the company currency, and Visible to is "Item owner's visibility group"
Evidence: [obs EV-049] [obs EV-052]Feature: F-007 · Screen: S-001

R-040 A saved deal appears at the top of its stage

Given
a valid Add deal form
When
the user saves
Then
the deal is created, the toast 'New deal "title" created · View' appears, the details view does not open, and the card shows at the top of its stage with a NEW badge until reload
Evidence: [obs EV-053] [net EV-063]Feature: F-007 · Screen: S-001

R-048 Visibility levels of an item

Given
the Visible to field
When
it opens
Then
it offers Item owner (owner, Deals admins, followers, parent visibility groups), Item owner's visibility group, Item owner's visibility group and sub-groups, and All users
Evidence: [obs EV-052] [net EV-009]Feature: F-012 · Screen: S-001
+

Stages, won, lost, reopen and deletion 15 rules

R-022 Won is one click and needs no confirmation

Given
an open deal on its detail page
When
the user clicks Won
Then
the deal becomes won at once: WON badge and Reopen replace the buttons, the stage bar turns light green, "Create project" turns green, and Won time appears in Details
Evidence: [obs EV-035]Feature: F-005 · Screen: S-002

R-023 Winning shows a celebration with next steps

Given
the personal preference for the celebration is on
When
a deal is marked won on its detail page
Then
about 4 seconds later a modal shows the deal card, "Close time" and "Activities done", and asks "What's next for this won deal?" with "Schedule follow-up activity" and "Create a project", plus "Don't show me this again"
Evidence: [obs EV-034]Feature: F-005 · Screen: S-002

R-024 The won follow-up opens with today and the first type

Given
the company setting for the won follow-up popup names a type and a delay
When
the user chooses "Schedule follow-up activity"
Then
the form "Schedule an activity" opens with a "Follow up after winning a deal" box, today's date and the first activity type selected; the configured type and delay are not applied (setting read during the preflight, Q-018)
Evidence: [obs EV-036]Feature: F-005 · Screen: S-002

R-025 Open activities stay open when a deal is won or lost

Given
a deal with one open activity
When
the deal is marked won or lost
Then
the activity remains open in Focus; nothing asks what to do with it
Evidence: [obs EV-035] [obs EV-042] [doc SRC-030]Feature: F-005, F-006 · Screen: S-002

R-026 Reopen returns a closed deal to open

Given
a won deal
When
the user clicks Reopen
Then
the deal is open again at once, the Won and Lost buttons return and Won time disappears
Evidence: [obs EV-037] [net EV-063]Feature: F-005 · Screen: S-002

R-027 Losing a deal requires a reason

Given
the Mark as Lost dialog with no reason selected
When
the user clicks "Mark as lost"
Then
the reason select gets a red border, no message is shown and no request is sent
Evidence: [obs EV-039]Feature: F-006 · Screen: S-002

R-028 With predefined reasons, the reason must come from the list

Given
the company has predefined lost reasons and the setting "Allow free-form reasons" on
When
the user types text that matches no reason and presses Enter
Then
the list stays empty, no option to use the text appears, and the reason remains unset
Evidence: [obs EV-040] [obs EV-041]Feature: F-006 · Screen: S-002

R-029 The lost comment becomes a note pinned to the deal

Given
a reason and a comment in the dialog
When
the user marks the deal lost
Then
the deal gets status lost with the reason, and a note with the comment is created and pinned: it shows in Focus (yellow) and History, and Details shows Lost time and Lost reason
Evidence: [obs EV-042] [net EV-063] [doc SRC-011]Feature: F-006 · Screen: S-002

R-030 Clicking a stage moves the deal at once

Given
an open deal
When
the user clicks a later stage in the stage bar
Then
the app checks the target stage's required fields, moves the deal without confirmation, and may show a "Recommended first automation" banner for that stage
Evidence: [obs EV-032] [net EV-033]Feature: F-002 · Screen: S-002

R-031 The stage bar shows time per stage

Given
a deal created directly in the third stage
When
its page opens
Then
the first three chevrons are green with "0 days", the current stage tooltip reads "Been here for N minutes", and a later stage reads "This deal has not been in this stage yet"
Evidence: [obs EV-027] [obs EV-028] [obs EV-029]Feature: F-002 · Screen: S-002

R-032 Deleting a deal does not delete its activities

Given
an open deal with one open activity
When
the user deletes the deal from its "..." menu
Then
the dialog mentions notes, files, documents and invoices but not activities; the deal page turns to a deleted state with Restore and a permanent deletion date 30 days later; the activity stays open and not deleted (the docs say it is deleted)
Evidence: [obs EV-045] [obs EV-046] [net EV-047] [doc SRC-014]Feature: F-009 · Screen: S-002

R-033 Activities of a deleted deal can be deleted from its page

Given
a deleted deal that still lists an open activity in Focus
When
the user chooses Delete in the activity's menu and confirms
Then
the activity is deleted (the API reports is_deleted true)
Evidence: [obs EV-048] [net EV-047]Feature: F-009 · Screen: S-002

R-034 Deleting a note asks for confirmation and cannot be undone

Given
a pinned note on a deal
When
the user chooses Delete in its menu
Then
the dialog says "This action cannot be undone"; after confirming, the note disappears from Focus and History
Evidence: [obs EV-043]Feature: F-009 · Screen: S-002

R-035 Deleting a pipeline requires a decision about its deals

Given
a pipeline with deals
When
the user chooses Delete pipeline in the editor
Then
the dialog asks what to do with the N deals: "Move deals to another pipeline" (default, needs a pipeline and stage) or "Delete deals" (warning: restorable within 30 days); the delete button stays disabled until the choice is complete
Evidence: [obs EV-060] [obs EV-061]Feature: F-009 · Screen: S-003

R-036 Deleting an organization keeps other linked items

Given
an organization
When
the user deletes it
Then
the dialog says its notes, files, documents and invoices are deleted, other linked items remain without the organization, and it can be restored within 30 days
Evidence: [obs EV-062]Feature: F-009 · Screen: S-005
+

Pipeline editor 4 rules

R-041 A new pipeline starts with five default stages

Given
the pipeline selector
When
the user chooses New pipeline
Then
the editor opens with the name "New pipeline", deal probability on, and five stages (Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started) at 100% with rotting off
Evidence: [obs EV-003]Feature: F-008 · Screen: S-003

R-042 Rotting accepts zero days

Given
a stage in the editor
When
the user turns rotting on
Then
the days field starts at 0, the header shows "0 days", and saving keeps 0
Evidence: [obs EV-008] [net EV-009]Feature: F-008 · Screen: S-003

R-043 Deleting an empty stage asks for confirmation

Given
a stage with no deals in the editor
When
the user clicks Delete Stage
Then
a dialog says "There are no deals in this stage right now" with Cancel and Delete stage
Evidence: [obs EV-007]Feature: F-008 · Screen: S-003

R-046 Quick add offers one-key shortcuts

Given
the "+" button in the top bar
When
the user opens it
Then
it lists Person P, Organization O, Activity A, Deal D, Lead L, Note N, Product R, Project E
Evidence: [obs EV-055] [doc SRC-016]Feature: F-011 · Screen: S-001
+

07Data model

The entities behind the screens: fields, types, relations and who may do what.

E-001 Deal

Product term: Deal · Parent: E-004 Stage (within E-003 Pipeline) · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
titlestringyesfree text; 120+ characters and emoji accepted[net EV-009] [obs EV-010]
valuenumberno0shown as R$ 1.234.567,89[net EV-009] [obs EV-010]
currencystringyescompany currencyISO 4217[net EV-009] [obs EV-049]
pipeline_idintyescurrent pipeline in the form[net EV-009] [net EV-063]
stage_idintyesfirst stage of the pipeline[net EV-009] [obs EV-049]
statusenumsystemopenopen, won, lost (filters also accept deleted)[net EV-009] [doc SRC-019]
owner_idintyescurrent user[net EV-009] [obs EV-049]
creator_user_idintsystem[net EV-009]
person_idint or nullone of person or organization in the UI[net EV-009] [obs EV-050]
org_idint or nullone of person or organization in the UI[net EV-009] [obs EV-050]
probabilitynumber or nullnonull0-100, only when the pipeline allows deal probability[net EV-009] [doc SRC-006]
expected_close_datedate or nullno[net EV-009]
lost_reasonstring or nullwhen lost (UI)from the company list when predefined reasons exist[net EV-009] [obs EV-039]
visible_tointyes3 (owner's visibility group)1 item owner, 3 owner's group, 5 group and sub-groups, 7 all users[net EV-009] [obs EV-052]
label_idsint[]no[][net EV-009]
custom_fieldsobjectdepends on quality ruleskeyed by 40-hex field key[net EV-009]
origin, origin_id, channel, channel_idstring or nullsystemorigin "Marketplace" for API-created deals[net EV-009]
acv, arr, mrrnumber or nullno[net EV-009]
is_archived, archive_timebool, datetimesystemfalse[net EV-009]
is_deletedboolsystemfalsesoft delete, purged after 30 days[net EV-009] [obs EV-046]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
titlestringyesfree text; 120+ characters and emoji accepted[net EV-009] [obs EV-010]
valuenumberno0shown as R$ 1.234.567,89[net EV-009] [obs EV-010]
currencystringyescompany currencyISO 4217[net EV-009] [obs EV-049]
pipeline_idintyescurrent pipeline in the form[net EV-009] [net EV-063]
stage_idintyesfirst stage of the pipeline[net EV-009] [obs EV-049]
statusenumsystemopenopen, won, lost (filters also accept deleted)[net EV-009] [doc SRC-019]
owner_idintyescurrent user[net EV-009] [obs EV-049]
creator_user_idintsystem[net EV-009]
person_idint or nullone of person or organization in the UI[net EV-009] [obs EV-050]
org_idint or nullone of person or organization in the UI[net EV-009] [obs EV-050]
probabilitynumber or nullnonull0-100, only when the pipeline allows deal probability[net EV-009] [doc SRC-006]
expected_close_datedate or nullno[net EV-009]
lost_reasonstring or nullwhen lost (UI)from the company list when predefined reasons exist[net EV-009] [obs EV-039]
visible_tointyes3 (owner's visibility group)1 item owner, 3 owner's group, 5 group and sub-groups, 7 all users[net EV-009] [obs EV-052]
label_idsint[]no[][net EV-009]
custom_fieldsobjectdepends on quality ruleskeyed by 40-hex field key[net EV-009]
origin, origin_id, channel, channel_idstring or nullsystemorigin "Marketplace" for API-created deals[net EV-009]
acv, arr, mrrnumber or nullno[net EV-009]
is_archived, archive_timebool, datetimesystemfalse[net EV-009]
is_deletedboolsystemfalsesoft delete, purged after 30 days[net EV-009] [obs EV-046]

Relations

-
RelationTargetCardinalityOn deleteSource
in stageE-004 Stagemany to onepipeline deletion asks to move or delete the deals[obs EV-060]
ownerE-010 Usermany to onenot tested[net EV-009]
organizationE-005 Organizationmany to onedeleting the organization keeps the deal without it (dialog text)[obs EV-062]
personE-006 Personmany to onenot tested[doc SRC-017]
activitiesE-002 Activityone to manydeleting the deal leaves its activities open and not deleted[obs EV-046] [net EV-047]
notesE-007 Noteone to manythe dialog says notes are deleted with the deal[obs EV-045]
followersE-010 Usermany to manyowner follows by default[obs EV-027]
+
RelationTargetCardinalityOn deleteSource
in stageE-004 Stagemany to onepipeline deletion asks to move or delete the deals[obs EV-060]
ownerE-010 Usermany to onenot tested[net EV-009]
organizationE-005 Organizationmany to onedeleting the organization keeps the deal without it (dialog text)[obs EV-062]
personE-006 Personmany to onenot tested[doc SRC-017]
activitiesE-002 Activityone to manydeleting the deal leaves its activities open and not deleted[obs EV-046] [net EV-047]
notesE-007 Noteone to manythe dialog says notes are deleted with the deal[obs EV-045]
followersE-010 Usermany to manyowner follows by default[obs EV-027]

Lifecycle

stateDiagram-v2
     [*] --> open: create (form or API)
@@ -501,132 +454,132 @@ 

Lifecycle

deleted --> [*]: purged after 30 days

Evidence: won [obs EV-035], lost [obs EV-042], reopen [obs EV-037], deleted with restore and purge date [obs EV-046].

System fields

-
FieldSet whenSource
add_timecreation (UTC)[net EV-009]
update_timeany change[net EV-009]
stage_change_timestage move[net EV-009] [net EV-033]
won_time, lost_time, close_timestatus change[net EV-009] [obs EV-035] [obs EV-042]
local_won_date, local_lost_date, local_close_datestatus change, in the company time zone[net EV-009]
next_activity_id, next_activity_date, next_activity_time (v1)activity created, completed or deleted[net EV-025]
undone_activities_count, done_activities_count, activities_count (v1)activity changes[net EV-025]
first_won_time (v1)first win[net EV-025]
+
FieldSet whenSource
add_timecreation (UTC)[net EV-009]
update_timeany change[net EV-009]
stage_change_timestage move[net EV-009] [net EV-033]
won_time, lost_time, close_timestatus change[net EV-009] [obs EV-035] [obs EV-042]
local_won_date, local_lost_date, local_close_datestatus change, in the company time zone[net EV-009]
next_activity_id, next_activity_date, next_activity_time (v1)activity created, completed or deleted[net EV-025]
undone_activities_count, done_activities_count, activities_count (v1)activity changes[net EV-025]
first_won_time (v1)first win[net EV-025]

Rules

Not tested

  • Products, labels, sequences, projects, archive, merge, duplicate, convert to lead.
  • Deal-level probability values and their effect on weighted totals.
-
E-002 Activity

Product term: Activity · Parent: E-001 Deal (optional) · Status: draft

+
E-002 Activity

Product term: Activity · Parent: E-001 Deal (optional) · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
subjectstringno (placeholder is the type name)[net EV-009] [obs EV-022]
typestringyesfirst active type in company orderE-008 ActivityType.key_string[net EV-009] [net EV-031]
owner_idintyescurrent user[net EV-009] [obs EV-022]
creator_user_idintsystem[net EV-009]
deal_id, org_id, person_id, lead_id, project_idint or nullnofrom context[net EV-009]
due_datedateyestodayYYYY-MM-DD[net EV-009] [obs EV-022]
due_timetime or nullnonullHH:MM in UTC; the UI offers 15-minute slots[net EV-009] [obs EV-023]
durationtime or nullnonullHH:MM[net EV-009]
doneboolyesfalse[net EV-009]
busyboolyestrue with a time, false withoutFree/Busy in the UI[net EV-009] [obs EV-023]
marked_as_done_timedatetime or nullsystemnullset when done[net EV-009] [net EV-025]
participantsarray of {person_id, primary}no[]persons, not users[net EV-009]
attendeesarray or nullnonullguests; invites need calendar sync[net EV-025] [doc SRC-009]
priorityint or nullnonull[net EV-009] [obs EV-022]
outcomeint or nullnonullper type[net EV-009]
noteHTML or nullnonullyellow note area in the form[net EV-009] [obs EV-022]
public_descriptionstring or nullnonull[net EV-009]
locationobject or nullnonull[net EV-009]
conference_meeting_client, _url, _idstring or nullnonull[net EV-009]
privateboolnofalse[net EV-009]
is_deletedboolsystemfalse[net EV-009] [net EV-047]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
subjectstringno (placeholder is the type name)[net EV-009] [obs EV-022]
typestringyesfirst active type in company orderE-008 ActivityType.key_string[net EV-009] [net EV-031]
owner_idintyescurrent user[net EV-009] [obs EV-022]
creator_user_idintsystem[net EV-009]
deal_id, org_id, person_id, lead_id, project_idint or nullnofrom context[net EV-009]
due_datedateyestodayYYYY-MM-DD[net EV-009] [obs EV-022]
due_timetime or nullnonullHH:MM in UTC; the UI offers 15-minute slots[net EV-009] [obs EV-023]
durationtime or nullnonullHH:MM[net EV-009]
doneboolyesfalse[net EV-009]
busyboolyestrue with a time, false withoutFree/Busy in the UI[net EV-009] [obs EV-023]
marked_as_done_timedatetime or nullsystemnullset when done[net EV-009] [net EV-025]
participantsarray of {person_id, primary}no[]persons, not users[net EV-009]
attendeesarray or nullnonullguests; invites need calendar sync[net EV-025] [doc SRC-009]
priorityint or nullnonull[net EV-009] [obs EV-022]
outcomeint or nullnonullper type[net EV-009]
noteHTML or nullnonullyellow note area in the form[net EV-009] [obs EV-022]
public_descriptionstring or nullnonull[net EV-009]
locationobject or nullnonull[net EV-009]
conference_meeting_client, _url, _idstring or nullnonull[net EV-009]
privateboolnofalse[net EV-009]
is_deletedboolsystemfalse[net EV-009] [net EV-047]

Relations

-
RelationTargetCardinalityOn deleteSource
dealE-001 Dealmany to onesurvives the deal's deletion[net EV-047]
organizationE-005 Organizationmany to onenot tested[net EV-009]
typeE-008 ActivityTypemany to onenot tested[net EV-025]
ownerE-010 Usermany to onenot tested[net EV-009]
+
RelationTargetCardinalityOn deleteSource
dealE-001 Dealmany to onesurvives the deal's deletion[net EV-047]
organizationE-005 Organizationmany to onenot tested[net EV-009]
typeE-008 ActivityTypemany to onenot tested[net EV-025]
ownerE-010 Usermany to onenot tested[net EV-009]

Lifecycle

Open (done false) to done (done true, marked_as_done_time set) to deleted (is_deleted true). Reverting a done activity was not tested. Evidence: [obs EV-020] [net EV-025] [net EV-047].

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[net EV-009]
marked_as_done_timemarked done[net EV-025]
+
FieldSet whenSource
add_time, update_timecreation, change[net EV-009]
marked_as_done_timemarked done[net EV-025]

Rules

Not tested

  • Recurrence, guests and invites, location, video call links, outcomes, priorities.
-
E-003 Pipeline

Product term: Pipeline · Parent: none · Status: draft

+
E-003 Pipeline

Product term: Pipeline · Parent: none · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyes"New pipeline"emoji accepted[net EV-009] [obs EV-003]
is_deal_probability_enabledboolyestrue in a new pipeline[net EV-009] [obs EV-003]
order_nrintsystemlowest is the default pipeline[doc SRC-017]
is_deletedboolsystemfalse[doc SRC-017]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyes"New pipeline"emoji accepted[net EV-009] [obs EV-003]
is_deal_probability_enabledboolyestrue in a new pipeline[net EV-009] [obs EV-003]
order_nrintsystemlowest is the default pipeline[doc SRC-017]
is_deletedboolsystemfalse[doc SRC-017]

Relations

-
RelationTargetCardinalityOn deleteSource
stagesE-004 Stageone to many, ordereddeleted with the pipeline[net EV-009]
dealsE-001 Dealone to manymove to another pipeline or delete (required choice)[obs EV-060] [obs EV-061]
+
RelationTargetCardinalityOn deleteSource
stagesE-004 Stageone to many, ordereddeleted with the pipeline[net EV-009]
dealsE-001 Dealone to manymove to another pipeline or delete (required choice)[obs EV-060] [obs EV-061]

Lifecycle

Created in the editor, edited in place, deleted from the editor's menu. Evidence: [obs EV-003] [obs EV-060].

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]
+
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]

Rules

Not tested

  • Pipeline visibility per visibility group (company setting), duplicate pipeline, reordering.
-
E-004 Stage

Product term: Stage · Parent: E-003 Pipeline · Status: draft

+
E-004 Stage

Product term: Stage · Parent: E-003 Pipeline · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyesdefault names in a new pipeline[net EV-009] [obs EV-003]
deal_probabilityintyes1000-100[net EV-009] [obs EV-005]
is_deal_rot_enabledboolyesfalse[net EV-009]
days_to_rottenint or nullwhen rotting on00 accepted[net EV-009] [obs EV-008]
order_nrintsystemposition in the editor[doc SRC-017]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyesdefault names in a new pipeline[net EV-009] [obs EV-003]
deal_probabilityintyes1000-100[net EV-009] [obs EV-005]
is_deal_rot_enabledboolyesfalse[net EV-009]
days_to_rottenint or nullwhen rotting on00 accepted[net EV-009] [obs EV-008]
order_nrintsystemposition in the editor[doc SRC-017]

Relations

-
RelationTargetCardinalityOn deleteSource
pipelineE-003 Pipelinemany to one[net EV-009]
dealsE-001 Dealone to manyan empty stage asks for confirmation; the docs say deleting a stage deletes its deals[obs EV-007] [doc SRC-004]
+
RelationTargetCardinalityOn deleteSource
pipelineE-003 Pipelinemany to one[net EV-009]
dealsE-001 Dealone to manyan empty stage asks for confirmation; the docs say deleting a stage deletes its deals[obs EV-007] [doc SRC-004]

Lifecycle

Created, renamed and deleted in the pipeline editor. Evidence: [obs EV-008].

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]
+
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]

Rules

Not tested

  • Deleting a stage that holds deals.
-
E-005 Organization

Product term: Organization · Parent: none · Status: draft

+
E-005 Organization

Product term: Organization · Parent: none · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyes[net EV-009]
owner_idintyescurrent user[net EV-009]
visible_tointyesowner's visibility group1, 3, 5, 7[net EV-009]
addressobject or nullno[net EV-009]
website, linkedinurl or nullno[net EV-009]
industry, annual_revenue, employee_countint or nullno[net EV-009]
label_idsint[]no[][net EV-009]
custom_fieldsobjectno[net EV-009]
is_deletedboolsystemfalse30-day restore[net EV-009] [obs EV-062]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-009]
namestringyes[net EV-009]
owner_idintyescurrent user[net EV-009]
visible_tointyesowner's visibility group1, 3, 5, 7[net EV-009]
addressobject or nullno[net EV-009]
website, linkedinurl or nullno[net EV-009]
industry, annual_revenue, employee_countint or nullno[net EV-009]
label_idsint[]no[][net EV-009]
custom_fieldsobjectno[net EV-009]
is_deletedboolsystemfalse30-day restore[net EV-009] [obs EV-062]

Relations

-
RelationTargetCardinalityOn deleteSource
dealsE-001 Dealone to manydeals remain without the organization[obs EV-062]
personsE-006 Personone to manynot tested[doc SRC-017]
notes, files, documents, invoicesE-007 Note and othersone to manydeleted with the organization[obs EV-062]
+
RelationTargetCardinalityOn deleteSource
dealsE-001 Dealone to manydeals remain without the organization[obs EV-062]
personsE-006 Personone to manynot tested[doc SRC-017]
notes, files, documents, invoicesE-007 Note and othersone to manydeleted with the organization[obs EV-062]

Lifecycle

Created from the Add deal form (NEW badge) or the API; deleted from its page with a 30-day restore. Evidence: [obs EV-051] [obs EV-062].

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[net EV-009]
+
FieldSet whenSource
add_time, update_timecreation, change[net EV-009]

Rules

Not tested

  • Enrichment ("Enrich" buttons), merging duplicates, the organization page itself.
-
E-006 Person

Product term: Person (contact person) · Parent: E-005 Organization (optional) · Status: draft

+
E-006 Person

Product term: Person (contact person) · Parent: E-005 Organization (optional) · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[doc SRC-017]
name, first_name, last_namestringname[doc SRC-017]
emails, phonesarray of {value, primary, label}nolabels such as work, mobile[doc SRC-017] [obs EV-050]
org_id, owner_idintno, yescurrent user[doc SRC-017]
visible_to, label_idsint, int[]yes, no[doc SRC-017]
marketing_statusenumnono_consent, unsubscribed, subscribed, archived[doc SRC-017]
custom_fieldsobjectno[doc SRC-017]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[doc SRC-017]
name, first_name, last_namestringname[doc SRC-017]
emails, phonesarray of {value, primary, label}nolabels such as work, mobile[doc SRC-017] [obs EV-050]
org_id, owner_idintno, yescurrent user[doc SRC-017]
visible_to, label_idsint, int[]yes, no[doc SRC-017]
marketing_statusenumnono_consent, unsubscribed, subscribed, archived[doc SRC-017]
custom_fieldsobjectno[doc SRC-017]

Relations

-
RelationTargetCardinalityOn deleteSource
organizationE-005 Organizationmany to onenot tested[doc SRC-017]
dealsE-001 Dealone to manynot tested[doc SRC-017]
activity participationE-002 Activitymany to manynot tested[net EV-009]
+
RelationTargetCardinalityOn deleteSource
organizationE-005 Organizationmany to onenot tested[doc SRC-017]
dealsE-001 Dealone to manynot tested[doc SRC-017]
activity participationE-002 Activitymany to manynot tested[net EV-009]

Lifecycle

Not studied: the study created no persons (no real or fake contact data in production).

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]
+
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-017]

Rules

Not tested

  • Everything observable: persons were out of scope to avoid contact records in production.
-
E-007 Note

Product term: Note · Parent: E-001 Deal, E-005 Organization or E-006 Person · Status: draft

+
E-007 Note

Product term: Note · Parent: E-001 Deal, E-005 Organization or E-006 Person · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-063] [doc SRC-022]
contentHTML stringyessanitized[net EV-063] [doc SRC-022]
deal_id, org_id, person_id, lead_id, project_idint or nullat least one link[net EV-063] [doc SRC-022]
pinned_to_deal_flag (and _organization_, _person_, _lead_, _project_)boolnofalse; true for lost comments[net EV-063]
user_idintsystemcurrent user[doc SRC-018]
active_flagboolsystemtruefalse when deleted[doc SRC-018]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-063] [doc SRC-022]
contentHTML stringyessanitized[net EV-063] [doc SRC-022]
deal_id, org_id, person_id, lead_id, project_idint or nullat least one link[net EV-063] [doc SRC-022]
pinned_to_deal_flag (and _organization_, _person_, _lead_, _project_)boolnofalse; true for lost comments[net EV-063]
user_idintsystemcurrent user[doc SRC-018]
active_flagboolsystemtruefalse when deleted[doc SRC-018]

Relations

-
RelationTargetCardinalityOn deleteSource
dealE-001 Dealmany to onethe deal dialog says notes are deleted with the deal[obs EV-045]
+
RelationTargetCardinalityOn deleteSource
dealE-001 Dealmany to onethe deal dialog says notes are deleted with the deal[obs EV-045]

Lifecycle

Created from the Notes tab or as the lost comment; deleted with a confirmation that says it cannot be undone. Evidence: [obs EV-042] [obs EV-043].

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-018]
+
FieldSet whenSource
add_time, update_timecreation, change[doc SRC-018]

Rules

Not tested

  • Notes tab editor, comments on notes ("Add a comment"), unpinning.
-
E-008 Activity type

Product term: Activity type · Parent: none (company list) · Status: draft

+
E-008 Activity type

Product term: Activity type · Parent: none (company list) · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-025]
namestringyesshown as the subject placeholder[net EV-025] [obs EV-022]
key_stringstringsystemgenerated from the nameActivity.type[net EV-025] [doc SRC-021]
order_nrintyesthe first active type is the default for new activities[net EV-025] [obs EV-022]
icon_keystringyesone of about 40 icons (call, task, meeting, email...)[net EV-025] [doc SRC-021]
active_flagboolyestrueinactive types are hidden in the form[net EV-025]
is_custom_flagboolsystem[net EV-025]
colorstring or nullnonull[net EV-025]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-025]
namestringyesshown as the subject placeholder[net EV-025] [obs EV-022]
key_stringstringsystemgenerated from the nameActivity.type[net EV-025] [doc SRC-021]
order_nrintyesthe first active type is the default for new activities[net EV-025] [obs EV-022]
icon_keystringyesone of about 40 icons (call, task, meeting, email...)[net EV-025] [doc SRC-021]
active_flagboolyestrueinactive types are hidden in the form[net EV-025]
is_custom_flagboolsystem[net EV-025]
colorstring or nullnonull[net EV-025]

Relations

-
RelationTargetCardinalityOn deleteSource
activitiesE-002 Activityone to manydeactivated types stay on old activities (settings text)[doc SRC-008]
+
RelationTargetCardinalityOn deleteSource
activitiesE-002 Activityone to manydeactivated types stay on old activities (settings text)[doc SRC-008]

Lifecycle

Managed in Company settings > Activities (A4; read only in this study).

System fields

-
FieldSet whenSource
add_time, update_timecreation, change[net EV-025]
+
FieldSet whenSource
add_time, update_timecreation, change[net EV-025]

Rules

Not tested

  • Creating, reordering or deactivating types.
-
E-009 Lost reason

Product term: Lost reason · Parent: none (company list) · Status: draft

+
E-009 Lost reason

Product term: Lost reason · Parent: none (company list) · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
labelstringyesup to 100 predefined reasons per company[obs EV-040] [doc SRC-011]
allow free-form (company flag)boolno"Allow free-form reasons"[doc SRC-012]
+
FieldTypeRequiredDefaultConstraints or enumSource
labelstringyesup to 100 predefined reasons per company[obs EV-040] [doc SRC-011]
allow free-form (company flag)boolno"Allow free-form reasons"[doc SRC-012]

The deal stores the chosen text in Deal.lost_reason [net EV-063]. No public endpoint for the list was found [inf] Q-003.

Relations

-
RelationTargetCardinalityOn deleteSource
dealsE-001 Dealby textnot tested[net EV-063]
+
RelationTargetCardinalityOn deleteSource
dealsE-001 Dealby textnot tested[net EV-063]

Lifecycle

Managed in Company settings > Lost reasons (A4; read only).

System fields

-
FieldSet whenSource
none observed[obs EV-040]
+
FieldSet whenSource
none observed[obs EV-040]

Rules

Not tested

  • Editing the list; the dialog with no predefined reasons.
-
E-010 User

Product term: User (seat) · Parent: company · Status: draft

+
E-010 User

Product term: User (seat) · Parent: company · Status: draft

Fields

-
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-025]
name, emailstringyes[net EV-025]
locale, timezone_name, default_currencystringyesdrive date and number formats[net EV-025]
active_flag, is_deletedboolsystem[net EV-025]
is_adminnumbersystem[net EV-025]
accessarray of {app, admin, permission_set_id}systemapps such as sales, campaigns, projects[net EV-025]
is_youboolsystemmarks the current user ("(You)")[net EV-025]
+
FieldTypeRequiredDefaultConstraints or enumSource
idintsystem[net EV-025]
name, emailstringyes[net EV-025]
locale, timezone_name, default_currencystringyesdrive date and number formats[net EV-025]
active_flag, is_deletedboolsystem[net EV-025]
is_adminnumbersystem[net EV-025]
accessarray of {app, admin, permission_set_id}systemapps such as sales, campaigns, projects[net EV-025]
is_youboolsystemmarks the current user ("(You)")[net EV-025]

Relations

-
RelationTargetCardinalityOn deleteSource
owns deals, activities, organizationsE-001, E-002, E-005one to manynot tested[net EV-009]
follows dealsE-001 Dealmany to manynot tested[obs EV-027]
+
RelationTargetCardinalityOn deleteSource
owns deals, activities, organizationsE-001, E-002, E-005one to manynot tested[net EV-009]
follows dealsE-001 Dealmany to manynot tested[obs EV-027]

Lifecycle

Managed in Settings > Manage users (seats are billed; A5 to add).

System fields

-
FieldSet whenSource
created, modified, last_loginaccount events[net EV-025]
+
FieldSet whenSource
created, modified, last_loginaccount events[net EV-025]

Rules

Not tested

  • Roles, permission sets and visibility groups in practice (needs a second user).

Permissions

Observed with one user only (the operator, an admin). Everything else comes from the docs or the visibility options and needs a second account (L1) to confirm.

-
ActionItem ownerUsers in the owner's visibility groupDeals adminsFollowersEvidence
See a deal with visibility "Item owner"yesnoyesyes[obs EV-052]
See a deal with visibility "Item owner's visibility group"yesyesyesyes[obs EV-052]
See a deal with visibility "All users"yesyesyesyes[obs EV-052]
Edit pipelines and stagesadmins only per the docsnoyesno[doc SRC-004]
Delete dealswith a matching permissionnot testedyesnot tested[doc SRC-001]
Define lost reasonsnonoyesno[doc SRC-012]
-

TypeScript types

// Pipedrive data model as observed (E-001 to E-010). Field names follow the public API v2 where it exists.
+
ActionItem ownerUsers in the owner's visibility groupDeals adminsFollowersEvidence
See a deal with visibility "Item owner"yesnoyesyes[obs EV-052]
See a deal with visibility "Item owner's visibility group"yesyesyesyes[obs EV-052]
See a deal with visibility "All users"yesyesyesyes[obs EV-052]
Edit pipelines and stagesadmins only per the docsnoyesno[doc SRC-004]
Delete dealswith a matching permissionnot testedyesnot tested[doc SRC-001]
Define lost reasonsnonoyesno[doc SRC-012]
+
TypeScript types
// Pipedrive data model as observed (E-001 to E-010). Field names follow the public API v2 where it exists.
 // Evidence for each field is in data-model/entities/*.md.
 
 export type Visibility = 1 | 3 | 5 | 7; // item owner | owner's group | group and sub-groups | all users
@@ -767,8 +720,8 @@ 

TypeScript types

// Pipedrive data model as observ
 
 // Derived values the UI computes
 export type ActivityState = 'overdue' | 'today' | 'future' | 'none'; // R-001, R-002
-
-

Entity relationships (Mermaid)

erDiagram
+
+
Entity relationships mermaid
erDiagram
     PIPELINE ||--|{ STAGE : "has ordered"
     STAGE ||--o{ DEAL : "holds"
     USER ||--o{ DEAL : "owns"
@@ -785,39 +738,39 @@ 

Entity relationships (Mermaid)

erDiagram
     ORGANIZATION ||--o{ NOTE : "has"
     PERSON ||--o{ NOTE : "has"
     LOST_REASON ||--o{ DEAL : "explains (by text)"
-
-

08

API

What the web app asks its server for each action, with the shape of the data and no real values.

IDs in paths are :id. Shapes and types only; no real values. The web app calls the same host as the page (/api/v1/...) and passes a session_token query parameter on every call [net EV-025]; the public API (v1 and v2) is documented in SRC-017 and SRC-018. Deprecated v1 endpoints with v2 replacements are out of support since 2026-08-01 [doc SRC-026], so a compatible clone should model v2 and treat these web-app v1 calls as the UI's private contract.

-
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
GET/api/v1/deals/:id/activities?done&startCard status icon popovernone{data: Activity(v1)[]}[net EV-025]
PUT/api/v1/activities/:idDone circle (popover, Focus){done: boolean}{data: Activity(v1)} with marked_as_done_time[net EV-025]
GET/api/v1/activities/:idAfter marking donenone{data: Activity(v1)}[net EV-025]
POST/api/v1/activitiesSave in the activity form{subject, type, busy_flag, due_date, attendees[], assigned_to_user_id, done, deal_id, participants[], person_id, org_id}201, {data: Activity(v1)}[net EV-031]
DELETE/api/v1/activities/:idActivity menu > Deletenone200[obs EV-048] [net EV-047]
GET/api/v1/activities?start_date&end_date&user_id&limit&include_duration&include_private&include_recurringDay agenda in the activity formnone{data: Activity(v1)[]}[net EV-025]
GET/api/v1/scheduler/timeslots?start_date&end_date&is_activeDay agendanone{data: [], related_objects: {events: []}}[net EV-025]
GET/api/v1/activityTypesActivity formnone{data: ActivityType[]}[net EV-025]
GET/api/:id/fields/activity?activeOnlyActivity formnone{data: Field[]} with mandatory and visibility flags[net EV-025]
GET/api/v1/users?include_deleted_usersOwner pickernone{data: User[]}[net EV-025]
GET/api/v1/deals/:idPrefill links; reload a dealnone{data: Deal(v1)} with next_activity_* and counts[net EV-025]
PUT/api/v1/deals/:id?include_projectsStage bar click; Won; Reopen{pipeline_id, stage_id} or {status}{data: Deal(v1)}[net EV-033] [net EV-063]
PUT/api/v1/deals/:idMark as lost{lost_reason, status}{data: Deal(v1)}[net EV-063]
POST/api/v1/notesLost comment{deal_id, content, pinned_to_deal_flag}{data: Note}[net EV-063]
POST/api/v1/dealsSave in the Add deal form{pipeline_id, visible_to, user_id, stage_id, title, org_id, origin, origin_id, channel, channel_id}201, {data: Deal(v1)} (81 keys)[net EV-063]
GET/api/:id/deals/count?archived_status&pipeline_id&quick_filter_id&statusAfter creating a dealnonecount[net EV-063]
DELETE/api/v1/deals/:idDeal menu > Deletenone200[net EV-047]
GET/api/v1/data-police/dataQualityRules/missingRequiredFields?deal_id&new_stage_idBefore a stage movenone{dealId, missingDealFields, missingPersonFields, missingOrganizationFields, personId, organizationId}[net EV-033]
GET/api/v1/data-police/dataQualityRules?enabledDeal pagenone{importantFields, requiredFields}[net EV-031]
POST/api/:id/automation-suggestions/suggestions/triggerAfter a stage move{pattern[], stageId}{success, data}[net EV-033]
GET/api/:id/automation-suggestions/suggestions?experimentVariant&onlyVisible&patternsDeal pagenonesuggestions[net EV-033]
POST/proactive-cards-service/api/v1/triggersAfter marking done[{triggerType}]{data: []}[net EV-025]
POST/api/v1/insights-api/deals/chart and /activities/chartWon modal statisticsreport filter objectschart data[net EV-063]
GET/api/v1/fastis/sync/active, /api/v1/fastis/sync/:id/statusActivity form (calendar sync check)none204 or {data: {status}}[net EV-025]
GET/api/v1/deals/:id/participants?limit&startActivity formnone{data: null} when none[net EV-025]
+
+

08API

What the web app asks its server for each action, with the shape of the data and no real values.

IDs in paths are :id. Shapes and types only; no real values. The web app calls the same host as the page (/api/v1/...) and passes a session_token query parameter on every call [net EV-025]; the public API (v1 and v2) is documented in SRC-017 and SRC-018. Deprecated v1 endpoints with v2 replacements are out of support since 2026-08-01 [doc SRC-026], so a compatible clone should model v2 and treat these web-app v1 calls as the UI's private contract.

+
MethodTemplateTriggered byRequest shapeResponse shapeEvidence
GET/api/v1/deals/:id/activities?done&startCard status icon popovernone{data: Activity(v1)[]}[net EV-025]
PUT/api/v1/activities/:idDone circle (popover, Focus){done: boolean}{data: Activity(v1)} with marked_as_done_time[net EV-025]
GET/api/v1/activities/:idAfter marking donenone{data: Activity(v1)}[net EV-025]
POST/api/v1/activitiesSave in the activity form{subject, type, busy_flag, due_date, attendees[], assigned_to_user_id, done, deal_id, participants[], person_id, org_id}201, {data: Activity(v1)}[net EV-031]
DELETE/api/v1/activities/:idActivity menu > Deletenone200[obs EV-048] [net EV-047]
GET/api/v1/activities?start_date&end_date&user_id&limit&include_duration&include_private&include_recurringDay agenda in the activity formnone{data: Activity(v1)[]}[net EV-025]
GET/api/v1/scheduler/timeslots?start_date&end_date&is_activeDay agendanone{data: [], related_objects: {events: []}}[net EV-025]
GET/api/v1/activityTypesActivity formnone{data: ActivityType[]}[net EV-025]
GET/api/:id/fields/activity?activeOnlyActivity formnone{data: Field[]} with mandatory and visibility flags[net EV-025]
GET/api/v1/users?include_deleted_usersOwner pickernone{data: User[]}[net EV-025]
GET/api/v1/deals/:idPrefill links; reload a dealnone{data: Deal(v1)} with next_activity_* and counts[net EV-025]
PUT/api/v1/deals/:id?include_projectsStage bar click; Won; Reopen{pipeline_id, stage_id} or {status}{data: Deal(v1)}[net EV-033] [net EV-063]
PUT/api/v1/deals/:idMark as lost{lost_reason, status}{data: Deal(v1)}[net EV-063]
POST/api/v1/notesLost comment{deal_id, content, pinned_to_deal_flag}{data: Note}[net EV-063]
POST/api/v1/dealsSave in the Add deal form{pipeline_id, visible_to, user_id, stage_id, title, org_id, origin, origin_id, channel, channel_id}201, {data: Deal(v1)} (81 keys)[net EV-063]
GET/api/:id/deals/count?archived_status&pipeline_id&quick_filter_id&statusAfter creating a dealnonecount[net EV-063]
DELETE/api/v1/deals/:idDeal menu > Deletenone200[net EV-047]
GET/api/v1/data-police/dataQualityRules/missingRequiredFields?deal_id&new_stage_idBefore a stage movenone{dealId, missingDealFields, missingPersonFields, missingOrganizationFields, personId, organizationId}[net EV-033]
GET/api/v1/data-police/dataQualityRules?enabledDeal pagenone{importantFields, requiredFields}[net EV-031]
POST/api/:id/automation-suggestions/suggestions/triggerAfter a stage move{pattern[], stageId}{success, data}[net EV-033]
GET/api/:id/automation-suggestions/suggestions?experimentVariant&onlyVisible&patternsDeal pagenonesuggestions[net EV-033]
POST/proactive-cards-service/api/v1/triggersAfter marking done[{triggerType}]{data: []}[net EV-025]
POST/api/v1/insights-api/deals/chart and /activities/chartWon modal statisticsreport filter objectschart data[net EV-063]
GET/api/v1/fastis/sync/active, /api/v1/fastis/sync/:id/statusActivity form (calendar sync check)none204 or {data: {status}}[net EV-025]
GET/api/v1/deals/:id/participants?limit&startActivity formnone{data: null} when none[net EV-025]

Public API facts a clone that offers an API should match:

  • v2 base https://api.pipedrive.com/api/v2, cursor pagination with limit (max 500) and additional_data.next_cursor [doc SRC-024] [net EV-009].
  • Daily token budget per company, scaled by plan and seats; HTTP 429 when exhausted [doc SRC-025].
  • Webhooks v2 with meta, data and previous; retries at 3, 30 and 150 seconds [doc SRC-027].
  • OAuth access tokens last 60 minutes [doc SRC-028].

Third-party scripts seen on the page: Segment, FullStory, Intercom, Google Tag Manager, Gainsight PX, Grafana Faro (front-end telemetry) [obs EV-001].

-

09

Design system

Colors, typography, spacing, radius, shadow and motion as the product uses them.

Theme(s) studied: light only. Window: 1710 × 925 CSS px (screenshots at 1502 × 812). Values come from tokens.js on the production board [obs EV-002]; the stylesheet declares 971 custom properties named --pd-*.

+

09Design system

Colors, typography, spacing, radius, shadow and motion as the product uses them.

Color

surfacergb(255, 255, 255)--pd-color-fill-white-static
app backgroundrgb(245, 245, 246)--pd-color-surface-app-background
text primaryrgb(33, 35, 44)--pd-color-text-black-static
text secondaryrgb(101, 104, 111)--pd-color-text-secondary
dividerrgba(33, 35, 44, 0.14)--pd-color-divider-medium-rgba
navigationrgb(33, 28, 82)--pd-color-navigation-background
primary (green)rgb(45, 134, 71)--pd-color-primary-default
negative (red)rgb(216, 60, 56)--pd-color-negative-default
warning (yellow)rgb(209, 184, 0)--pd-non-semantic-color-lemon-yellow-108
inforgb(13, 104, 197)--pd-color-info-strong
info backgroundrgb(239, 246, 255)--pd-color-info-background-light
learn (purple)rgb(97, 80, 225)--pd-color-secondary-strong

Theme(s) studied: light only. Window: 1710 × 925 CSS px (screenshots at 1502 × 812). Values come from tokens.js on the production board [obs EV-002]; the stylesheet declares 971 custom properties named --pd-*.

Color

-
TokenLightDarkVariableUsed forEvidence
surfacergb(255, 255, 255)not studied--pd-color-fill-white-staticcards, dialogs[obs EV-002]
app backgroundrgb(245, 245, 246)not studied--pd-color-surface-app-backgroundboard background, columns[obs EV-002]
text primaryrgb(33, 35, 44)not studied--pd-color-text-black-statictitles[obs EV-002]
text secondaryrgb(101, 104, 111)not studied--pd-color-text-secondarysecond lines, icons[obs EV-002]
dividerrgba(33, 35, 44, 0.14)not studied--pd-color-divider-medium-rgbaborders[obs EV-002]
navigationrgb(33, 28, 82)not studied--pd-color-navigation-backgroundsidebar[obs EV-002]
primary (green)rgb(45, 134, 71)not studied--pd-color-primary-default"+ Deal", Won, today icon, Save[obs EV-002]
negative (red)rgb(216, 60, 56)not studied--pd-color-negative-defaultLost, overdue icon, errors, delete buttons[obs EV-002]
warning (yellow)rgb(209, 184, 0)not studied--pd-non-semantic-color-lemon-yellow-108no-activity triangle[obs EV-002]
inforgb(13, 104, 197)not studied--pd-color-info-stronglinks, active sort[obs EV-002]
info backgroundrgb(239, 246, 255)not studied--pd-color-info-background-lightinfo boxes[obs EV-002]
learn (purple)rgb(97, 80, 225)not studied--pd-color-secondary-strongtip banners[obs EV-002]
+
TokenLightDarkVariableUsed forEvidence
surfacergb(255, 255, 255)not studied--pd-color-fill-white-staticcards, dialogs[obs EV-002]
app backgroundrgb(245, 245, 246)not studied--pd-color-surface-app-backgroundboard background, columns[obs EV-002]
text primaryrgb(33, 35, 44)not studied--pd-color-text-black-statictitles[obs EV-002]
text secondaryrgb(101, 104, 111)not studied--pd-color-text-secondarysecond lines, icons[obs EV-002]
dividerrgba(33, 35, 44, 0.14)not studied--pd-color-divider-medium-rgbaborders[obs EV-002]
navigationrgb(33, 28, 82)not studied--pd-color-navigation-backgroundsidebar[obs EV-002]
primary (green)rgb(45, 134, 71)not studied--pd-color-primary-default"+ Deal", Won, today icon, Save[obs EV-002]
negative (red)rgb(216, 60, 56)not studied--pd-color-negative-defaultLost, overdue icon, errors, delete buttons[obs EV-002]
warning (yellow)rgb(209, 184, 0)not studied--pd-non-semantic-color-lemon-yellow-108no-activity triangle[obs EV-002]
inforgb(13, 104, 197)not studied--pd-color-info-stronglinks, active sort[obs EV-002]
info backgroundrgb(239, 246, 255)not studied--pd-color-info-background-lightinfo boxes[obs EV-002]
learn (purple)rgb(97, 80, 225)not studied--pd-color-secondary-strongtip banners[obs EV-002]

Typography

-
TokenFamilySizeWeightLine heightUsed forEvidence
body smallInter12px45018pxcard second lines[obs EV-002]
bodyInter14px45021pxtext[obs EV-002]
body strongInter14px60021pxcard titles[obs EV-002]
headingInter16px60024pxstage names[obs EV-002]
labelInter11px60016pxbadges[obs EV-002]
+
TokenFamilySizeWeightLine heightUsed forEvidence
body smallInter12px45018pxcard second lines[obs EV-002]
bodyInter14px45021pxtext[obs EV-002]
body strongInter14px60021pxcard titles[obs EV-002]
headingInter16px60024pxstage names[obs EV-002]
labelInter11px60016pxbadges[obs EV-002]

Spacing, radius, shadow

-
TokenValueVariableUsed forEvidence
space 14pxnonemost paddings[obs EV-002]
space 28pxnonecard padding[obs EV-002]
space 1.56pxnonecompact controls[obs EV-002]
space 312pxnonesections[obs EV-002]
radius m8px--pd-radius-mcards, buttons[obs EV-002]
radius xs4px--pd-radius-xsinputs[obs EV-002]
shadow cardrgba(42, 54, 71, 0.05) 0 1px 2px 0nonecards[obs EV-002]
shadow popover0 0 2px rgba(0,0,0,0.24), 0 16px 24px 2px rgba(0,0,0,0.05), 0 6px 30px 5px rgba(0,0,0,0.06), 0 8px 10px -5px rgba(0,0,0,0.1)nonemenus, popovers[obs EV-002]
+
TokenValueVariableUsed forEvidence
space 14pxnonemost paddings[obs EV-002]
space 28pxnonecard padding[obs EV-002]
space 1.56pxnonecompact controls[obs EV-002]
space 312pxnonesections[obs EV-002]
radius m8px--pd-radius-mcards, buttons[obs EV-002]
radius xs4px--pd-radius-xsinputs[obs EV-002]
shadow cardrgba(42, 54, 71, 0.05) 0 1px 2px 0nonecards[obs EV-002]
shadow popover0 0 2px rgba(0,0,0,0.24), 0 16px 24px 2px rgba(0,0,0,0.05), 0 6px 30px 5px rgba(0,0,0,0.06), 0 8px 10px -5px rgba(0,0,0,0.1)nonemenus, popovers[obs EV-002]

Motion

-
TokenDurationEasingUsed forEvidence
hover0.1scubic-bezier(0.5, 0, 0.2, 1)background and shadow on hover[obs EV-002]
dialog fadeabout 0.5snot measureddelete dialogs[obs EV-060]
+
TokenDurationEasingUsed forEvidence
hover0.1scubic-bezier(0.5, 0, 0.2, 1)background and shadow on hover[obs EV-002]
dialog fadeabout 0.5snot measureddelete dialogs[obs EV-060]

Z-index layers

-
LayerValueUsed forEvidence
base1-2sticky headers[obs EV-002]
overlay50toolbar layers[obs EV-002]
+
LayerValueUsed forEvidence
base1-2sticky headers[obs EV-002]
overlay50toolbar layers[obs EV-002]

Icons

-
NameSizeWhere usedEvidence
activity status (four states)24 pxdeal card[obs EV-010]
balance (weighted value)12 pxstage header[obs EV-010]
bell (rotting)12 pxstage header in the editor[obs EV-008]
activity type icons16 pxform type row, popover rows[obs EV-022]
+
NameSizeWhere usedEvidence
activity status (four states)24 pxdeal card[obs EV-010]
balance (weighted value)12 pxstage header[obs EV-010]
bell (rotting)12 pxstage header in the editor[obs EV-008]
activity type icons16 pxform type row, popover rows[obs EV-022]

Do not copy the icon files or the won illustration; draw new ones.

Breakpoints and layout

-
WidthChangeEvidence
1710 CSS pxSidebar 210 px; four stage columns of about 350 px[obs EV-011]
other widthsnot testednone
-

10

Build plan

What to build and in what order, the acceptance tests, and what to copy, avoid and improve.

Updated: 2026-10-16 · Status: draft

+
WidthChangeEvidence
1710 CSS pxSidebar 210 px; four stage columns of about 350 px[obs EV-011]
other widthsnot testednone
+

10Build plan

What to build and in what order, the acceptance tests, and what to copy, avoid and improve.

Updated: 2026-10-16 · Status: draft

Problem and users

Small and medium B2B sales teams in Brazil (2 to 50 sellers) need a pipeline that tells each seller what to do next, every day, and makes closing a deal fast. The studied product does this with one rule: every open deal should have a next activity. The clone keeps that rule and its signals, and adds what Brazilian teams need to buy it: WhatsApp, Portuguese, BRL, local invoicing and LGPD compliance.

Users: sellers (daily board and activities), sales managers (pipelines, stages, lost reasons), company admins (users, visibility, billing).

Launch blockers

From clone/barriers.md, severity blocks launch and adds lead time, with who clears each one and when.

-
BarrierSeverityOwnerStart by
BR-007 LGPD processor duties (DPA, records, incident process)blocks launchfounder with counselmonth 1
BR-009 NFS-e and CBS/IBS for the clone's own invoicesblocks launchfounder with an accountantmonth 1
BR-001 Terms of the studied productblocks launchcounselbefore building on this study
BR-005 WhatsApp Business Platform onboardingblocks feature (required to sell)engineering leadmonth 1
BR-002 Google restricted scopes and CASAblocks featureengineering leadmonth 1
BR-004 Microsoft publisher verification and Graphadds lead timeengineering leadmonth 2
BR-003 Google Calendar sensitive scopesadds lead timeengineering leadmonth 2
BR-008 Transfer clauses or São Paulo hostingadds lead timefoundermonth 1
+
BarrierSeverityOwnerStart by
BR-007 LGPD processor duties (DPA, records, incident process)blocks launchfounder with counselmonth 1
BR-009 NFS-e and CBS/IBS for the clone's own invoicesblocks launchfounder with an accountantmonth 1
BR-001 Terms of the studied productblocks launchcounselbefore building on this study
BR-005 WhatsApp Business Platform onboardingblocks feature (required to sell)engineering leadmonth 1
BR-002 Google restricted scopes and CASAblocks featureengineering leadmonth 1
BR-004 Microsoft publisher verification and Graphadds lead timeengineering leadmonth 2
BR-003 Google Calendar sensitive scopesadds lead timeengineering leadmonth 2
BR-008 Transfer clauses or São Paulo hostingadds lead timefoundermonth 1

Core loop

  1. The seller opens the board of a pipeline (S-001). Each card shows whether its next activity is overdue, today, in the future or missing (R-001), and the board is ordered by urgency (R-003).
  2. The seller works the top cards: from the card icon or the deal page, completes today's activity (R-013).
  3. When it was the last open activity, the product asks for the next one with sensible defaults and the day's agenda beside the form (R-014, R-016, R-017). Cancel is allowed and leaves a visible warning (R-015).
  4. The seller moves deals through stages in one click (R-030) and closes them as won or lost (R-022, R-027).
  5. The badge in the navigation keeps the count of overdue and due-today activities (R-012).

Scope by priority

-
PriorityFeatureRulesScreensNotes
P1F-001 Pipeline boardR-001 to R-011S-001Four activity states, urgency order, weighted totals, rotting
P1F-003 ActivitiesR-012, R-017, R-019 to R-021, R-047S-001, S-002, S-004Form with day agenda and 15-minute slots
P1F-004 Next-activity ruleR-013 to R-018S-001, S-002Improve the default type (see implications)
P1F-002 Deal detailR-030, R-031S-002Stage bar, Focus, History
P1F-005 WonR-022 to R-026S-002Ask what to do with open activities
P1F-006 LostR-027 to R-029S-002Reason list; comment kept as a note
P2F-007 Add dealR-037 to R-040S-001Person or organization required
P2F-008 Pipeline editorR-041 to R-043S-003Reject rotting of 0 days
P2F-009 Delete and restoreR-032 to R-036S-002, S-003Delete activities with their deal
P2F-015 WhatsAppnone observednoneRequired to sell in Brazil; waits for BR-005
P3F-011 Quick addR-046S-001One-key shortcuts
P4F-012 VisibilityR-048S-001Four levels from day one
P5F-013 Email sync, F-014 Calendar syncnone observednoneAfter BR-002, BR-003, BR-004
P5F-016 E-signaturenone observednoneThrough a Brazilian provider (BR-006)
+
PriorityFeatureRulesScreensNotes
P1F-001 Pipeline boardR-001 to R-011S-001Four activity states, urgency order, weighted totals, rotting
P1F-003 ActivitiesR-012, R-017, R-019 to R-021, R-047S-001, S-002, S-004Form with day agenda and 15-minute slots
P1F-004 Next-activity ruleR-013 to R-018S-001, S-002Improve the default type (see implications)
P1F-002 Deal detailR-030, R-031S-002Stage bar, Focus, History
P1F-005 WonR-022 to R-026S-002Ask what to do with open activities
P1F-006 LostR-027 to R-029S-002Reason list; comment kept as a note
P2F-007 Add dealR-037 to R-040S-001Person or organization required
P2F-008 Pipeline editorR-041 to R-043S-003Reject rotting of 0 days
P2F-009 Delete and restoreR-032 to R-036S-002, S-003Delete activities with their deal
P2F-015 WhatsAppnone observednoneRequired to sell in Brazil; waits for BR-005
P3F-011 Quick addR-046S-001One-key shortcuts
P4F-012 VisibilityR-048S-001Four levels from day one
P5F-013 Email sync, F-014 Calendar syncnone observednoneAfter BR-002, BR-003, BR-004
P5F-016 E-signaturenone observednoneThrough a Brazilian provider (BR-006)

Non-goals

  • Copying the studied product's brand, icons, illustrations or text (BR-014).
  • Leads inbox, campaigns, projects, products, AI assistant and reports in the first release.
  • Unofficial WhatsApp automation (BR-005).

Data model

@@ -827,17 +780,17 @@

Build order

Open questions

See questions.md.

Acceptance tests

One test per rule the clone must reproduce. A test passes when the clone shows the same behavior as the rule. Write each as an automated test before implementing it. Rows marked "differs on purpose" document the original behavior; the clone implements the improvement in clone/implications.md instead, and its test asserts the improved behavior.

-
TestRuleFeatureSummaryClone status
T-001R-001F-001Each card shows one of four activity states. Given an open deal on the board; when the board renders; then the card icon is red with "<" if its earliest open activity is overdue, green with ">" if it is due today, grey with ">" if it is in the future, and a yellow warning triangle if the deal has no open activitytodo
T-002R-002F-001An activity due today whose time has passed counts as overdue. Given a deal whose only overdue candidate is an activity due today at 09:00, viewed at 13:15; when the board renders; then the card icon is red and the popover shows "Today at 09:00" in redtodo
T-003R-003F-001The default order is overdue, today, no activity, future. Given a stage whose deals are in different activity states and the sort "Next activity (default)"; when the board loads; then the cards are ordered overdue first, then due today, then deals with no open activity, then deals whose next activity is in the futuretodo
T-004R-004F-001Within "today", an activity without a time comes before a timed one. Given two deals with activities due today, one without a time and one at 17:00; when the board loads; then the deal whose activity has no time is listed firsttodo
T-005R-005F-001Ties are broken by the newest deal first. Given deals in the same activity state and due date; when the board loads; then the most recently created deal comes firsttodo
T-006R-006F-001The board does not re-sort after an in-place change until reload. Given a card whose activity state changes from the popover, or a deal just created; when the change is saved; then the card keeps its position (a new deal goes to the top with a NEW badge) until the page is reloadeddiffers on purpose: see B-006 and clone/implications.md
T-007R-007F-001The stage header shows the weighted value of its deals. Given deals with values in a stage with probability P and no deal-level probability; when the board renders; then the header shows Σ value × P ÷ 100 and the number of dealstodo
T-008R-008F-001A stage with rotting at 0 days marks deals rotten at once. Given a stage with rotting on and 0 days; when a deal enters it; then the card turns pale pink and shows a red "<1d" badge whose tooltip reads "No actions for <1 days"todo
T-009R-009F-001Closed and deleted deals leave the board. Given a pipeline with a lost deal and a deleted deal; when the board loads; then neither card is shown and the deal count excludes themtodo
T-010R-010F-001The status icon opens the deal's activity list. Given a card; when the user clicks its status icon; then a popover lists the open activities with relative dates and done circles, plus "+ Schedule an activity"; with no activity it reads "You have no activities scheduled for this deal"todo
T-011R-011F-001Dragging a card shows four drop zones. Given the board; when the user starts dragging a card; then four zones appear along the bottom: Delete, Lost, Won, Move totodo
T-012R-012F-003The Activities badge counts the user's overdue and due-today activities. Given the user's open activities; when one is created, completed or becomes due; then the navigation badge equals the number of the user's open activities that are overdue or due todaytodo
T-013R-013F-004Completing an activity while others remain open does not prompt. Given a deal with three open activities; when the user marks one done from the card popover; then the row is struck through with a green check, the toast "Activity marked as done (subject)" appears, no modal opens, and the card icon updates to the next open activitytodo
T-014R-014F-004Completing the last open activity prompts for the next one. Given a deal with exactly one open activity; when the user marks it done from the card popover or from the deal page Focus block; then the modal "Schedule your next activity" opens, linked to the deal and its organization, after a short skeletontodo
T-015R-015F-004Cancelling the prompt leaves the deal without a next step. Given the "Schedule your next activity" modal; when the user clicks Cancel; then nothing is created, the card shows the yellow warning icon, and the deal page Focus shows "No focus items yet" with "+ Schedule an activity"todo
T-016R-016F-004The prompt defaults to the first activity type, today and no time. Given the prompt opens after completing a call; when it renders; then the selected type is the first active type in the company's type order (not the type just completed), the subject placeholder is that type's name, the date is today, the time is empty, availability is Free, the owner is the current user, and the deal and organization are linkeddiffers on purpose: see B-002 and clone/implications.md
T-017R-017F-003Choosing a time fills the next 15-minute slot and switches to Busy. Given the activity form with no time; when the user clicks the start time at 13:19; then 13:30 is filled, a list of 15-minute slots opens, Free becomes Busy, and the day agenda shows the new block at 13:30todo
T-018R-018F-004Saving the prompt creates the activity and confirms it. Given the prompt with a subject; when the user clicks Save; then the activity is created, the toast "Activity added · View" appears, and the activity shows in Focustodo
T-019R-019F-003API defaults for activities. Given an activity created through the API; when it has a due time; then busy is true; without a time busy is false; participants is empty when no person is linked; due_time is stored in UTCtodo
T-020R-020F-003The deal page marks overdue activities. Given an open activity due yesterday; when the deal page opens; then the Focus item shows a red OVERDUE badge and a red "Yesterday at 10:00"todo
T-021R-021F-003Done activities move from Focus to History. Given an activity in Focus; when it is marked done; then it leaves Focus and appears in History with a green check, and the History filter shows "Activities (1)"todo
T-022R-022F-005Won is one click and needs no confirmation. Given an open deal on its detail page; when the user clicks Won; then the deal becomes won at once: WON badge and Reopen replace the buttons, the stage bar turns light green, "Create project" turns green, and Won time appears in Detailstodo
T-023R-023F-005Winning shows a celebration with next steps. Given the personal preference for the celebration is on; when a deal is marked won on its detail page; then about 4 seconds later a modal shows the deal card, "Close time" and "Activities done", and asks "What's next for this won deal?" with "Schedule follow-up activity" and "Create a project", plus "Don't show me this again"todo
T-024R-024F-005The won follow-up opens with today and the first type. Given the company setting for the won follow-up popup names a type and a delay; when the user chooses "Schedule follow-up activity"; then the form "Schedule an activity" opens with a "Follow up after winning a deal" box, today's date and the first activity type selected; the configured type and delay are not applied (setting read during the preflight, Q-018)differs on purpose: see B-001 and clone/implications.md
T-025R-025F-005, F-006Open activities stay open when a deal is won or lost. Given a deal with one open activity; when the deal is marked won or lost; then the activity remains open in Focus; nothing asks what to do with itdiffers on purpose: see B-004 and clone/implications.md
T-026R-026F-005Reopen returns a closed deal to open. Given a won deal; when the user clicks Reopen; then the deal is open again at once, the Won and Lost buttons return and Won time disappearstodo
T-027R-027F-006Losing a deal requires a reason. Given the Mark as Lost dialog with no reason selected; when the user clicks "Mark as lost"; then the reason select gets a red border, no message is shown and no request is senttodo
T-028R-028F-006With predefined reasons, the reason must come from the list. Given the company has predefined lost reasons and the setting "Allow free-form reasons" on; when the user types text that matches no reason and presses Enter; then the list stays empty, no option to use the text appears, and the reason remains unsetdiffers on purpose: see B-005 and clone/implications.md
T-029R-029F-006The lost comment becomes a note pinned to the deal. Given a reason and a comment in the dialog; when the user marks the deal lost; then the deal gets status lost with the reason, and a note with the comment is created and pinned: it shows in Focus (yellow) and History, and Details shows Lost time and Lost reasontodo
T-030R-030F-002Clicking a stage moves the deal at once. Given an open deal; when the user clicks a later stage in the stage bar; then the app checks the target stage's required fields, moves the deal without confirmation, and may show a "Recommended first automation" banner for that stagetodo
T-031R-031F-002The stage bar shows time per stage. Given a deal created directly in the third stage; when its page opens; then the first three chevrons are green with "0 days", the current stage tooltip reads "Been here for N minutes", and a later stage reads "This deal has not been in this stage yet"todo
T-032R-032F-009Deleting a deal does not delete its activities. Given an open deal with one open activity; when the user deletes the deal from its "..." menu; then the dialog mentions notes, files, documents and invoices but not activities; the deal page turns to a deleted state with Restore and a permanent deletion date 30 days later; the activity stays open and not deleted (the docs say it is deleted)differs on purpose: see B-003 and clone/implications.md
T-033R-033F-009Activities of a deleted deal can be deleted from its page. Given a deleted deal that still lists an open activity in Focus; when the user chooses Delete in the activity's menu and confirms; then the activity is deleted (the API reports is_deleted true)todo
T-034R-034F-009Deleting a note asks for confirmation and cannot be undone. Given a pinned note on a deal; when the user chooses Delete in its menu; then the dialog says "This action cannot be undone"; after confirming, the note disappears from Focus and Historytodo
T-035R-035F-009Deleting a pipeline requires a decision about its deals. Given a pipeline with deals; when the user chooses Delete pipeline in the editor; then the dialog asks what to do with the N deals: "Move deals to another pipeline" (default, needs a pipeline and stage) or "Delete deals" (warning: restorable within 30 days); the delete button stays disabled until the choice is completetodo
T-036R-036F-009Deleting an organization keeps other linked items. Given an organization; when the user deletes it; then the dialog says its notes, files, documents and invoices are deleted, other linked items remain without the organization, and it can be restored within 30 daystodo
T-037R-037F-007A deal needs a person or an organization in the form. Given the Add deal form with only a title; when the user clicks Save; then both contact fields show "A person or organization is required" with red borders and Save dimstodo
T-038R-038F-007Unmatched organization text creates a new organization. Given text typed in the Organization field; when it does not exactly match an existing organization; then the field shows a NEW badge and the list offers "Add 'text' as new organization"; picking the existing match removes the badgetodo
T-039R-039F-007New deal defaults. Given the Add deal form opened from a pipeline board; when it opens; then the pipeline is the current one, the first stage is selected, the owner is the current user, the currency is the company currency, and Visible to is "Item owner's visibility group"todo
T-040R-040F-007A saved deal appears at the top of its stage. Given a valid Add deal form; when the user saves; then the deal is created, the toast 'New deal "title" created · View' appears, the details view does not open, and the card shows at the top of its stage with a NEW badge until reloadtodo
T-041R-041F-008A new pipeline starts with five default stages. Given the pipeline selector; when the user chooses New pipeline; then the editor opens with the name "New pipeline", deal probability on, and five stages (Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started) at 100% with rotting offtodo
T-042R-042F-008Rotting accepts zero days. Given a stage in the editor; when the user turns rotting on; then the days field starts at 0, the header shows "0 days", and saving keeps 0differs on purpose: see B-007 and clone/implications.md
T-043R-043F-008Deleting an empty stage asks for confirmation. Given a stage with no deals in the editor; when the user clicks Delete Stage; then a dialog says "There are no deals in this stage right now" with Cancel and Delete stagetodo
T-044R-046F-011Quick add offers one-key shortcuts. Given the "+" button in the top bar; when the user opens it; then it lists Person P, Organization O, Activity A, Deal D, Lead L, Note N, Product R, Project Etodo
T-045R-047F-010The activities list opens on To-do with period tabs and a type filter. Given the Activities list; when it opens; then the To-do tab is selected, the other tabs are Overdue, Today, Tomorrow, This week, Next week and Select period, a type filter row offers All plus one icon per type, and a count shows "N activities"todo
T-046R-048F-012Visibility levels of an item. Given the Visible to field; when it opens; then it offers Item owner (owner, Deals admins, followers, parent visibility groups), Item owner's visibility group, Item owner's visibility group and sub-groups, and All userstodo
+
TestRuleFeatureSummaryClone status
T-001R-001F-001Each card shows one of four activity states. Given an open deal on the board; when the board renders; then the card icon is red with "<" if its earliest open activity is overdue, green with ">" if it is due today, grey with ">" if it is in the future, and a yellow warning triangle if the deal has no open activitytodo
T-002R-002F-001An activity due today whose time has passed counts as overdue. Given a deal whose only overdue candidate is an activity due today at 09:00, viewed at 13:15; when the board renders; then the card icon is red and the popover shows "Today at 09:00" in redtodo
T-003R-003F-001The default order is overdue, today, no activity, future. Given a stage whose deals are in different activity states and the sort "Next activity (default)"; when the board loads; then the cards are ordered overdue first, then due today, then deals with no open activity, then deals whose next activity is in the futuretodo
T-004R-004F-001Within "today", an activity without a time comes before a timed one. Given two deals with activities due today, one without a time and one at 17:00; when the board loads; then the deal whose activity has no time is listed firsttodo
T-005R-005F-001Ties are broken by the newest deal first. Given deals in the same activity state and due date; when the board loads; then the most recently created deal comes firsttodo
T-006R-006F-001The board does not re-sort after an in-place change until reload. Given a card whose activity state changes from the popover, or a deal just created; when the change is saved; then the card keeps its position (a new deal goes to the top with a NEW badge) until the page is reloadeddiffers on purpose: see B-006 and clone/implications.md
T-007R-007F-001The stage header shows the weighted value of its deals. Given deals with values in a stage with probability P and no deal-level probability; when the board renders; then the header shows Σ value × P ÷ 100 and the number of dealstodo
T-008R-008F-001A stage with rotting at 0 days marks deals rotten at once. Given a stage with rotting on and 0 days; when a deal enters it; then the card turns pale pink and shows a red "<1d" badge whose tooltip reads "No actions for <1 days"todo
T-009R-009F-001Closed and deleted deals leave the board. Given a pipeline with a lost deal and a deleted deal; when the board loads; then neither card is shown and the deal count excludes themtodo
T-010R-010F-001The status icon opens the deal's activity list. Given a card; when the user clicks its status icon; then a popover lists the open activities with relative dates and done circles, plus "+ Schedule an activity"; with no activity it reads "You have no activities scheduled for this deal"todo
T-011R-011F-001Dragging a card shows four drop zones. Given the board; when the user starts dragging a card; then four zones appear along the bottom: Delete, Lost, Won, Move totodo
T-012R-012F-003The Activities badge counts the user's overdue and due-today activities. Given the user's open activities; when one is created, completed or becomes due; then the navigation badge equals the number of the user's open activities that are overdue or due todaytodo
T-013R-013F-004Completing an activity while others remain open does not prompt. Given a deal with three open activities; when the user marks one done from the card popover; then the row is struck through with a green check, the toast "Activity marked as done (subject)" appears, no modal opens, and the card icon updates to the next open activitytodo
T-014R-014F-004Completing the last open activity prompts for the next one. Given a deal with exactly one open activity; when the user marks it done from the card popover or from the deal page Focus block; then the modal "Schedule your next activity" opens, linked to the deal and its organization, after a short skeletontodo
T-015R-015F-004Cancelling the prompt leaves the deal without a next step. Given the "Schedule your next activity" modal; when the user clicks Cancel; then nothing is created, the card shows the yellow warning icon, and the deal page Focus shows "No focus items yet" with "+ Schedule an activity"todo
T-016R-016F-004The prompt defaults to the first activity type, today and no time. Given the prompt opens after completing a call; when it renders; then the selected type is the first active type in the company's type order (not the type just completed), the subject placeholder is that type's name, the date is today, the time is empty, availability is Free, the owner is the current user, and the deal and organization are linkeddiffers on purpose: see B-002 and clone/implications.md
T-017R-017F-003Choosing a time fills the next 15-minute slot and switches to Busy. Given the activity form with no time; when the user clicks the start time at 13:19; then 13:30 is filled, a list of 15-minute slots opens, Free becomes Busy, and the day agenda shows the new block at 13:30todo
T-018R-018F-004Saving the prompt creates the activity and confirms it. Given the prompt with a subject; when the user clicks Save; then the activity is created, the toast "Activity added · View" appears, and the activity shows in Focustodo
T-019R-019F-003API defaults for activities. Given an activity created through the API; when it has a due time; then busy is true; without a time busy is false; participants is empty when no person is linked; due_time is stored in UTCtodo
T-020R-020F-003The deal page marks overdue activities. Given an open activity due yesterday; when the deal page opens; then the Focus item shows a red OVERDUE badge and a red "Yesterday at 10:00"todo
T-021R-021F-003Done activities move from Focus to History. Given an activity in Focus; when it is marked done; then it leaves Focus and appears in History with a green check, and the History filter shows "Activities (1)"todo
T-022R-022F-005Won is one click and needs no confirmation. Given an open deal on its detail page; when the user clicks Won; then the deal becomes won at once: WON badge and Reopen replace the buttons, the stage bar turns light green, "Create project" turns green, and Won time appears in Detailstodo
T-023R-023F-005Winning shows a celebration with next steps. Given the personal preference for the celebration is on; when a deal is marked won on its detail page; then about 4 seconds later a modal shows the deal card, "Close time" and "Activities done", and asks "What's next for this won deal?" with "Schedule follow-up activity" and "Create a project", plus "Don't show me this again"todo
T-024R-024F-005The won follow-up opens with today and the first type. Given the company setting for the won follow-up popup names a type and a delay; when the user chooses "Schedule follow-up activity"; then the form "Schedule an activity" opens with a "Follow up after winning a deal" box, today's date and the first activity type selected; the configured type and delay are not applied (setting read during the preflight, Q-018)differs on purpose: see B-001 and clone/implications.md
T-025R-025F-005, F-006Open activities stay open when a deal is won or lost. Given a deal with one open activity; when the deal is marked won or lost; then the activity remains open in Focus; nothing asks what to do with itdiffers on purpose: see B-004 and clone/implications.md
T-026R-026F-005Reopen returns a closed deal to open. Given a won deal; when the user clicks Reopen; then the deal is open again at once, the Won and Lost buttons return and Won time disappearstodo
T-027R-027F-006Losing a deal requires a reason. Given the Mark as Lost dialog with no reason selected; when the user clicks "Mark as lost"; then the reason select gets a red border, no message is shown and no request is senttodo
T-028R-028F-006With predefined reasons, the reason must come from the list. Given the company has predefined lost reasons and the setting "Allow free-form reasons" on; when the user types text that matches no reason and presses Enter; then the list stays empty, no option to use the text appears, and the reason remains unsetdiffers on purpose: see B-005 and clone/implications.md
T-029R-029F-006The lost comment becomes a note pinned to the deal. Given a reason and a comment in the dialog; when the user marks the deal lost; then the deal gets status lost with the reason, and a note with the comment is created and pinned: it shows in Focus (yellow) and History, and Details shows Lost time and Lost reasontodo
T-030R-030F-002Clicking a stage moves the deal at once. Given an open deal; when the user clicks a later stage in the stage bar; then the app checks the target stage's required fields, moves the deal without confirmation, and may show a "Recommended first automation" banner for that stagetodo
T-031R-031F-002The stage bar shows time per stage. Given a deal created directly in the third stage; when its page opens; then the first three chevrons are green with "0 days", the current stage tooltip reads "Been here for N minutes", and a later stage reads "This deal has not been in this stage yet"todo
T-032R-032F-009Deleting a deal does not delete its activities. Given an open deal with one open activity; when the user deletes the deal from its "..." menu; then the dialog mentions notes, files, documents and invoices but not activities; the deal page turns to a deleted state with Restore and a permanent deletion date 30 days later; the activity stays open and not deleted (the docs say it is deleted)differs on purpose: see B-003 and clone/implications.md
T-033R-033F-009Activities of a deleted deal can be deleted from its page. Given a deleted deal that still lists an open activity in Focus; when the user chooses Delete in the activity's menu and confirms; then the activity is deleted (the API reports is_deleted true)todo
T-034R-034F-009Deleting a note asks for confirmation and cannot be undone. Given a pinned note on a deal; when the user chooses Delete in its menu; then the dialog says "This action cannot be undone"; after confirming, the note disappears from Focus and Historytodo
T-035R-035F-009Deleting a pipeline requires a decision about its deals. Given a pipeline with deals; when the user chooses Delete pipeline in the editor; then the dialog asks what to do with the N deals: "Move deals to another pipeline" (default, needs a pipeline and stage) or "Delete deals" (warning: restorable within 30 days); the delete button stays disabled until the choice is completetodo
T-036R-036F-009Deleting an organization keeps other linked items. Given an organization; when the user deletes it; then the dialog says its notes, files, documents and invoices are deleted, other linked items remain without the organization, and it can be restored within 30 daystodo
T-037R-037F-007A deal needs a person or an organization in the form. Given the Add deal form with only a title; when the user clicks Save; then both contact fields show "A person or organization is required" with red borders and Save dimstodo
T-038R-038F-007Unmatched organization text creates a new organization. Given text typed in the Organization field; when it does not exactly match an existing organization; then the field shows a NEW badge and the list offers "Add 'text' as new organization"; picking the existing match removes the badgetodo
T-039R-039F-007New deal defaults. Given the Add deal form opened from a pipeline board; when it opens; then the pipeline is the current one, the first stage is selected, the owner is the current user, the currency is the company currency, and Visible to is "Item owner's visibility group"todo
T-040R-040F-007A saved deal appears at the top of its stage. Given a valid Add deal form; when the user saves; then the deal is created, the toast 'New deal "title" created · View' appears, the details view does not open, and the card shows at the top of its stage with a NEW badge until reloadtodo
T-041R-041F-008A new pipeline starts with five default stages. Given the pipeline selector; when the user chooses New pipeline; then the editor opens with the name "New pipeline", deal probability on, and five stages (Qualified, Contact Made, Demo Scheduled, Proposal Made, Negotiations Started) at 100% with rotting offtodo
T-042R-042F-008Rotting accepts zero days. Given a stage in the editor; when the user turns rotting on; then the days field starts at 0, the header shows "0 days", and saving keeps 0differs on purpose: see B-007 and clone/implications.md
T-043R-043F-008Deleting an empty stage asks for confirmation. Given a stage with no deals in the editor; when the user clicks Delete Stage; then a dialog says "There are no deals in this stage right now" with Cancel and Delete stagetodo
T-044R-046F-011Quick add offers one-key shortcuts. Given the "+" button in the top bar; when the user opens it; then it lists Person P, Organization O, Activity A, Deal D, Lead L, Note N, Product R, Project Etodo
T-045R-047F-010The activities list opens on To-do with period tabs and a type filter. Given the Activities list; when it opens; then the To-do tab is selected, the other tabs are Overdue, Today, Tomorrow, This week, Next week and Select period, a type filter row offers All plus one icon per type, and a count shows "N activities"todo
T-046R-048F-012Visibility levels of an item. Given the Visible to field; when it opens; then it offers Item owner (owner, Deals admins, followers, parent visibility groups), Item owner's visibility group, Item owner's visibility group and sub-groups, and All userstodo

Copy

-
AreaItemWhyRefs
BoardFour-state activity icon on every card, clickable, opening the deal's activity listOne glance tells the seller what needs actionR-001, R-010
BoardDefault order: overdue, today, no next step, future; newest first on tiesPuts the day's work at the topR-003, R-004, R-005
ActivitiesPrompt for the next activity when the last open one is done; allow Cancel; leave a visible warningKeeps every deal moving without blocking the sellerR-014, R-015
ActivitiesForm with the day agenda beside it, next 15-minute slot, Busy on timed activitiesConflicts are visible before savingR-017
ActivitiesGlobal badge of overdue and due-today activitiesDaily workload in one numberR-012
LostRequired reason from a list; comment kept as a pinned noteClean loss analysisR-027, R-029
PipelineDeleting a pipeline forces a decision about its dealsPrevents silent data lossR-035
DeleteDeleted items keep a page with the purge date and RestoreEasy recoveryR-032
Stage barDays per stage and one-click movesSpeed and visibility of cycle timeR-030, R-031
+
AreaItemWhyRefs
BoardFour-state activity icon on every card, clickable, opening the deal's activity listOne glance tells the seller what needs actionR-001, R-010
BoardDefault order: overdue, today, no next step, future; newest first on tiesPuts the day's work at the topR-003, R-004, R-005
ActivitiesPrompt for the next activity when the last open one is done; allow Cancel; leave a visible warningKeeps every deal moving without blocking the sellerR-014, R-015
ActivitiesForm with the day agenda beside it, next 15-minute slot, Busy on timed activitiesConflicts are visible before savingR-017
ActivitiesGlobal badge of overdue and due-today activitiesDaily workload in one numberR-012
LostRequired reason from a list; comment kept as a pinned noteClean loss analysisR-027, R-029
PipelineDeleting a pipeline forces a decision about its dealsPrevents silent data lossR-035
DeleteDeleted items keep a page with the purge date and RestoreEasy recoveryR-032
Stage barDays per stage and one-click movesSpeed and visibility of cycle timeR-030, R-031

Avoid

-
AreaItemWhyRefs
ActivitiesDefaulting the next activity to the first type in the listSellers change it almost every timeB-002
WonIgnoring the configured follow-up type and delayThe setting looks brokenB-001
DeleteLeaving activities open when their deal is deleted, and not saying soOrphaned tasks on calendars and countsB-003
Won and lostLeaving open activities pending on closed deals without askingStale tasksB-004
LostA free-form setting that the dialog does not honorConfusing configurationB-005
Pipeline editorAccepting rotting of 0 daysEvery deal looks rottenB-007
Pipeline deleteDefaulting to moving deals into another pipelineEasy to pollute a live pipelineB-009
LocaleMixing the interface language with another language's dates and wordsLooks unfinishedB-008
InterfaceSeveral tip and upsell banners on the same pageNoiseB-010
+
AreaItemWhyRefs
ActivitiesDefaulting the next activity to the first type in the listSellers change it almost every timeB-002
WonIgnoring the configured follow-up type and delayThe setting looks brokenB-001
DeleteLeaving activities open when their deal is deleted, and not saying soOrphaned tasks on calendars and countsB-003
Won and lostLeaving open activities pending on closed deals without askingStale tasksB-004
LostA free-form setting that the dialog does not honorConfusing configurationB-005
Pipeline editorAccepting rotting of 0 daysEvery deal looks rottenB-007
Pipeline deleteDefaulting to moving deals into another pipelineEasy to pollute a live pipelineB-009
LocaleMixing the interface language with another language's dates and wordsLooks unfinishedB-008
InterfaceSeveral tip and upsell banners on the same pageNoiseB-010

Improve

-
AreaItemHowRefs
Next activitySuggest the next type and date from the stage playbook or the activity just completedStore a default next step per stage; preselect it in the promptR-016, B-002
ClosingAsk what to do with open activities on won, lost and deleteOptions: complete, cancel, keep; default to cancel for lost and deleteB-003, B-004
SignalsShow the same activity state in every view (list, deal page header, API)Expose a computed next_step_state field: overdue, today, future, noneR-001, R-020
Rule in the domainEnforce the next-activity rule in the API, not only in the UIAPI responses and webhooks flag deals with no next step; integrations and agents see itR-014
BoardRe-sort in place after a change, with a short animationRemoves the stale order until reloadB-006
WhatsAppFirst-class WhatsApp activity and conversation linked to the dealThe channel Brazilian SMBs use; requires BR-005BR-005
BrazilPortuguese interface, BRL, NFS-e for the clone's own billing, São Paulo hostingLocal fit and complianceBR-007, BR-008, BR-009
-

11

Before you launch

Approvals, licenses and certifications to start early, and what a new product cannot copy. Building can start now; these decide when you can sell.

Clone target market: see 00-charter.md (SMBs in Brazil). Not legal advice. A legal reading without a source is [inf] with a question for counsel in questions.md.

+
AreaItemHowRefs
Next activitySuggest the next type and date from the stage playbook or the activity just completedStore a default next step per stage; preselect it in the promptR-016, B-002
ClosingAsk what to do with open activities on won, lost and deleteOptions: complete, cancel, keep; default to cancel for lost and deleteB-003, B-004
SignalsShow the same activity state in every view (list, deal page header, API)Expose a computed next_step_state field: overdue, today, future, noneR-001, R-020
Rule in the domainEnforce the next-activity rule in the API, not only in the UIAPI responses and webhooks flag deals with no next step; integrations and agents see itR-014
BoardRe-sort in place after a change, with a short animationRemoves the stale order until reloadB-006
WhatsAppFirst-class WhatsApp activity and conversation linked to the dealThe channel Brazilian SMBs use; requires BR-005BR-005
BrazilPortuguese interface, BRL, NFS-e for the clone's own billing, São Paulo hostingLocal fit and complianceBR-007, BR-008, BR-009
+

11Before you launch

Approvals, licenses and certifications to start early, and what a new product cannot copy. Building can start now; these decide when you can sell.

Clone target market: see 00-charter.md (SMBs in Brazil). Not legal advice. A legal reading without a source is [inf] with a question for counsel in questions.md.

Summary

Launch blockers first. One row per barrier; details below.

-
BarrierCategorySeverityMarket weightBlocksLead time
BR-007 LGPD processor dutiesRegulationblocks launchrequired to sellSelling to any businessweeks (contracts and processes)
BR-009 Service invoices and the tax reformThe clone's own operationblocks launchrequired to sellCharging customersweeks (accountant, invoicing provider)
BR-001 Pipedrive terms on reverse engineeringIntellectual property and termsblocks launchn/aUsing this study to build a competitoruntil counsel decides
BR-005 WhatsApp Business PlatformPermissioned integrationblocks featurerequired to sellF-015days to weeks
BR-002 Gmail restricted scopesPermissioned integrationblocks featureimportantF-013 (Gmail)several weeks, yearly
BR-004 Microsoft 365 mail and calendarPermissioned integrationadds lead timeimportantF-013, F-014 (Microsoft)days
BR-003 Google Calendar scopesPermissioned integrationadds lead timeimportantF-014 (Google)3-5 business days
BR-008 International transferRegulationadds lead timeimportantHosting outside Brazilweeks (contracts)
BR-010 Recurring billing methodsThe clone's own operationadds costrequired to sellSubscriptionsdays (PSP onboarding)
BR-006 E-signaturesRegulationadds costimportantF-016days (provider integration)
BR-012 Bulk email sender rulesDistribution gatekeepersblocks featureimportantEmail sending from the CRMdays (DNS)
BR-011 Security certificationsCertificationsadds costminorLarger buyersmonths
BR-013 Enterprise controlsCertificationsadds costminorF-012 at scalemonths
BR-015 Ecosystem and dataData and network effectsmoatimportantSwitching from the productongoing
BR-014 Brand and assetsIntellectual propertymoatn/aCopying UI assetsnone (do not copy)
+
BarrierCategorySeverityMarket weightBlocksLead time
BR-007 LGPD processor dutiesRegulationblocks launchrequired to sellSelling to any businessweeks (contracts and processes)
BR-009 Service invoices and the tax reformThe clone's own operationblocks launchrequired to sellCharging customersweeks (accountant, invoicing provider)
BR-001 Pipedrive terms on reverse engineeringIntellectual property and termsblocks launchn/aUsing this study to build a competitoruntil counsel decides
BR-005 WhatsApp Business PlatformPermissioned integrationblocks featurerequired to sellF-015days to weeks
BR-002 Gmail restricted scopesPermissioned integrationblocks featureimportantF-013 (Gmail)several weeks, yearly
BR-004 Microsoft 365 mail and calendarPermissioned integrationadds lead timeimportantF-013, F-014 (Microsoft)days
BR-003 Google Calendar scopesPermissioned integrationadds lead timeimportantF-014 (Google)3-5 business days
BR-008 International transferRegulationadds lead timeimportantHosting outside Brazilweeks (contracts)
BR-010 Recurring billing methodsThe clone's own operationadds costrequired to sellSubscriptionsdays (PSP onboarding)
BR-006 E-signaturesRegulationadds costimportantF-016days (provider integration)
BR-012 Bulk email sender rulesDistribution gatekeepersblocks featureimportantEmail sending from the CRMdays (DNS)
BR-011 Security certificationsCertificationsadds costminorLarger buyersmonths
BR-013 Enterprise controlsCertificationsadds costminorF-012 at scalemonths
BR-015 Ecosystem and dataData and network effectsmoatimportantSwitching from the productongoing
BR-014 Brand and assetsIntellectual propertymoatn/aCopying UI assetsnone (do not copy)

BR-001 Pipedrive's terms forbid reverse engineering and building a competing product

  • Category: intellectual property and terms
  • Blocks: using this knowledge base to build and sell a competing CRM without legal clearance
  • Gatekeeper: Pipedrive's Terms of Service, s.4.1 "Prohibited Activities"
  • Severity: blocks launch (legal risk until counsel decides)
  • Market weight: n/a
  • What it takes: the Terms bar copying and derivative works, use for competitive analysis or to build a competing product, reverse engineering, and access by direct competitors [doc SRC-031]; the AUP bans harvesting data about others [doc SRC-032]. Whether behavior observed in the user's own account may inform a new product is a legal question [inf] Q-010
  • Lead time and cost: counsel review
  • Mitigation: rebuild from behavior, not assets (clean room); write new copy and art; record the decision in STATUS.md
  • Evidence: [doc SRC-031] [doc SRC-032]

BR-002 Gmail sync needs restricted-scope verification and a yearly security assessment

@@ -868,118 +821,61 @@

Summary

  • Category: intellectual property and terms
  • Blocks: copying UI assets
  • Gatekeeper: Pipedrive's rights in its materials
  • Severity: moat
  • Market weight: n/a
  • What it takes: the Terms forbid copying Pipedrive materials [doc SRC-031]; the won illustration and icons are assets [obs EV-034]
  • Lead time and cost: design work for new assets and copy
  • Mitigation: new names, icons, illustrations and microcopy; keep only the behavior
  • Evidence: [doc SRC-031] [obs EV-034]

BR-015 The ecosystem and the customers' data are a moat

  • Category: data, content and network effects
  • Blocks: matching integrations and switching
  • Gatekeeper: Pipedrive Marketplace; customers' existing data
  • Severity: moat
  • Market weight: important
  • What it takes: Pipedrive cites 400+ Marketplace apps with a reviewed developer program [doc SRC-045] [doc SRC-029]; a public API with webhooks and OAuth [doc SRC-027] [doc SRC-028]
  • Lead time and cost: ongoing
  • Mitigation: importers for Pipedrive exports and spreadsheets; a public API and webhooks from the start; focus on WhatsApp and Brazilian integrations
  • Evidence: [doc SRC-045] [doc SRC-029] [doc SRC-027] [doc SRC-028]
-

12

Cross-cutting topics

Behavior that spans many screens: search, notifications, permissions and more.

Topic: deletion and restore

Features: F-009 · Status: draft

+

12Cross-cutting topics

Behavior that spans many screens: search, notifications, permissions and more.

Topic: deletion and restore

Features: F-009 · Status: draft

Summary

Deletes are soft for 30 days. The confirmations say what goes with each item, but deals and activities do not behave as the deal dialog and the docs say: activities survive their deal.

Behavior

  • Deal: dialog lists notes, files, documents and invoices; after delete the page shows a permanent deletion date 30 days later and a Restore button; activities stay open (R-032) [obs EV-045] [obs EV-046] [net EV-047].
  • Docs say deleting a deal deletes its activities, notes and attachments [doc SRC-014]; observed behavior differs for activities.
  • Activity: deletable from the deleted deal's page (R-033) [obs EV-048].
  • Note: "cannot be undone" (R-034) [obs EV-043].
  • Pipeline: move or delete its deals, with a warning when deleting (R-035) [obs EV-060] [obs EV-061].
  • Organization: linked items remain without it (R-036) [obs EV-062].
  • Restore data keeps deleted leads, deals, people and organizations for 30 days [doc SRC-015]; whether activities can be restored there is open (Q-002).

Scope and configuration

-
SettingScopeDefaultEvidence
Retentioncompany30 days[obs EV-046] [doc SRC-015]
+
SettingScopeDefaultEvidence
Retentioncompany30 days[obs EV-046] [doc SRC-015]

Rules

Not tested

  • Restoring anything; bulk delete from lists; deleting persons.
-
Topic: hidden writes

Actions in this product that change data or state without a Save button.

-
PatternWhereClassEvidence
Clicking a done circle completes the activity at once (no Save)Card popover, FocusA2[obs EV-020]
Completing the last open activity opens a modal; Cancel saves nothingCard popover, FocusA1[obs EV-024]
Clicking a stage chevron moves the deal at onceDeal pageA2[obs EV-032]
Won and Reopen apply on one clickDeal pageA2[obs EV-035] [obs EV-037]
Lost comments create a pinned noteMark as LostA2[obs EV-042]
Unmatched organization text creates a new organization on SaveAdd deal formA2[obs EV-051]
Deleting a deal leaves its activities openDeal pageA2[net EV-047]
Deleting a pipeline defaults to moving its deals into another pipelinePipeline editorA2[obs EV-060]
After deleting a pipeline the app opens another one, which becomes where Deals opens by defaultBoardA3[inf] Q-005
Banners and tips ("Don't show me this again", close icons) change personal preferencesDeal page, won modalA3[obs EV-034]
+
Topic: hidden writes

Actions in this product that change data or state without a Save button.

+
PatternWhereClassEvidence
Clicking a done circle completes the activity at once (no Save)Card popover, FocusA2[obs EV-020]
Completing the last open activity opens a modal; Cancel saves nothingCard popover, FocusA1[obs EV-024]
Clicking a stage chevron moves the deal at onceDeal pageA2[obs EV-032]
Won and Reopen apply on one clickDeal pageA2[obs EV-035] [obs EV-037]
Lost comments create a pinned noteMark as LostA2[obs EV-042]
Unmatched organization text creates a new organization on SaveAdd deal formA2[obs EV-051]
Deleting a deal leaves its activities openDeal pageA2[net EV-047]
Deleting a pipeline defaults to moving its deals into another pipelinePipeline editorA2[obs EV-060]
After deleting a pipeline the app opens another one, which becomes where Deals opens by defaultBoardA3[inf] Q-005
Banners and tips ("Don't show me this again", close icons) change personal preferencesDeal page, won modalA3[obs EV-034]

Not tested

  • Whether sort, filter and view choices persist per user (not changed).
  • Whether opening a deal records it in "recently viewed".
-
Topic: locale and formats

Features: F-001, F-002, F-003 · Status: draft

+
Topic: locale and formats

Features: F-001, F-002, F-003 · Status: draft

Summary

The account used English (US) for the interface with a Brazilian region setting and BRL. Numbers, dates and some sentence glue follow the regional setting, so the English interface shows Portuguese dates and words.

Behavior

  • Money: R$ 1.234.567,89 (dot thousands, comma decimals) on cards and headers [obs EV-010].
  • Short dates in forms: 16 de out de 2026, pattern D [de] MMM [de] YYYY [obs EV-022].
  • Long dates: 10 de outubro de 2026 in the deal summary [obs EV-027].
  • Agenda header: sexta-feira, outubro 16º (Portuguese weekday with an English-style ordinal) [obs EV-022].
  • History: Hoje às 13:11 next to English labels [obs EV-027].
  • Form copy: "Add Location, Video call e Description" (Portuguese "e") [obs EV-022].
  • Expected close date input placeholder DD/MM/YYYY [obs EV-049].
  • API times are UTC; the UI shows local time (UTC−03:00) [net EV-009] [obs EV-019].

Scope and configuration

-
SettingScopeDefaultEvidence
Interface languageuserEnglish (US) in this account[obs EV-001]
Regional formatuserBrazilian Portuguese formats[obs EV-022]
Default currencyuser and companyBRL[obs EV-049]
+
SettingScopeDefaultEvidence
Interface languageuserEnglish (US) in this account[obs EV-001]
Regional formatuserBrazilian Portuguese formats[obs EV-022]
Default currencyuser and companyBRL[obs EV-049]

Rules

Not tested

  • Portuguese interface language; other regional settings; time zone changes.
-
Topic: visibility and permissions

Features: F-012 · Status: draft

+
Topic: visibility and permissions

Features: F-012 · Status: draft

Summary

Every deal, organization and person has a visibility level. Pipelines are visible by visibility group: an account with one default group shows every pipeline to every user. Creating a group or changing pipeline access is a company setting.

Behavior

  • Four levels: Item owner; Item owner's visibility group (default for new deals); group and sub-groups; All users. "Item owner" still shows the item to Deals admins, followers and parent groups (R-048) [obs EV-052].
  • API values 1, 3, 5, 7 [net EV-009].
  • Visibility groups and permission sets: 15 each on Premium, 25 on Ultimate, none on Lite and Growth [doc SRC-041].
  • Only deal admins edit pipelines [doc SRC-004].

Scope and configuration

-
SettingScopeDefaultEvidence
Item visibilityitemowner's visibility group[obs EV-052]
Pipeline accessvisibility groupall pipelines in the default group[doc SRC-041]
+
SettingScopeDefaultEvidence
Item visibilityitemowner's visibility group[obs EV-052]
Pipeline accessvisibility groupall pipelines in the default group[doc SRC-041]

Rules

Not tested

  • The view of a second user (needs L1 with two accounts).
-

13

Findings

Problems and strengths noticed in the product during the study.

Problems

-
IDFindingSeverityWhereEvidence
B-001The won follow-up form ignores the company's configured activity type and delay: it opens with today and the first typeMediumC-003 after C-004[obs EV-036]
B-002The next activity always defaults to the first type in the company list, not the type just completed; with many custom types the seller changes it almost every timeMediumC-003[obs EV-022] [net EV-031]
B-003Deleting a deal leaves its activities open and not deleted, and the confirmation does not mention activities; the docs say they are deletedMediumS-002[obs EV-045] [net EV-047] [doc SRC-014]
B-004Winning or losing a deal does not ask what to do with its open activities; they stay pending on a closed dealMediumS-002[obs EV-035] [obs EV-042]
B-005Free-form lost reasons cannot be entered even with "Allow free-form reasons" on, when predefined reasons existLowC-005[obs EV-041]
B-006The board does not re-sort after an in-place change; a deal that just lost its next step stays at the top until reloadLowS-001[obs EV-024]
B-007Rotting accepts 0 days, which marks every deal in the stage as rotten the moment it entersLowS-003[obs EV-008] [obs EV-016]
B-008English interface mixed with Portuguese dates and words ("e", "Hoje às", "outubro 16º")LowS-002, C-003[obs EV-022] [obs EV-027]
B-009Pipeline deletion defaults to moving the deals into another pipeline; a hurried confirm can push test or old deals into a live pipelineLowC-008[obs EV-060]
B-010Several tip and upsell banners on one deal page (automation suggestion, field descriptions, pipeline-specific fields)LowS-002[obs EV-032] [obs EV-035]
B-011The won modal waits about 4 seconds for report calls before it appearsLowC-004[obs EV-034] [net EV-063]
+

13Findings

Problems and strengths noticed in the product during the study.

Problems

+
IDFindingSeverityWhereEvidence
B-001The won follow-up form ignores the company's configured activity type and delay: it opens with today and the first typeMediumC-003 after C-004[obs EV-036]
B-002The next activity always defaults to the first type in the company list, not the type just completed; with many custom types the seller changes it almost every timeMediumC-003[obs EV-022] [net EV-031]
B-003Deleting a deal leaves its activities open and not deleted, and the confirmation does not mention activities; the docs say they are deletedMediumS-002[obs EV-045] [net EV-047] [doc SRC-014]
B-004Winning or losing a deal does not ask what to do with its open activities; they stay pending on a closed dealMediumS-002[obs EV-035] [obs EV-042]
B-005Free-form lost reasons cannot be entered even with "Allow free-form reasons" on, when predefined reasons existLowC-005[obs EV-041]
B-006The board does not re-sort after an in-place change; a deal that just lost its next step stays at the top until reloadLowS-001[obs EV-024]
B-007Rotting accepts 0 days, which marks every deal in the stage as rotten the moment it entersLowS-003[obs EV-008] [obs EV-016]
B-008English interface mixed with Portuguese dates and words ("e", "Hoje às", "outubro 16º")LowS-002, C-003[obs EV-022] [obs EV-027]
B-009Pipeline deletion defaults to moving the deals into another pipeline; a hurried confirm can push test or old deals into a live pipelineLowC-008[obs EV-060]
B-010Several tip and upsell banners on one deal page (automation suggestion, field descriptions, pipeline-specific fields)LowS-002[obs EV-032] [obs EV-035]
B-011The won modal waits about 4 seconds for report calls before it appearsLowC-004[obs EV-034] [net EV-063]

Strengths

  • One clear sales rule in the product: every open deal should have a next activity, enforced by a prompt at the exact moment the last one is completed, never by blocking [obs EV-022].
  • One icon with four states on every card, and the warning icon is itself the button to schedule [obs EV-013] [obs EV-018].
  • Default order by urgency: overdue, today, no next step, future [obs EV-010].
  • Activity form with the day agenda beside it, the next free 15-minute slot, and Busy set automatically [obs EV-023].
  • A global badge of overdue and due-today activities [obs EV-010].
  • Lost requires a reason from a list; the comment is kept as a pinned note [obs EV-042].
  • Pipeline deletion forces a decision about its deals [obs EV-060].
  • Deleted deals keep a page with a clear permanent deletion date and a Restore button [obs EV-046].
  • The stage bar shows time spent per stage and moves the deal in one click [obs EV-028].
-

14

Open questions

What the study could not confirm, and how to answer it.

IDQuestionWhy it mattersHow to answerStatus
Q-001Confirm: the first click on Won, Lost, "+ Deal" and item menus was often ignored. Product bug or an artifact of driving a browser window that was not in front?An earlier study reported it as a product bugA person clicks the same controls by hand in a focused windowopen
Q-002Confirm: can deleted activities be restored? The activity delete dialog points to Restore data, which listed leads, deals, people, organizations, products and projects, but no activitiesTeardown and the clone's trash designIn L1, delete an activity and look for it in Restore dataopen
Q-003Confirm: is a free-form lost reason offered only when the company has no predefined reasons? Is there an API for the reason list?R-028 and E-009In L1, remove the predefined reasons and mark a deal lost; check the API referenceopen
Q-004Confirm: after saving a new pipeline, the board returns to the pipeline viewed before (seen in this session, not captured)S-003 behaviorCreate a pipeline in L1 and capture the board after Saveopen
Q-005Confirm: after deleting a pipeline, the app opens another pipeline, and that becomes where Deals opens by default (seen and restored in this session, not captured)Hidden write on a user preferenceRepeat in L1 and capture /deals-default before and afteropen
Q-006Confirm: what another user sees of "Item owner" deals and of a new pipelineVisibility model (R-048)L1 with a second useropen
Q-007Confirm: does the next-activity prompt also open for activities linked only to a person or organization, and from the Activities list?Scope of R-014Test in L1open
Q-008Confirm: what resets the rotting timer (docs say done activities, notes, files and emails)R-008 for longer periodsSet rotting to 1 day in L1 and test over two daysopen
Q-009Confirm: does a change in one tab or by another user appear without reload?Realtime requirementTwo tabs and two users in L1open
Q-010For counsel: the Terms forbid reverse engineering and using the service to build a competing product (SRC-031 s.4.1). Can this study be used to build and sell a clone?Launch risk BR-001Legal review by the user's counselopen
Q-011For counsel: which ISS service item applies to a CRM SaaS in the clone's city, and is the NFS-e national standard mandatory there?BR-009Municipal tax rules; accountantopen
Q-012For counsel: are simple or advanced e-signatures enough for the contracts the clone's buyers sign, and does CPC art. 784 §4 apply?BR-006Legal reviewopen
Q-013Confirm: cost and lead time of Google's CASA assessment for Gmail restricted scopesBR-002 budgetQuotes from authorized labsopen
Q-014Confirm: how many Brazilian SMB buyers require WhatsApp inside the CRMMarket weight of BR-005Customer interviews or a surveyopen
Q-015Confirm: which payment methods SMB buyers expect for a SaaS subscription (Pix Automático, boleto, card)BR-010Customer interviews; PSP dataopen
Q-016Confirm: do target customers' Microsoft 365 tenants restrict user consent or require Microsoft 365 Certification?BR-004Ask pilot customers' ITopen
Q-017Confirm: do SMB buyers in Brazil ask for SOC 2 or ISO 27001 before buying a CRM?Market weight of BR-011Sales callsopen
Q-018Confirm: the company setting for the won follow-up popup (type and "in 3 months") was read during the preflight but not captured, to keep company configuration out of the KBEvidence for R-024 and B-001In L1, set the type and delay, win a deal and capture bothopen
-

15

About this study

The goal, scope and terms of the study, the vocabulary of the product, and every public source used.

Charter

Date: 2026-10-16

-
ItemValue
GoalDocument Pipedrive's deals pipeline, activities and won/lost flows well enough that a team that never used it can rebuild them, and list what would stop a sellable CRM clone from launching
Requested byThe repository owner, through an orchestrating agent session (the result is published as a public example of the skill)
ScopeDeals pipeline board and deal detail view; activities and the "schedule next activity" prompt; marking deals won and lost. Barrier scan for these features and for a sellable CRM clone: email and calendar sync, WhatsApp, e-signature, data protection, the clone's own billing and invoices
Out of scopeLeads inbox, contact screens beyond what deals need, Insights and reports, Sales Inbox (email), Campaigns, Projects, the Smart Docs editor, the AI assistant, the automations editor (A4), company settings (A4), anything that needs a second user (L1)
Clone target marketSmall and medium businesses in Brazil: B2B sales teams of 2 to 50 sellers, selling in BRL, Portuguese-speaking users. Assumption written by the agent from the request
PrioritiesP1: pipeline board, deal detail, activities and the next-activity rule, won and lost. P2: deal creation, the pipeline editor, deletion and restore. P5: the settings that drive these rules, read only
ModeUnattended: no questions to the user; blocks go to "Needs human" in STATUS.md
Environment levelL3: a sandbox pipeline 🧪 [RE] Sandbox inside the production company. No L1 account exists; "Add company" starts a new subscription (A5), so L2 is not available
Write authorizationThe request: run "a real reverse engineering study" in the production company, "use L3, a pipeline named 🧪 [RE] Sandbox", keep company-wide settings untouched, assign activities to the operator only, create no persons with real data, and remove the whole sandbox before the session ends
KB languageEnglish (the example is public)
Terms of servicehttps://www.pipedrive.com/en/terms-of-service (current as of 16 September 2026), s.4.1 "Prohibited Activities": no copying or derivative works, no use for competitive analysis or to develop a competing product, no reverse engineering, no security testing; direct competitors may not use the service (SRC-031). Listed under "Needs human" in STATUS.md: the decision belongs to the user
-

Glossary

TermDefinitionEvidence
PipelineAn ordered list of stages a deal moves through. A company has several; the board shows one at a time[obs EV-008] [doc SRC-004]
StageA column of a pipeline with a name, a win probability (0-100%) and an optional rotting period[obs EV-008] [net EV-009]
DealA sales opportunity with a title, value, owner, stage and status (open, won, lost), linked to a person or an organization[obs EV-027] [net EV-009]
Board (pipeline view)The kanban screen: one column per stage, one card per open deal[obs EV-011]
ActivityA dated task linked to a deal, organization or person, with a type, an owner and a done flag[obs EV-019] [net EV-009]
Activity typeA company-defined list of kinds of activity (call, task, custom types) with icons; its order decides the default type[obs EV-022] [net EV-025]
Next activityThe earliest open activity of a deal; it drives the card icon and the board order[obs EV-010] [doc SRC-002]
Activity status iconThe round icon on a card: red overdue, green today, grey future, yellow warning when the deal has no open activity[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
Schedule your next activityThe modal that opens when the last open activity of a deal is marked done[obs EV-022]
FocusThe deal page block that lists open activities and pinned notes[obs EV-027] [obs EV-058]
HistoryThe deal page timeline of done activities, notes and changes, with filters[obs EV-030]
Stage barThe chevron bar on the deal page that shows days per stage and moves the deal on click[obs EV-028] [obs EV-032]
Won / LostThe two closing statuses of a deal; both can be reopened[obs EV-035] [obs EV-042] [obs EV-037]
Lost reasonThe required reason when a deal is lost, picked from a company list[obs EV-039] [obs EV-040]
RottingA per-stage period after which an inactive deal is marked: pink card and a red "<Nd" badge[obs EV-016] [doc SRC-005]
Weighted valueValue × probability; the stage header sums it for its deals[obs EV-010] [doc SRC-006]
Visibility (visible to)Who can see an item: item owner, owner's visibility group, group and sub-groups, all users[obs EV-052]
Visibility groupA company-level group of users that decides which pipelines and items they see[doc SRC-041]
FollowerA user who follows a deal; the owner follows by default and followers can see owner-only items[obs EV-052]
Restore dataThe settings page that keeps deleted items for 30 days[doc SRC-015] [obs EV-045]
Quick addThe "+" menu in the top bar with one-key shortcuts for new items[obs EV-055]
+

14Open questions

What the study could not confirm, and how to answer it.

IDQuestionWhy it mattersHow to answerStatus
Q-001Confirm: the first click on Won, Lost, "+ Deal" and item menus was often ignored. Product bug or an artifact of driving a browser window that was not in front?An earlier study reported it as a product bugA person clicks the same controls by hand in a focused windowopen
Q-002Confirm: can deleted activities be restored? The activity delete dialog points to Restore data, which listed leads, deals, people, organizations, products and projects, but no activitiesTeardown and the clone's trash designIn L1, delete an activity and look for it in Restore dataopen
Q-003Confirm: is a free-form lost reason offered only when the company has no predefined reasons? Is there an API for the reason list?R-028 and E-009In L1, remove the predefined reasons and mark a deal lost; check the API referenceopen
Q-004Confirm: after saving a new pipeline, the board returns to the pipeline viewed before (seen in this session, not captured)S-003 behaviorCreate a pipeline in L1 and capture the board after Saveopen
Q-005Confirm: after deleting a pipeline, the app opens another pipeline, and that becomes where Deals opens by default (seen and restored in this session, not captured)Hidden write on a user preferenceRepeat in L1 and capture /deals-default before and afteropen
Q-006Confirm: what another user sees of "Item owner" deals and of a new pipelineVisibility model (R-048)L1 with a second useropen
Q-007Confirm: does the next-activity prompt also open for activities linked only to a person or organization, and from the Activities list?Scope of R-014Test in L1open
Q-008Confirm: what resets the rotting timer (docs say done activities, notes, files and emails)R-008 for longer periodsSet rotting to 1 day in L1 and test over two daysopen
Q-009Confirm: does a change in one tab or by another user appear without reload?Realtime requirementTwo tabs and two users in L1open
Q-010For counsel: the Terms forbid reverse engineering and using the service to build a competing product (SRC-031 s.4.1). Can this study be used to build and sell a clone?Launch risk BR-001Legal review by the user's counselopen
Q-011For counsel: which ISS service item applies to a CRM SaaS in the clone's city, and is the NFS-e national standard mandatory there?BR-009Municipal tax rules; accountantopen
Q-012For counsel: are simple or advanced e-signatures enough for the contracts the clone's buyers sign, and does CPC art. 784 §4 apply?BR-006Legal reviewopen
Q-013Confirm: cost and lead time of Google's CASA assessment for Gmail restricted scopesBR-002 budgetQuotes from authorized labsopen
Q-014Confirm: how many Brazilian SMB buyers require WhatsApp inside the CRMMarket weight of BR-005Customer interviews or a surveyopen
Q-015Confirm: which payment methods SMB buyers expect for a SaaS subscription (Pix Automático, boleto, card)BR-010Customer interviews; PSP dataopen
Q-016Confirm: do target customers' Microsoft 365 tenants restrict user consent or require Microsoft 365 Certification?BR-004Ask pilot customers' ITopen
Q-017Confirm: do SMB buyers in Brazil ask for SOC 2 or ISO 27001 before buying a CRM?Market weight of BR-011Sales callsopen
Q-018Confirm: the company setting for the won follow-up popup (type and "in 3 months") was read during the preflight but not captured, to keep company configuration out of the KBEvidence for R-024 and B-001In L1, set the type and delay, win a deal and capture bothopen
+

15About this study

The goal, scope and terms of the study, the vocabulary of the product, and every public source used.

Charter

Date: 2026-10-16

+
ItemValue
GoalDocument Pipedrive's deals pipeline, activities and won/lost flows well enough that a team that never used it can rebuild them, and list what would stop a sellable CRM clone from launching
Requested byThe repository owner, through an orchestrating agent session (the result is published as a public example of the skill)
ScopeDeals pipeline board and deal detail view; activities and the "schedule next activity" prompt; marking deals won and lost. Barrier scan for these features and for a sellable CRM clone: email and calendar sync, WhatsApp, e-signature, data protection, the clone's own billing and invoices
Out of scopeLeads inbox, contact screens beyond what deals need, Insights and reports, Sales Inbox (email), Campaigns, Projects, the Smart Docs editor, the AI assistant, the automations editor (A4), company settings (A4), anything that needs a second user (L1)
Clone target marketSmall and medium businesses in Brazil: B2B sales teams of 2 to 50 sellers, selling in BRL, Portuguese-speaking users. Assumption written by the agent from the request
PrioritiesP1: pipeline board, deal detail, activities and the next-activity rule, won and lost. P2: deal creation, the pipeline editor, deletion and restore. P5: the settings that drive these rules, read only
ModeUnattended: no questions to the user; blocks go to "Needs human" in STATUS.md
Environment levelL3: a sandbox pipeline 🧪 [RE] Sandbox inside the production company. No L1 account exists; "Add company" starts a new subscription (A5), so L2 is not available
Write authorizationThe request: run "a real reverse engineering study" in the production company, "use L3, a pipeline named 🧪 [RE] Sandbox", keep company-wide settings untouched, assign activities to the operator only, create no persons with real data, and remove the whole sandbox before the session ends
KB languageEnglish (the example is public)
Terms of servicehttps://www.pipedrive.com/en/terms-of-service (current as of 16 September 2026), s.4.1 "Prohibited Activities": no copying or derivative works, no use for competitive analysis or to develop a competing product, no reverse engineering, no security testing; direct competitors may not use the service (SRC-031). Listed under "Needs human" in STATUS.md: the decision belongs to the user
+

Glossary

TermDefinitionEvidence
PipelineAn ordered list of stages a deal moves through. A company has several; the board shows one at a time[obs EV-008] [doc SRC-004]
StageA column of a pipeline with a name, a win probability (0-100%) and an optional rotting period[obs EV-008] [net EV-009]
DealA sales opportunity with a title, value, owner, stage and status (open, won, lost), linked to a person or an organization[obs EV-027] [net EV-009]
Board (pipeline view)The kanban screen: one column per stage, one card per open deal[obs EV-011]
ActivityA dated task linked to a deal, organization or person, with a type, an owner and a done flag[obs EV-019] [net EV-009]
Activity typeA company-defined list of kinds of activity (call, task, custom types) with icons; its order decides the default type[obs EV-022] [net EV-025]
Next activityThe earliest open activity of a deal; it drives the card icon and the board order[obs EV-010] [doc SRC-002]
Activity status iconThe round icon on a card: red overdue, green today, grey future, yellow warning when the deal has no open activity[obs EV-012] [obs EV-013] [obs EV-014] [obs EV-015]
Schedule your next activityThe modal that opens when the last open activity of a deal is marked done[obs EV-022]
FocusThe deal page block that lists open activities and pinned notes[obs EV-027] [obs EV-058]
HistoryThe deal page timeline of done activities, notes and changes, with filters[obs EV-030]
Stage barThe chevron bar on the deal page that shows days per stage and moves the deal on click[obs EV-028] [obs EV-032]
Won / LostThe two closing statuses of a deal; both can be reopened[obs EV-035] [obs EV-042] [obs EV-037]
Lost reasonThe required reason when a deal is lost, picked from a company list[obs EV-039] [obs EV-040]
RottingA per-stage period after which an inactive deal is marked: pink card and a red "<Nd" badge[obs EV-016] [doc SRC-005]
Weighted valueValue × probability; the stage header sums it for its deals[obs EV-010] [doc SRC-006]
Visibility (visible to)Who can see an item: item owner, owner's visibility group, group and sub-groups, all users[obs EV-052]
Visibility groupA company-level group of users that decides which pipelines and items they see[doc SRC-041]
FollowerA user who follows a deal; the owner follows by default and followers can see owner-only items[obs EV-052]
Restore dataThe settings page that keeps deleted items for 30 days[doc SRC-015] [obs EV-045]
Quick addThe "+" menu in the top bar with one-key shortcuts for new items[obs EV-055]

Sources

All read on 2026-10-16 with web search and web fetch (no logged-in browser). "Search excerpt" means only the search result snippet was readable. Recheck anything older than six months before relying on it.

-
IDTitleURLTypeRead onGives
SRC-001Pipeline view: manage deals lifecyclehttps://support.pipedrive.com/en/article/pipeline-viewdocs2026-10-16Board basics, add, move, close, delete, filters
SRC-002Pipeline view: how to prioritize dealshttps://support.pipedrive.com/en/article/how-are-deals-ordered-in-the-pipeline-viewdocs2026-10-16Default order and the four activity status icons
SRC-003Deal card customization and sortinghttps://support.pipedrive.com/article/deal-card-customization-sortingdocs2026-10-16Up to 7 card fields per user and pipeline; sort options
SRC-004Pipeline: how to design your sales processhttps://support.pipedrive.com/article/how-can-i-customize-my-pipeline-stagesdocs2026-10-16Stage editing, probability, rotting, deleting stages
SRC-005The Rotting featurehttps://support.pipedrive.com/en/article/the-rotting-featuredocs2026-10-16Rotting setup and what resets the timer
SRC-006Probability in Pipedrivehttps://support.pipedrive.com/en/article/probability-in-pipedrivedocs2026-10-16Weighted value formulas
SRC-007Deal detail viewhttps://support.pipedrive.com/article/deal-detail-viewdocs2026-10-16Stage bar, sidebar, Focus, History, Changelog
SRC-008Activitieshttps://support.pipedrive.com/en/article/activitiesdocs2026-10-16Default types, scheduling window, Busy/Free, done
SRC-009Activity inviteshttps://support.pipedrive.com/en/article/activity-invitesdocs2026-10-16Guests and invites need calendar sync
SRC-010How can I disable the follow-up activity pop-up?https://support.pipedrive.com/en/article/how-can-i-disable-the-follow-up-activity-pop-updocs2026-10-16The next-activity prompt and its plan-gated setting
SRC-011Lost reasonshttps://support.pipedrive.com/en/article/lost-reasonsdocs2026-10-16Mark-as-lost dialog; comments saved as a note; up to 100 reasons
SRC-012How can I enable predefined lost reasons?https://support.pipedrive.com/en/article/how-can-i-enable-predefined-lost-reasonsdocs2026-10-16Predefined list and the free-form option
SRC-013Projects by Pipedrivehttps://support.pipedrive.com/en/article/projects-by-pipedrivedocs2026-10-16"Mark as won and create a project" in the Won dropdown
SRC-014How can I delete items in Pipedrive?https://support.pipedrive.com/en/article/how-can-i-delete-items-in-pipedrivedocs2026-10-16States that deleting a deal deletes its activities, notes and attachments
SRC-015How can I restore data?https://support.pipedrive.com/en/article/restore-datadocs2026-10-16Restore data page, 30-day retention, linked items
SRC-016Pipedrive interface (keyboard shortcuts)https://support.pipedrive.com/en/article/quick-actions-in-pipedrivedocs2026-10-16Quick add keys and navigation shortcuts
SRC-017API v2 OpenAPI specificationhttps://developers.pipedrive.com/docs/api/v1/openapi-v2.yamlAPI spec2026-10-16v2 schemas: deals, activities, pipelines, stages, persons, organizations, fields
SRC-018API v1 OpenAPI specificationhttps://developers.pipedrive.com/docs/api/v1/openapi.yamlAPI spec2026-10-16v1 schemas: notes, users, activity types, v1-only deal fields
SRC-019API reference: Dealshttps://developers.pipedrive.com/docs/api/v1/DealsAPI ref2026-10-16Deal endpoints, statuses, include_fields
SRC-020API reference: Activitieshttps://developers.pipedrive.com/docs/api/v1/ActivitiesAPI ref2026-10-16Activity body parameters and token costs
SRC-021API reference: ActivityTypeshttps://developers.pipedrive.com/docs/api/v1/ActivityTypesAPI ref2026-10-16key_string links to Activity.type; icon keys
SRC-022API reference: Noteshttps://developers.pipedrive.com/docs/api/v1/NotesAPI ref2026-10-16Note links and pin flags
SRC-023Pipedrive API v2 migration guidehttps://pipedrive.readme.io/docs/pipedrive-api-v2-migration-guidedev guide2026-10-16v1 to v2 field changes; weighted value and next_activity fields removed
SRC-024Paginationhttps://pipedrive.readme.io/docs/core-api-concepts-paginationdev guide2026-10-16Cursor pagination in v2, offset in v1
SRC-025Rate limitinghttps://pipedrive.readme.io/docs/core-api-concepts-rate-limitingdev guide2026-10-16Daily token budget per company and burst limits
SRC-026Deprecated API v1 endpoints are out of supporthttps://developers.pipedrive.com/changelog/post/deprecated-apiv1-endpoints-become-out-of-supportchangelog2026-10-16v1 endpoints with v2 replacements unsupported from 2026-08-01
SRC-027Guide for Webhooks v2https://pipedrive.readme.io/docs/guide-for-webhooks-v2dev guide2026-10-16Webhook events, payload, retries, limits
SRC-028OAuth authorizationhttps://pipedrive.readme.io/docs/marketplace-oauth-authorizationdev guide2026-10-16OAuth flow and token lifetimes
SRC-029Marketplace app approval processhttps://pipedrive.readme.io/docs/marketplace-app-approval-processdev guide2026-10-16Review up to 21 business days
SRC-030Community: deleting open activities when a deal is won or losthttps://community.pipedrive.com/discussion/comment/14922community (search excerpt)2026-10-16Open activities are not removed automatically
SRC-031Pipedrive Terms of Servicehttps://www.pipedrive.com/en/terms-of-serviceterms2026-10-16s.4.1 Prohibited Activities: reverse engineering, competing products
SRC-032Pipedrive Acceptable Use Policyhttps://www.pipedrive.com/en/legal/aupterms2026-10-16Bans harvesting data about others
SRC-033Pipedrive Trust Centerhttps://trustcenter.pipedrive.com/vendor2026-10-16ISO 27001, ISO 27701, SOC 2 Type 2, SOC 3; AWS
SRC-034Pipedrive sub-processorshttps://www.pipedrive.com/en/subprocessorsvendor2026-10-16Hosting regions; no Brazil region
SRC-035Pipedrive Data Processing Agreementhttps://www.pipedrive.com/en/privacy/dpaterms2026-10-16EU SCCs and Brazil SCCs (ANPD Res. 19)
SRC-036Help: Email synchttps://support.pipedrive.com/en/article/email-syncdocs2026-10-16Plans and providers for email sync
SRC-037Help: Calendar synchttps://support.pipedrive.com/en/article/calendar-syncdocs2026-10-16Calendar providers, one-way or two-way
SRC-038Help: WhatsApp integrationhttps://support.pipedrive.com/en/article/whatsapp-integrationdocs2026-10-16Integration through Meta's WhatsApp Business Platform
SRC-039Help: Smart Docs eSignatureshttps://support.pipedrive.com/en/article/sales-documents-esignatures-betadocs2026-10-16Basic digital signing; plans
SRC-040Pipedrive pricing (Portuguese page)https://www.pipedrive.com/pt/pricingpricing2026-10-16Plans and per-seat prices in USD
SRC-041Help: Usage limitshttps://support.pipedrive.com/en/article/usage-limits-in-pipedrivedocs2026-10-16Limits per plan (fields, deals, visibility groups)
SRC-042Help: Security ruleshttps://support.pipedrive.com/en/article/security-rules-access-restrictionsdocs2026-10-16Security rules are Ultimate-only
SRC-043Help: Security dashboardhttps://support.pipedrive.com/article/security-dashboarddocs2026-10-16Audit log on Ultimate
SRC-044Help: Single sign-onhttps://support.pipedrive.com/en/article/single-sign-ondocs2026-10-16SAML SSO on all plans
SRC-045Pipedrive Marketplace: abouthttps://www.pipedrive.com/en/marketplace/aboutvendor2026-10-16"400+ apps"
SRC-046Google: restricted scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verificationdocs2026-10-16Security assessment, yearly reassessment, "several weeks"
SRC-047Google: sensitive scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verificationdocs2026-10-163-5 business days; submission requirements
SRC-048Google Cloud Help: security assessmenthttps://support.google.com/cloud/answer/13465431docs2026-10-16Assurance levels; yearly revalidation
SRC-049Google Cloud Help: unverified appshttps://support.google.com/cloud/answer/7454865docs2026-10-16100-user cap for unverified apps
SRC-050Gmail API scopeshttps://developers.google.com/workspace/gmail/api/auth/scopesdocs2026-10-16Which Gmail scopes are restricted
SRC-051Microsoft: publisher verificationhttps://learn.microsoft.com/en-us/entra/identity-platform/publisher-verification-overviewdocs2026-10-16Requirements; free
SRC-052Microsoft Graph permissions referencehttps://learn.microsoft.com/en-us/graph/permissions-referencedocs2026-10-16Mail and Calendars consent requirements
SRC-053Microsoft Entra: configure user consenthttps://learn.microsoft.com/en-us/entra/identity/enterprise-apps/configure-user-consentdocs2026-10-16Tenant consent policies
SRC-054Microsoft 365 App Compliancehttps://learn.microsoft.com/en-us/microsoft-365-app-certification/overviewdocs2026-10-16Publisher attestation and yearly certification
SRC-055Deprecation of EWS in Exchange Onlinehttps://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-ews-exchange-onlinedocs2026-10-16EWS disabled from October 2026, fully April 2027
SRC-056WhatsApp Business Platform pricinghttps://developers.facebook.com/docs/whatsapp/pricingdocs2026-10-16Per-message pricing; BRL billing for Brazil
SRC-057Meta Terms for WhatsApp Business Platformhttps://www.facebook.com/legal/Meta-Terms-for-WhatsApp-Business-Platformterms2026-10-16s.4.7 AI Providers
SRC-058WhatsApp: get started for Tech Providershttps://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providersdocs2026-10-16Business verification and App Review
SRC-059WhatsApp: templates overviewhttps://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overviewdocs2026-10-16Template review up to 24 hours
SRC-060WhatsApp: messaging limitshttps://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limitsdocs2026-10-16250 recipients per day for new portfolios
SRC-061WhatsApp Terms of Servicehttps://www.whatsapp.com/legal/terms-of-serviceterms2026-10-16Bans unofficial automation
SRC-062CADE keeps the preventive measure on WhatsApp termshttps://www.gov.br/cade/pt-br/assuntos/noticias/tribunal-do-cade-mantem-medida-preventiva-sobre-novos-termos-de-uso-do-whatsappregulator2026-10-16AI-provider ban suspended in Brazil
SRC-063Lei 14.063/2020 (updated text)https://www2.camara.leg.br/legin/fed/lei/2020/lei-14063-23-setembro-2020-790659-normaatualizada-pl.htmllaw2026-10-16Simple, advanced, qualified signatures; scope
SRC-064MP 2.200-2/2001https://www.gov.br/cti/pt-br/trajetoria-historica/base-legal/base-legal-legis-pdf/2001-08-24-mp-2-200-2-institui-icp-brasil-e-transforma-iti.pdflaw2026-10-16Art. 10 §2: non-ICP signatures accepted by the parties
SRC-065ITI FAQ: digital certificationhttps://www.gov.br/iti/pt-br/acesso-a-informacao/perguntas-frequentes/certificacao-digitalregulator2026-10-16Validity of non-ICP signatures
SRC-066Clicksign developer docshttps://developers.clicksign.com/docsdocs2026-10-16E-signature API with sandbox and webhooks
SRC-067D4Sign API referencehttps://docapi.d4sign.com.br/referencedocs2026-10-16E-signature API with an ICP-Brasil option
SRC-068LGPD, Lei 13.709/2018https://www2.camara.leg.br/legin/fed/lei/2018/lei-13709-14-agosto-2018-787077-publicacaooriginal-156212-pl.htmllaw2026-10-16Controller and processor duties; transfers
SRC-069Resolution CD/ANPD 2/2022https://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpd/resolucao-cd-anpd-no-2-de-27-de-janeiro-de-2022regulator2026-10-16Small processing agents
SRC-070Resolution CD/ANPD 15/2024https://bibliotecadigital.mj.gov.br/bitstream/1/12879/2/RES_ANPD_2024_15.htmlregulator2026-10-16Incident reporting in 3 business days
SRC-071Resolution CD/ANPD 18/2024https://www.tjba.jus.br/extrajudicial/wp-content/uploads/2024/08/RESOLUCAO-ANPD-No-18-Encarregado-de-Dados.pdfregulator2026-10-16Data protection officer (encarregado)
SRC-072Resolution CD/ANPD 19/2024https://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpd/resolucao-cd-anpd-no-19-de-23-de-agosto-de-2024regulator2026-10-16Standard contractual clauses for international transfers
SRC-073ANPD: international data transferhttps://www.gov.br/anpd/pt-br/assuntos/assuntos-internacionais/transferencia-internacional-de-dadosregulator2026-10-16Transfer mechanisms; EU adequacy
SRC-074Portal Nacional da NFS-ehttps://www.gov.br/nfse/pt-brregulator2026-10-16National service invoice issuer and APIs
SRC-075NFS-e: municipalities without adherence face blocked transfershttps://www.gov.br/nfse/pt-br/noticias/municipios-sem-adesao-ou-parametrizacao-da-nfs-e-ja-estao-sujeitos-a-bloqueio-de-transferenciasregulator2026-10-16LC 214/2025 art. 62
SRC-076CGIBS and RFB guidance on CBS and IBS from 2026https://www.cgibs.gov.br/comite-gestor-do-ibs-e-receita-federal-divulgam-orientacoes-sobre-a-entrada-em-vigor-da-cbs-e-do-ibs-em-1-de-janeiro-de-2026regulator2026-10-162026 informational highlight on invoices
SRC-077CGIBS: tax reform adaptation periodhttps://www.cgibs.gov.br/reforma-tributaria-comeca-em-2026-com-periodo-de-adaptacao-destaque-informativo-dos-novos-tributos-e-dispensa-de-penalidadesregulator2026-10-16Optional highlight on NFS-e; Simples Nacional from 2027
SRC-078BCB FAQ: Pix Automáticohttps://www.bcb.gov.br/content/estabilidadefinanceira/pix/pix-automatico-FAQ-participantes.pdfregulator2026-10-16Receiver rules and fees
SRC-079Pix Automático launch datehttps://www.gov.br/fazenda/pt-br/composicao/orgaos/orgaos-colegiados/crsfn/acesso-a-informacao/noticias/2024/bc-aperfeicoa-mecanismos-de-seguranca-do-pix-e-divulga-nova-data-de-lancamento-do-pix-automaticoregulator2026-10-16Launch on 16 June 2025
SRC-080Gmail email sender guidelineshttps://support.google.com/a/answer/81126docs2026-10-16Bulk sender requirements
SRC-081Yahoo sender best practiceshttps://senders.yahooinc.com/best-practices/docs2026-10-16Bulk sender requirements
SRC-082Microsoft: fix NDR 550 5.7.515https://support.microsoft.com/en-us/outlook/fix-ndr-error-550-5-7-515-in-outlook-comdocs2026-10-16Outlook.com high-volume sender rules
SRC-083Help: multiple company accountshttps://support.pipedrive.com/en/article/can-i-be-in-multiple-pipedrive-company-accountsdocs2026-10-16Each company account is billed separately
SRC-084BCB: payment institution modelshttps://www.bcb.gov.br/content/publicacoes/boxe_relatorio_de_economia_bancaria/reb2023b3p.pdfregulator (search excerpt)2026-10-16Payment institution types
SRC-085STF ADI 5.659 publicationhttps://legis.senado.leg.br/norma/34722497/publicacao/34722533law (search excerpt)2026-10-16ISS on software and SaaS
-

16

Evidence

Every statement cites its evidence: [obs EV-###] seen in the product, [net EV-###] captured on the network, [doc SRC-###] public documentation, [inf] an inference with an open question.

-
Generated by RES (Reverse Engineering SaaS) from the knowledge base in this folder. The launch analysis is research, not legal advice. Rebuild from behavior; do not copy the original product's code, assets or brand.
+
IDTitleURLTypeRead onGives
SRC-001Pipeline view: manage deals lifecyclehttps://support.pipedrive.com/en/article/pipeline-viewdocs2026-10-16Board basics, add, move, close, delete, filters
SRC-002Pipeline view: how to prioritize dealshttps://support.pipedrive.com/en/article/how-are-deals-ordered-in-the-pipeline-viewdocs2026-10-16Default order and the four activity status icons
SRC-003Deal card customization and sortinghttps://support.pipedrive.com/article/deal-card-customization-sortingdocs2026-10-16Up to 7 card fields per user and pipeline; sort options
SRC-004Pipeline: how to design your sales processhttps://support.pipedrive.com/article/how-can-i-customize-my-pipeline-stagesdocs2026-10-16Stage editing, probability, rotting, deleting stages
SRC-005The Rotting featurehttps://support.pipedrive.com/en/article/the-rotting-featuredocs2026-10-16Rotting setup and what resets the timer
SRC-006Probability in Pipedrivehttps://support.pipedrive.com/en/article/probability-in-pipedrivedocs2026-10-16Weighted value formulas
SRC-007Deal detail viewhttps://support.pipedrive.com/article/deal-detail-viewdocs2026-10-16Stage bar, sidebar, Focus, History, Changelog
SRC-008Activitieshttps://support.pipedrive.com/en/article/activitiesdocs2026-10-16Default types, scheduling window, Busy/Free, done
SRC-009Activity inviteshttps://support.pipedrive.com/en/article/activity-invitesdocs2026-10-16Guests and invites need calendar sync
SRC-010How can I disable the follow-up activity pop-up?https://support.pipedrive.com/en/article/how-can-i-disable-the-follow-up-activity-pop-updocs2026-10-16The next-activity prompt and its plan-gated setting
SRC-011Lost reasonshttps://support.pipedrive.com/en/article/lost-reasonsdocs2026-10-16Mark-as-lost dialog; comments saved as a note; up to 100 reasons
SRC-012How can I enable predefined lost reasons?https://support.pipedrive.com/en/article/how-can-i-enable-predefined-lost-reasonsdocs2026-10-16Predefined list and the free-form option
SRC-013Projects by Pipedrivehttps://support.pipedrive.com/en/article/projects-by-pipedrivedocs2026-10-16"Mark as won and create a project" in the Won dropdown
SRC-014How can I delete items in Pipedrive?https://support.pipedrive.com/en/article/how-can-i-delete-items-in-pipedrivedocs2026-10-16States that deleting a deal deletes its activities, notes and attachments
SRC-015How can I restore data?https://support.pipedrive.com/en/article/restore-datadocs2026-10-16Restore data page, 30-day retention, linked items
SRC-016Pipedrive interface (keyboard shortcuts)https://support.pipedrive.com/en/article/quick-actions-in-pipedrivedocs2026-10-16Quick add keys and navigation shortcuts
SRC-017API v2 OpenAPI specificationhttps://developers.pipedrive.com/docs/api/v1/openapi-v2.yamlAPI spec2026-10-16v2 schemas: deals, activities, pipelines, stages, persons, organizations, fields
SRC-018API v1 OpenAPI specificationhttps://developers.pipedrive.com/docs/api/v1/openapi.yamlAPI spec2026-10-16v1 schemas: notes, users, activity types, v1-only deal fields
SRC-019API reference: Dealshttps://developers.pipedrive.com/docs/api/v1/DealsAPI ref2026-10-16Deal endpoints, statuses, include_fields
SRC-020API reference: Activitieshttps://developers.pipedrive.com/docs/api/v1/ActivitiesAPI ref2026-10-16Activity body parameters and token costs
SRC-021API reference: ActivityTypeshttps://developers.pipedrive.com/docs/api/v1/ActivityTypesAPI ref2026-10-16key_string links to Activity.type; icon keys
SRC-022API reference: Noteshttps://developers.pipedrive.com/docs/api/v1/NotesAPI ref2026-10-16Note links and pin flags
SRC-023Pipedrive API v2 migration guidehttps://pipedrive.readme.io/docs/pipedrive-api-v2-migration-guidedev guide2026-10-16v1 to v2 field changes; weighted value and next_activity fields removed
SRC-024Paginationhttps://pipedrive.readme.io/docs/core-api-concepts-paginationdev guide2026-10-16Cursor pagination in v2, offset in v1
SRC-025Rate limitinghttps://pipedrive.readme.io/docs/core-api-concepts-rate-limitingdev guide2026-10-16Daily token budget per company and burst limits
SRC-026Deprecated API v1 endpoints are out of supporthttps://developers.pipedrive.com/changelog/post/deprecated-apiv1-endpoints-become-out-of-supportchangelog2026-10-16v1 endpoints with v2 replacements unsupported from 2026-08-01
SRC-027Guide for Webhooks v2https://pipedrive.readme.io/docs/guide-for-webhooks-v2dev guide2026-10-16Webhook events, payload, retries, limits
SRC-028OAuth authorizationhttps://pipedrive.readme.io/docs/marketplace-oauth-authorizationdev guide2026-10-16OAuth flow and token lifetimes
SRC-029Marketplace app approval processhttps://pipedrive.readme.io/docs/marketplace-app-approval-processdev guide2026-10-16Review up to 21 business days
SRC-030Community: deleting open activities when a deal is won or losthttps://community.pipedrive.com/discussion/comment/14922community (search excerpt)2026-10-16Open activities are not removed automatically
SRC-031Pipedrive Terms of Servicehttps://www.pipedrive.com/en/terms-of-serviceterms2026-10-16s.4.1 Prohibited Activities: reverse engineering, competing products
SRC-032Pipedrive Acceptable Use Policyhttps://www.pipedrive.com/en/legal/aupterms2026-10-16Bans harvesting data about others
SRC-033Pipedrive Trust Centerhttps://trustcenter.pipedrive.com/vendor2026-10-16ISO 27001, ISO 27701, SOC 2 Type 2, SOC 3; AWS
SRC-034Pipedrive sub-processorshttps://www.pipedrive.com/en/subprocessorsvendor2026-10-16Hosting regions; no Brazil region
SRC-035Pipedrive Data Processing Agreementhttps://www.pipedrive.com/en/privacy/dpaterms2026-10-16EU SCCs and Brazil SCCs (ANPD Res. 19)
SRC-036Help: Email synchttps://support.pipedrive.com/en/article/email-syncdocs2026-10-16Plans and providers for email sync
SRC-037Help: Calendar synchttps://support.pipedrive.com/en/article/calendar-syncdocs2026-10-16Calendar providers, one-way or two-way
SRC-038Help: WhatsApp integrationhttps://support.pipedrive.com/en/article/whatsapp-integrationdocs2026-10-16Integration through Meta's WhatsApp Business Platform
SRC-039Help: Smart Docs eSignatureshttps://support.pipedrive.com/en/article/sales-documents-esignatures-betadocs2026-10-16Basic digital signing; plans
SRC-040Pipedrive pricing (Portuguese page)https://www.pipedrive.com/pt/pricingpricing2026-10-16Plans and per-seat prices in USD
SRC-041Help: Usage limitshttps://support.pipedrive.com/en/article/usage-limits-in-pipedrivedocs2026-10-16Limits per plan (fields, deals, visibility groups)
SRC-042Help: Security ruleshttps://support.pipedrive.com/en/article/security-rules-access-restrictionsdocs2026-10-16Security rules are Ultimate-only
SRC-043Help: Security dashboardhttps://support.pipedrive.com/article/security-dashboarddocs2026-10-16Audit log on Ultimate
SRC-044Help: Single sign-onhttps://support.pipedrive.com/en/article/single-sign-ondocs2026-10-16SAML SSO on all plans
SRC-045Pipedrive Marketplace: abouthttps://www.pipedrive.com/en/marketplace/aboutvendor2026-10-16"400+ apps"
SRC-046Google: restricted scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verificationdocs2026-10-16Security assessment, yearly reassessment, "several weeks"
SRC-047Google: sensitive scope verificationhttps://developers.google.com/identity/protocols/oauth2/production-readiness/sensitive-scope-verificationdocs2026-10-163-5 business days; submission requirements
SRC-048Google Cloud Help: security assessmenthttps://support.google.com/cloud/answer/13465431docs2026-10-16Assurance levels; yearly revalidation
SRC-049Google Cloud Help: unverified appshttps://support.google.com/cloud/answer/7454865docs2026-10-16100-user cap for unverified apps
SRC-050Gmail API scopeshttps://developers.google.com/workspace/gmail/api/auth/scopesdocs2026-10-16Which Gmail scopes are restricted
SRC-051Microsoft: publisher verificationhttps://learn.microsoft.com/en-us/entra/identity-platform/publisher-verification-overviewdocs2026-10-16Requirements; free
SRC-052Microsoft Graph permissions referencehttps://learn.microsoft.com/en-us/graph/permissions-referencedocs2026-10-16Mail and Calendars consent requirements
SRC-053Microsoft Entra: configure user consenthttps://learn.microsoft.com/en-us/entra/identity/enterprise-apps/configure-user-consentdocs2026-10-16Tenant consent policies
SRC-054Microsoft 365 App Compliancehttps://learn.microsoft.com/en-us/microsoft-365-app-certification/overviewdocs2026-10-16Publisher attestation and yearly certification
SRC-055Deprecation of EWS in Exchange Onlinehttps://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-ews-exchange-onlinedocs2026-10-16EWS disabled from October 2026, fully April 2027
SRC-056WhatsApp Business Platform pricinghttps://developers.facebook.com/docs/whatsapp/pricingdocs2026-10-16Per-message pricing; BRL billing for Brazil
SRC-057Meta Terms for WhatsApp Business Platformhttps://www.facebook.com/legal/Meta-Terms-for-WhatsApp-Business-Platformterms2026-10-16s.4.7 AI Providers
SRC-058WhatsApp: get started for Tech Providershttps://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providersdocs2026-10-16Business verification and App Review
SRC-059WhatsApp: templates overviewhttps://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overviewdocs2026-10-16Template review up to 24 hours
SRC-060WhatsApp: messaging limitshttps://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limitsdocs2026-10-16250 recipients per day for new portfolios
SRC-061WhatsApp Terms of Servicehttps://www.whatsapp.com/legal/terms-of-serviceterms2026-10-16Bans unofficial automation
SRC-062CADE keeps the preventive measure on WhatsApp termshttps://www.gov.br/cade/pt-br/assuntos/noticias/tribunal-do-cade-mantem-medida-preventiva-sobre-novos-termos-de-uso-do-whatsappregulator2026-10-16AI-provider ban suspended in Brazil
SRC-063Lei 14.063/2020 (updated text)https://www2.camara.leg.br/legin/fed/lei/2020/lei-14063-23-setembro-2020-790659-normaatualizada-pl.htmllaw2026-10-16Simple, advanced, qualified signatures; scope
SRC-064MP 2.200-2/2001https://www.gov.br/cti/pt-br/trajetoria-historica/base-legal/base-legal-legis-pdf/2001-08-24-mp-2-200-2-institui-icp-brasil-e-transforma-iti.pdflaw2026-10-16Art. 10 §2: non-ICP signatures accepted by the parties
SRC-065ITI FAQ: digital certificationhttps://www.gov.br/iti/pt-br/acesso-a-informacao/perguntas-frequentes/certificacao-digitalregulator2026-10-16Validity of non-ICP signatures
SRC-066Clicksign developer docshttps://developers.clicksign.com/docsdocs2026-10-16E-signature API with sandbox and webhooks
SRC-067D4Sign API referencehttps://docapi.d4sign.com.br/referencedocs2026-10-16E-signature API with an ICP-Brasil option
SRC-068LGPD, Lei 13.709/2018https://www2.camara.leg.br/legin/fed/lei/2018/lei-13709-14-agosto-2018-787077-publicacaooriginal-156212-pl.htmllaw2026-10-16Controller and processor duties; transfers
SRC-069Resolution CD/ANPD 2/2022https://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpd/resolucao-cd-anpd-no-2-de-27-de-janeiro-de-2022regulator2026-10-16Small processing agents
SRC-070Resolution CD/ANPD 15/2024https://bibliotecadigital.mj.gov.br/bitstream/1/12879/2/RES_ANPD_2024_15.htmlregulator2026-10-16Incident reporting in 3 business days
SRC-071Resolution CD/ANPD 18/2024https://www.tjba.jus.br/extrajudicial/wp-content/uploads/2024/08/RESOLUCAO-ANPD-No-18-Encarregado-de-Dados.pdfregulator2026-10-16Data protection officer (encarregado)
SRC-072Resolution CD/ANPD 19/2024https://www.gov.br/anpd/pt-br/acesso-a-informacao/institucional/atos-normativos/regulamentacoes_anpd/resolucao-cd-anpd-no-19-de-23-de-agosto-de-2024regulator2026-10-16Standard contractual clauses for international transfers
SRC-073ANPD: international data transferhttps://www.gov.br/anpd/pt-br/assuntos/assuntos-internacionais/transferencia-internacional-de-dadosregulator2026-10-16Transfer mechanisms; EU adequacy
SRC-074Portal Nacional da NFS-ehttps://www.gov.br/nfse/pt-brregulator2026-10-16National service invoice issuer and APIs
SRC-075NFS-e: municipalities without adherence face blocked transfershttps://www.gov.br/nfse/pt-br/noticias/municipios-sem-adesao-ou-parametrizacao-da-nfs-e-ja-estao-sujeitos-a-bloqueio-de-transferenciasregulator2026-10-16LC 214/2025 art. 62
SRC-076CGIBS and RFB guidance on CBS and IBS from 2026https://www.cgibs.gov.br/comite-gestor-do-ibs-e-receita-federal-divulgam-orientacoes-sobre-a-entrada-em-vigor-da-cbs-e-do-ibs-em-1-de-janeiro-de-2026regulator2026-10-162026 informational highlight on invoices
SRC-077CGIBS: tax reform adaptation periodhttps://www.cgibs.gov.br/reforma-tributaria-comeca-em-2026-com-periodo-de-adaptacao-destaque-informativo-dos-novos-tributos-e-dispensa-de-penalidadesregulator2026-10-16Optional highlight on NFS-e; Simples Nacional from 2027
SRC-078BCB FAQ: Pix Automáticohttps://www.bcb.gov.br/content/estabilidadefinanceira/pix/pix-automatico-FAQ-participantes.pdfregulator2026-10-16Receiver rules and fees
SRC-079Pix Automático launch datehttps://www.gov.br/fazenda/pt-br/composicao/orgaos/orgaos-colegiados/crsfn/acesso-a-informacao/noticias/2024/bc-aperfeicoa-mecanismos-de-seguranca-do-pix-e-divulga-nova-data-de-lancamento-do-pix-automaticoregulator2026-10-16Launch on 16 June 2025
SRC-080Gmail email sender guidelineshttps://support.google.com/a/answer/81126docs2026-10-16Bulk sender requirements
SRC-081Yahoo sender best practiceshttps://senders.yahooinc.com/best-practices/docs2026-10-16Bulk sender requirements
SRC-082Microsoft: fix NDR 550 5.7.515https://support.microsoft.com/en-us/outlook/fix-ndr-error-550-5-7-515-in-outlook-comdocs2026-10-16Outlook.com high-volume sender rules
SRC-083Help: multiple company accountshttps://support.pipedrive.com/en/article/can-i-be-in-multiple-pipedrive-company-accountsdocs2026-10-16Each company account is billed separately
SRC-084BCB: payment institution modelshttps://www.bcb.gov.br/content/publicacoes/boxe_relatorio_de_economia_bancaria/reb2023b3p.pdfregulator (search excerpt)2026-10-16Payment institution types
SRC-085STF ADI 5.659 publicationhttps://legis.senado.leg.br/norma/34722497/publicacao/34722533law (search excerpt)2026-10-16ISS on software and SaaS
+

16Evidence

Every statement cites its evidence: [obs EV-###] seen in the product, [net EV-###] captured on the network, [doc SRC-###] public documentation, [inf] an inference with an open question.

EV-003 New pipeline editor with its 5 default stages (100% each) and the Deal probability toggle on
EV-004 Tooltip of the pipeline-level Deal probability toggle
EV-005 Tooltip of the stage Probability field
EV-006 Tooltip of the stage Rotting toggle
EV-007 Confirmation dialog when deleting an empty stage in the editor
EV-008 Sandbox pipeline editor filled: 4 stages; probabilities 10/25/50/80; rotting 0 days on stage 2
EV-010 Sandbox board: four activity states; rotting card; weighted stage totals; default sort
EV-011 Board anatomy with numbered regions (annotate.js)
EV-012 Tooltip of the red overdue icon
EV-013 Tooltip of the yellow no-activity icon
EV-014 Tooltip of the grey upcoming icon
EV-015 Tooltip of the green today icon
EV-016 Rotting badge and its tooltip
EV-017 Tooltip of the info icon next to the deal count
EV-018 Popover of the no-activity icon
EV-019 Popover of a deal with three open activities (relative dates; done circles)
EV-020 Marking one of three activities done: strike-through; toast; no modal; icon turns grey; badge 29 to 28
EV-021 Marking the last open activity done: toast and modal skeleton while loading
EV-022 Schedule your next activity modal (form and day agenda)
EV-023 Clicking the time field fills the next 15-minute slot and switches Free to Busy; agenda shows the new block
EV-024 After Cancel: the deal shows the yellow no-activity icon; board not re-sorted until reload
EV-026 Sort menu (14 options; Next activity default) and the board re-sorted after reload
EV-027 Deal detail anatomy: header; stage bar; summary; composer tabs; Focus; History
EV-028 Stage bar tooltip of the current stage (time in stage)
EV-029 Stage bar tooltip of a stage the deal has not reached
EV-030 After saving the next activity from the modal: toast; Focus shows the new activity; History shows the done one
EV-032 Stage moved by one click on the stage bar; Recommended first automation banner
EV-034 Won modal: celebration; deal card; close time; activities done; What's next choices
EV-035 Won state: WON badge; Reopen; light stage bar; open activity still in Focus; Won time field
EV-036 Follow-up form opened from the won modal: info box; date today; first type selected
EV-037 Deal reopened: Won and Lost buttons back; stage bar dark
EV-038 Mark as Lost dialog
EV-039 Mark as lost with no reason: red border on the reason select; nothing sent
EV-040 Lost reason list with search (company reasons blurred)
EV-041 Free text typed in the reason search: no match and no option to use the text
EV-042 Lost state: LOST badge; Reopen; light red stage bar; comment saved as a pinned note; activity still open
EV-043 Delete note confirmation (cannot be undone)
EV-044 Deal more-actions menu
EV-045 Delete deal confirmation: lists notes; files; documents; invoices; not activities; 30-day restore
EV-046 Deleted deal page: banner with permanent deletion date; DELETED badge; Restore; open activity still listed
EV-048 Delete activity confirmation on a deleted deal
EV-049 Add deal form: core fields column (cropped)
EV-050 Add deal validation: A person or organization is required on both fields
EV-051 Organization autocomplete: NEW badge on unmatched text and the Add as new organization option
EV-052 Visible to options of a new deal
EV-053 Deal created from the form: toast with View; card on top of its stage with a NEW badge
EV-054 Dragging a card shows four drop zones at the bottom: Delete; Lost; Won; Move to
EV-055 Quick add menu with one-key shortcuts
EV-056 Activities list toolbar: type filter; period tabs; count; columns (rows blurred)
EV-057 Deal page Focus with a red OVERDUE badge on an activity due yesterday
EV-058 Deal page Focus empty state after the last activity is done
EV-059 Board with every deal lacking an activity: newest first in each stage
EV-060 Delete pipeline dialog with the default Move deals option
EV-061 Delete pipeline dialog with Delete deals selected and its warning
EV-062 Delete organization confirmation (cropped)

Captures that are not images

Network shapes, script output and notes, kept in the knowledge base folder.

IDShowsFileSize
EV-001inventory.js on the pipeline board: React; test IDs; routes; SDKs; storage key namesevidence/EV-001-inventory-board.json4.6 KB
EV-002tokens.js on the pipeline board (light theme): colors with variable names; type scale; spacing; radius; shadows; motionevidence/EV-002-tokens-board.json3.1 KB
EV-009Response shapes of deal; activity; organization; pipeline with stages (types only)evidence/EV-009-api-v2-shapes-deal-activity-pipeline.json3.1 KB
EV-025Network calls for mark-as-done and the next-activity modal (shapes only)evidence/EV-025-net-mark-done-and-next-activity-modal.json3.8 KB
EV-031Network call that creates the activity from the modal (shapes only)evidence/EV-031-net-create-activity-from-modal.json1.6 KB
EV-033Network calls of a stage move (shapes only)evidence/EV-033-net-stage-move.json1.3 KB
EV-047Network call of the deal delete and the API state of its activity afterwardsevidence/EV-047-net-deal-delete-activity-survives.json0.6 KB
EV-063Network calls for lost; reopen; won statistics; deal creation (shapes only)evidence/EV-063-net-close-reopen-create.json2.0 KB
+
Generated by RES (Reverse Engineering SaaS) from the knowledge base in this folder. The launch analysis is research, not legal advice. Rebuild from behavior; do not copy the original product's code, assets or brand.
+

+ diff --git a/package-lock.json b/package-lock.json index fec3e3e..17e5ec6 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "res", - "version": "0.3.1", + "version": "0.4.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "res", - "version": "0.3.1", + "version": "0.4.0", "license": "MIT", "devDependencies": { "playwright": "1.64.0" diff --git a/package.json b/package.json index d09f582..1f6991a 100644 --- a/package.json +++ b/package.json @@ -12,7 +12,7 @@ "engines": { "node": ">=22" }, - "version": "0.3.1", + "version": "0.4.0", "license": "MIT", "repository": { "type": "git", diff --git a/skills/reverse-engineering-saas/references/knowledge-base.md b/skills/reverse-engineering-saas/references/knowledge-base.md index d88aba1..5f8603a 100644 --- a/skills/reverse-engineering-saas/references/knowledge-base.md +++ b/skills/reverse-engineering-saas/references/knowledge-base.md @@ -132,7 +132,7 @@ Initialize the KB as its own git repository (`init-kb.mjs --git`), even inside a `node /scripts/pack-kb.mjs ` writes `REPORT.html` in the KB and `-handoff-.zip` next to the KB folder: -- `REPORT.html` is one self-contained page for people, in reading order: overview (summary, numbers, coverage, decisions needed), what the product does, screens, components, flows, how it behaves (rules), data model, API, design system, build plan (with acceptance tests), before you launch (barriers), topics, findings, open questions, about this study (charter, glossary, sources), and an evidence gallery. A notice at the top, and a comment at the top of the source, tell AI agents to read `BUILD.md` instead. Images are embedded and IDs are links; it has no scripts and makes no network requests. `build-report.mjs ` regenerates it alone. +- `REPORT.html` is one self-contained page for people, in reading order: overview (summary, numbers, coverage, decisions needed), what the product does, screens, components, flows, how it behaves (rules), data model, API, design system, build plan (with acceptance tests), before you launch (barriers), topics, findings, open questions, about this study (charter, glossary, sources), and an evidence gallery. A notice at the top, and a comment at the top of the source, tell AI agents to read `BUILD.md` instead. Images are embedded once and reused, and IDs are links. Its only script is an inline theme toggle and click-to-zoom, and its only network request is Google Fonts (it falls back to system fonts offline). `build-report.mjs ` regenerates it alone. - It runs `check-kb` first and stops on errors (`--force` packs anyway and says so). - It adds `BUILD.md` from `templates/handoff/BUILD.md` if the KB has none. Edit it in the KB to add instructions for a specific team. diff --git a/skills/reverse-engineering-saas/scripts/build-report.mjs b/skills/reverse-engineering-saas/scripts/build-report.mjs index d852791..132d2ed 100644 --- a/skills/reverse-engineering-saas/scripts/build-report.mjs +++ b/skills/reverse-engineering-saas/scripts/build-report.mjs @@ -1,7 +1,9 @@ #!/usr/bin/env node // Builds REPORT.html, the main report a person reads: one self-contained page -// rendered from the knowledge base's Markdown, with images embedded, IDs linked, -// and no scripts or external requests. No dependencies. +// laid out like a design study (screens, components and flows first-class), +// rendered from the knowledge base's Markdown. Images are embedded once as +// base64 and reused by class; the only script is an inline theme toggle and +// image zoom. No dependencies. import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'; import { basename, dirname, extname, join, relative, resolve, sep } from 'node:path'; import { fileURLToPath } from 'node:url'; @@ -12,13 +14,16 @@ const MIME = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', const COVERAGE = ['done', 'partial', 'blocked', 'todo', 'n/a']; const CHIP_WORDS = /^(blocks launch|blocks feature|adds lead time|adds cost|moat|required to sell|important|minor)\b/i; const CATALOG_FILES = ['inventory/features.md', 'inventory/screens.md', 'sources.md', 'questions.md', 'findings.md']; +const UNSEEN = /^\s*(not tested|not measured|not reached|not studied|not seen|none seen|none|n\/a|unknown)\b/i; +const GALLERY_LIMIT = 6; -const escapeHtml = (text) => text.replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"'); +const escapeHtml = (text) => String(text).replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"'); const read = (kb, file) => (existsSync(join(kb, file)) ? readFileSync(join(kb, file), 'utf8') : ''); // A comment on its own line goes with its line, so tables around it stay intact. const stripComments = (text) => text.replace(/^[ \t]*[ \t]*\r?\n/gm, '').replace(//g, ''); const listDir = (kb, dir, filter = () => true) => existsSync(join(kb, dir)) ? readdirSync(join(kb, dir)).filter((name) => !name.startsWith('.') && filter(name)).sort().map((name) => `${dir}/${name}`) : []; +const unique = (items) => [...new Set(items)]; // Everything the renderer needs to resolve images and links. function makeContext(kb) { @@ -48,21 +53,118 @@ function makeContext(kb) { if (id) anchors.add(id); } } - return { kb, anchors, fileIds, evidence, emitted: new Set(), embedded: new Set() }; + return { kb, anchors, fileIds, evidence, captions: readEvidenceIndex(kb), emitted: new Set(), pics: new Map() }; } -function dataUri(ctx, file) { - const mime = MIME[extname(file).toLowerCase()]; - if (!mime || !existsSync(join(ctx.kb, file))) return null; - ctx.embedded.add(file); - return `data:${mime};base64,${readFileSync(join(ctx.kb, file)).toString('base64')}`; +// evidence/index.csv: id,date,session,route,shows,masked. Quoted fields may hold commas. +function parseCsvLine(line) { + const cells = []; + let cell = ''; + let quoted = false; + for (let i = 0; i < line.length; i += 1) { + const ch = line[i]; + if (quoted) { + if (ch === '"' && line[i + 1] === '"') { + cell += '"'; + i += 1; + } else if (ch === '"') quoted = false; + else cell += ch; + } else if (ch === '"') quoted = true; + else if (ch === ',') { + cells.push(cell); + cell = ''; + } else cell += ch; + } + cells.push(cell); + return cells; +} + +function readEvidenceIndex(kb) { + const captions = new Map(); + const lines = read(kb, 'evidence/index.csv').split(/\r?\n/).filter((line) => line.trim()); + if (!lines.length) return captions; + const head = parseCsvLine(lines[0]).map((cell) => cell.trim().toLowerCase()); + const at = head.indexOf('shows') >= 0 ? head.indexOf('shows') : 4; + for (const line of lines.slice(1)) { + const cells = parseCsvLine(line); + const id = cells[0]?.trim(); + if (/^EV-\d{3}$/.test(id) && cells[at]) captions.set(id, cells[at].trim()); + } + return captions; +} + +// Pixel size from the file header, so each picture keeps its shape without layout shift. +function imageSize(buf, ext) { + try { + if (ext === '.png' && buf.length > 24) return [buf.readUInt32BE(16), buf.readUInt32BE(20)]; + if (ext === '.gif' && buf.length > 10) return [buf.readUInt16LE(6), buf.readUInt16LE(8)]; + if (ext === '.jpg' || ext === '.jpeg') { + let i = 2; + while (i + 9 < buf.length) { + if (buf[i] !== 0xff) { + i += 1; + continue; + } + const marker = buf[i + 1]; + if (marker >= 0xc0 && marker <= 0xcf && ![0xc4, 0xc8, 0xcc].includes(marker)) return [buf.readUInt16BE(i + 7), buf.readUInt16BE(i + 5)]; + i += 2 + buf.readUInt16BE(i + 2); + } + } + if (ext === '.webp' && buf.length > 30) { + const kind = buf.toString('ascii', 12, 16); + if (kind === 'VP8X') return [1 + buf.readUIntLE(24, 3), 1 + buf.readUIntLE(27, 3)]; + if (kind === 'VP8 ') return [buf.readUInt16LE(26) & 0x3fff, buf.readUInt16LE(28) & 0x3fff]; + if (kind === 'VP8L') { + const bits = buf.readUInt32LE(21); + return [(bits & 0x3fff) + 1, ((bits >> 14) & 0x3fff) + 1]; + } + } + } catch { + // Fall through to the default shape. + } + return [16, 10]; +} + +const isImage = (file) => Boolean(file && MIME[extname(file).toLowerCase()]); +const kbPath = (ctx, baseDir, src) => relative(ctx.kb, resolve(ctx.kb, baseDir, src)).split(sep).join('/'); +const evOf = (file) => (file ? basename(file).match(/^(EV-\d{3})/)?.[1] ?? null : null); + +// Registers an image once and returns its class; the bytes go into one stylesheet rule. +function registerPic(ctx, file) { + if (ctx.pics.has(file)) return ctx.pics.get(file); + const ext = extname(file).toLowerCase(); + if (!MIME[ext] || !existsSync(join(ctx.kb, file))) return null; + const buf = readFileSync(join(ctx.kb, file)); + const [w, h] = imageSize(buf, ext); + const pic = { cls: `p${ctx.pics.size + 1}`, w: w || 16, h: h || 10, uri: `data:${MIME[ext]};base64,${buf.toString('base64')}` }; + ctx.pics.set(file, pic); + return pic; +} + +// A picture element. kind "full" keeps the image's own shape; "thumb" crops to a fixed frame. +function pic(ctx, file, alt, kind = 'full') { + const p = registerPic(ctx, file); + if (!p) return ''; + const style = kind === 'full' ? ` style="aspect-ratio:${p.w}/${p.h};max-width:${p.w}px"` : ''; + return ``; +} + +const evFile = (ctx, id) => (id && isImage(ctx.evidence.get(id)) ? ctx.evidence.get(id) : null); +const evCaption = (ctx, id) => ctx.captions.get(id) || basename(ctx.evidence.get(id) || id).replace(/^EV-\d{3}-?/, '').replace(/\.[a-z0-9]+$/i, '').replace(/[-_]+/g, ' '); +const evIds = (text) => unique(text.match(/\bEV-\d{3}\b/g) || []); + +function shot(ctx, id, kind = 'full') { + const file = evFile(ctx, id); + if (!file) return ''; + const text = evCaption(ctx, id); + return `
${pic(ctx, file, `${id}: ${text}`, kind)}
${id} ${escapeHtml(text)}
`; } // Turns a Markdown link target into an in-page anchor or an external URL. function resolveHref(ctx, href, baseDir) { if (/^https?:\/\//i.test(href)) return href; if (href.startsWith('#')) return href; - const target = relative(ctx.kb, resolve(ctx.kb, baseDir, href.split('#')[0])).split(sep).join('/'); + const target = kbPath(ctx, baseDir, href.split('#')[0]); const id = ctx.fileIds.get(target) || basename(target).match(/^(EV-\d{3}|[A-Z]+-\d{3})/)?.[1]; return id && ctx.anchors.has(id) ? `#${id}` : null; } @@ -82,9 +184,8 @@ function renderInline(ctx, text, baseDir) { const [, code, alt, src, label, href, bold, italic] = match; if (code) html += `${linkIds(ctx, escapeHtml(code.slice(1, -1)))}`; else if (src !== undefined) { - const file = relative(ctx.kb, resolve(ctx.kb, baseDir, src)).split(sep).join('/'); - const uri = dataUri(ctx, file); - html += uri ? `${escapeHtml(alt)}` : `[image not found: ${escapeHtml(src)}]`; + const element = pic(ctx, kbPath(ctx, baseDir, src), alt); + html += element ? `${element}` : `[image not found: ${escapeHtml(src)}]`; } else if (label !== undefined) { const target = resolveHref(ctx, href, baseDir); const inner = renderInline(ctx, label, baseDir); @@ -101,7 +202,7 @@ function chipClass(value) { if (/blocks launch|required to sell/.test(v)) return 'red'; if (/blocks feature|important|blocked/.test(v)) return 'amber'; if (/lead time|adds cost|partial/.test(v)) return 'blue'; - if (/done/.test(v)) return 'green'; + if (/done|reviewed/.test(v)) return 'green'; return 'gray'; } @@ -112,25 +213,26 @@ function renderCell(ctx, cell, baseDir) { const keyword = value.match(CHIP_WORDS)?.[1]; if (keyword) return `${escapeHtml(keyword)}${renderInline(ctx, value.slice(keyword.length), baseDir)}`; if (/^(#[0-9a-f]{3,8}|rgba?\([\d\s.,%]+\))$/i.test(value)) return `${escapeHtml(value)}`; + if (UNSEEN.test(value) && value.length < 60) return `${renderInline(ctx, value, baseDir)}`; return renderInline(ctx, value, baseDir); } const splitRow = (line) => - line.trim().replace(/^\|/, '').replace(/\|$/, '').split(/(? cell.replace(/\\\|/g, '|')); + line.trim().replace(/^\|/, '').replace(/\|$/, '').split(/(? cell.replace(/\\\|/g, '|').trim()); function renderTable(ctx, lines, baseDir, file) { const [head, , ...rows] = lines; - const heads = splitRow(head).map((cell) => `${renderInline(ctx, cell.trim(), baseDir)}`).join(''); + const heads = splitRow(head).map((cell) => `${renderInline(ctx, cell, baseDir)}`).join(''); const body = rows .map((line) => { const cells = splitRow(line); - const id = CATALOG_FILES.includes(file) && cells[0]?.trim().match(/^([A-Z]+-\d{3})$/)?.[1]; + const id = CATALOG_FILES.includes(file) && cells[0]?.match(/^([A-Z]+-\d{3})$/)?.[1]; const attr = id && !ctx.emitted.has(id) && ![...ctx.fileIds.values()].includes(id) ? ` id="${id}"` : ''; if (attr) ctx.emitted.add(id); - return `${cells.map((cell) => `${renderCell(ctx, cell, baseDir)}`).join('')}`; + return `${cells.map((cell, index) => `${renderCell(ctx, cell, baseDir)}`).join('')}`; }) .join(''); - return `
${heads}${body}
`; + return `
${heads}${body}
`; } // "Severity: blocks feature (until approval)" shows the keyword as a chip and the rest as text. @@ -249,37 +351,292 @@ function renderMarkdown(ctx, markdown, file, headingShift = 0) { return out.join('\n'); } -// Collapsible section per file (screens, components, flows, entities, topics). +// ---------- Structured reading of artifact files ---------- + +// Splits an artifact file into its H1 title, the meta line under it, and its "## " parts. +function parseArtifact(text) { + const clean = stripComments(text); + const title = clean.match(/^#\s+(.*)$/m)?.[1]?.trim() ?? ''; + const [, id, name] = title.match(/^([A-Z]+-\d{3})\b\s*(.*)$/) || [null, null, title]; + const heads = [...clean.matchAll(/^##\s+(.+)$/gm)]; + const intro = (heads.length ? clean.slice(0, heads[0].index) : clean).replace(/^#\s+.*$/m, ''); + const metaLine = intro.split('\n').map((line) => line.trim()).find((line) => line && !/^[!|]/.test(line)) || ''; + const parts = new Map(); + const order = []; + heads.forEach((match, index) => { + const end = index + 1 < heads.length ? heads[index + 1].index : clean.length; + const key = match[1].trim(); + parts.set(key.toLowerCase(), clean.slice(match.index + match[0].length, end)); + order.push(key); + }); + // Whatever else sits between the meta line and the first part (lists, notes), minus lone images. + const introRest = intro.split('\n').filter((line) => line.trim() !== metaLine && !/^\s*!\[[^\]]*\]\([^)]*\)\s*$/.test(line)).join('\n').trim(); + return { id, name: name || title, metaLine, introRest, parts, order, text: clean }; +} + +const part = (artifact, ...names) => names.map((name) => artifact.parts.get(name.toLowerCase())).find((value) => value !== undefined) ?? ''; + +// First Markdown table in a block, as lower-case header cells and rows of cells. +function parseTable(block) { + const lines = block.split('\n'); + for (let i = 0; i < lines.length - 1; i += 1) { + if (lines[i].trim().startsWith('|') && /^\s*\|?\s*:?-{3,}/.test(lines[i + 1])) { + const rows = []; + for (let j = i + 2; j < lines.length && lines[j].trim().startsWith('|'); j += 1) rows.push(splitRow(lines[j])); + return { head: splitRow(lines[i]).map((cell) => cell.toLowerCase()), rows }; + } + } + return { head: [], rows: [] }; +} + +// Index of the first header that matches one of the names, or the fallback. +const col = (table, fallback, ...names) => { + for (const name of names) { + const index = table.head.findIndex((cell) => cell === name || cell.startsWith(name)); + if (index >= 0) return index; + } + return fallback; +}; + +const listItems = (block) => block.split('\n').map((line) => line.match(/^\s*[-*]\s+(.*)$/)?.[1]).filter(Boolean); +const paragraphs = (block) => block.split(/\n\s*\n/).map((chunk) => chunk.trim()).filter((chunk) => chunk && !/^[|!#`>-]/.test(chunk) && !/^\d+\./.test(chunk)); +const firstImage = (ctx, text, baseDir) => { + const src = text.match(/!\[[^\]]*\]\(([^)\s]+)\)/)?.[1]; + return src ? kbPath(ctx, baseDir, src) : null; +}; + +// "Features: F-001 · URL: `/x` · Status: done" as key and value pairs. +function metaPills(ctx, line, baseDir) { + if (!line) return ''; + const items = line.split(/\s+·\s+/).map((chunk) => chunk.match(/^([^:`]{1,40}):\s*(.+)$/)).filter(Boolean); + if (!items.length) return `

${renderInline(ctx, line, baseDir)}

`; + return `
${items + .map(([, key, value]) => { + const inner = /^status$/i.test(key.trim()) ? `${escapeHtml(value)}` : `${renderInline(ctx, value, baseDir)}`; + return `${escapeHtml(key.trim())}${inner}`; + }) + .join('')}
`; +} + +function anchor(ctx, id) { + if (!id || ctx.emitted.has(id)) return ''; + ctx.emitted.add(id); + return ` id="${id}"`; +} + +function objectHeader(ctx, artifact, file) { + const intro = artifact.introRest ? `
${renderMarkdown(ctx, artifact.introRest, file, 3)}
` : ''; + return `
${artifact.id ? `${artifact.id}` : ''}

${renderInline(ctx, artifact.name, dirname(file))}

${metaPills(ctx, artifact.metaLine, dirname(file))}${intro}`; +} + +// The parts of a file not shown in the designed view, rendered as plain notes. +function restNotes(ctx, artifact, file, skip, label) { + const keep = artifact.order.filter((name) => !skip.includes(name.toLowerCase())); + if (!keep.length) return ''; + const md = keep.map((name) => `## ${name}\n${artifact.parts.get(name.toLowerCase())}`).join('\n'); + return `
${escapeHtml(label)} ${escapeHtml(keep.join(', ').toLowerCase())}
${renderMarkdown(ctx, md, file, 2)}
`; +} + +// ---------- Screens ---------- + +function renderScreen(ctx, file) { + const artifact = parseArtifact(read(ctx.kb, file)); + const baseDir = dirname(file); + const purpose = paragraphs(part(artifact, 'Purpose')).map((p) => `

${renderInline(ctx, p, baseDir)}

`).join(''); + const anatomyBlock = part(artifact, 'Anatomy', 'Layout'); + const anatomy = parseTable(anatomyBlock); + const linked = firstImage(ctx, anatomyBlock, baseDir) || firstImage(ctx, artifact.text, baseDir); + const shots = evIds(artifact.text).filter((id) => evFile(ctx, id)); + const main = linked && isImage(linked) && existsSync(join(ctx.kb, linked)) ? linked : evFile(ctx, shots[0]); + const mainId = evOf(main); + const rest = shots.filter((id) => id !== mainId); + + const iRegion = col(anatomy, 1, 'region', 'part'); + const iContent = col(anatomy, 2, 'contents', 'content'); + const iComp = col(anatomy, -1, 'component'); + const legend = anatomy.rows.length + ? `
    ${anatomy.rows + .map((row) => { + const comp = iComp >= 0 && row[iComp] && !UNSEEN.test(row[iComp]) ? ` ${renderInline(ctx, row[iComp], baseDir)}` : ''; + return `
  1. ${escapeHtml(row[0] || '')}
    ${renderInline(ctx, row[iRegion] || '', baseDir)}${comp}${renderInline(ctx, row[iContent] || '', baseDir)}
  2. `; + }) + .join('')}
` + : ''; + let anat = ''; + if (main) { + const cap = mainId ? evCaption(ctx, mainId) : artifact.name; + const figure = `
${pic(ctx, main, `${artifact.name}: ${cap}`)}
${mainId ? `${mainId} ` : ''}${escapeHtml(cap)}
`; + anat = legend ? `
${figure}

Anatomy

${legend}
` : figure; + } else if (legend) anat = `

Anatomy

${legend}`; + + const thumbs = rest.map((id) => shot(ctx, id, 'thumb')); + const gallery = thumbs.length + ? `

More from this screen ${thumbs.length} screenshot${thumbs.length > 1 ? 's' : ''}

${thumbs.slice(0, GALLERY_LIMIT).join('')}
${ + thumbs.length > GALLERY_LIMIT ? `
Show ${thumbs.length - GALLERY_LIMIT} more
${thumbs.slice(GALLERY_LIMIT).join('')}
` : '' + }` + : ''; + + const states = parseTable(part(artifact, 'States')); + let statesHtml = ''; + if (states.rows.length) { + const iShow = col(states, 2, 'what it shows', 'visual', 'shows'); + const seen = states.rows.filter((row) => !UNSEEN.test(row[iShow] || '')); + const unseen = states.rows.filter((row) => UNSEEN.test(row[iShow] || '')); + statesHtml = `

States

${seen.length ? `
${seen + .map((row) => `
${renderInline(ctx, row[0], baseDir)}${renderInline(ctx, row[iShow] || '', baseDir)}
`) + .join('')}
` : ''}${unseen.length ? `

Not reached: ${unseen.map((row) => escapeHtml(row[0])).join(', ')}

` : ''}`; + } + + const notes = restNotes(ctx, artifact, file, ['purpose', 'anatomy', 'layout', 'states'], 'Full screen notes'); + return `
${objectHeader(ctx, artifact, file)}${purpose}${anat}${gallery}${statesHtml}${notes}
`; +} + +// ---------- Components ---------- + +function pills(ctx, rows, detailIndex, baseDir) { + return rows + .map((row) => { + const detail = row[detailIndex] || ''; + return `${renderInline(ctx, row[0], baseDir)}`; + }) + .join(''); +} + +function renderComponent(ctx, file) { + const artifact = parseArtifact(read(ctx.kb, file)); + const baseDir = dirname(file); + const linked = firstImage(ctx, artifact.text, baseDir); + const img = linked && isImage(linked) && existsSync(join(ctx.kb, linked)) ? linked : evIds(artifact.text).map((id) => evFile(ctx, id)).find(Boolean); + const imgId = evOf(img); + const visual = img + ? `
${pic(ctx, img, `${artifact.name}${imgId ? `: ${evCaption(ctx, imgId)}` : ''}`, 'thumb')}
${imgId ? `
${imgId} ${escapeHtml(evCaption(ctx, imgId))}
` : ''}
` + : '
No screenshot in the evidence
'; + const variants = parseTable(part(artifact, 'Variants')); + const states = parseTable(part(artifact, 'States')); + const behavior = listItems(part(artifact, 'Behavior', 'Behaviour')); + const vDetail = col(variants, 1, 'difference', 'what'); + const sDetail = col(states, 1, 'visual change', 'visual', 'what'); + const seenStates = states.rows.filter((row) => !UNSEEN.test(row[sDetail] || '')).length; + const body = [ + variants.rows.length ? `

Variants

${pills(ctx, variants.rows, vDetail, baseDir)}
` : '', + states.rows.length ? `

States ${seenStates} of ${states.rows.length} observed

${pills(ctx, states.rows, sDetail, baseDir)}
` : '', + behavior.length ? `

Behavior

    ${behavior.slice(0, 4).map((item) => `
  • ${renderInline(ctx, item, baseDir)}
  • `).join('')}
${behavior.length > 4 ? `

${behavior.length - 4} more in the notes.

` : ''}` : '', + ].join(''); + const notes = restNotes(ctx, artifact, file, ['behavior', 'behaviour'], 'Full component notes'); + return `
${visual}
${objectHeader(ctx, artifact, file)}${body}${notes}
`; +} + +// ---------- Flows ---------- + +function renderFlow(ctx, file) { + const artifact = parseArtifact(read(ctx.kb, file)); + const baseDir = dirname(file); + const steps = parseTable(part(artifact, 'Steps')); + const iNum = col(steps, 0, '#', 'step'); + const iScreen = col(steps, -1, 'screen'); + const iAction = col(steps, 2, 'user action', 'action'); + const iResp = col(steps, 3, 'system response', 'response', 'result'); + const iEv = col(steps, -1, 'evidence'); + const hint = steps.rows.length > 4 ? `

${steps.rows.length} steps. On a wide screen, scroll the strip sideways to see them all.

` : ''; + const strip = steps.rows.length + ? `${hint}
    ${steps.rows + .map((row, index) => { + const evs = evIds(iEv >= 0 ? row[iEv] || '' : row.join(' ')); + const imgId = evs.find((id) => evFile(ctx, id)); + const screenName = iScreen >= 0 ? row[iScreen] || '' : ''; + const screen = screenName ? `${renderInline(ctx, screenName, baseDir)}` : ''; + const thumb = imgId + ? `
    ${pic(ctx, evFile(ctx, imgId), `Step ${index + 1}: ${evCaption(ctx, imgId)}`, 'thumb')}
    ` + : `
    ${screenName ? escapeHtml(screenName) : 'No screenshot'}
    `; + return `
  1. ${thumb}
    ${escapeHtml(row[iNum] || String(index + 1))}${screen}
    ${renderInline(ctx, row[iAction] || '', baseDir)}${renderInline(ctx, row[iResp] || '', baseDir)}${evs.length ? `${evs.map((id) => linkIds(ctx, id)).join(' ')}` : ''}
  2. `; + }) + .join('')}
` + : renderMarkdown(ctx, part(artifact, 'Steps'), file, 2); + const branches = parseTable(part(artifact, 'Branches and errors', 'Branches')); + const bAt = col(branches, 0, 'at step', 'step'); + const bIf = col(branches, 1, 'condition', 'if'); + const bThen = col(branches, 2, 'what happens', 'result', 'then'); + const branchHtml = branches.rows.length + ? `

Branches and errors

${branches.rows + .map((row) => { + const outcome = row[bThen] || ''; + return `
Step ${escapeHtml(row[bAt] || '?')}
${renderInline(ctx, row[bIf] || '', baseDir)}${renderInline(ctx, outcome, baseDir)}
`; + }) + .join('')}
` + : ''; + const untested = listItems(part(artifact, 'Not tested')); + const untestedHtml = untested.length + ? `
!
Not tested${untested.map((item) => `

${renderInline(ctx, item, baseDir)}

`).join('')}
` + : ''; + const diagram = part(artifact, 'Diagram'); + const diagramHtml = diagram.trim() ? `
Diagram source mermaid
${renderMarkdown(ctx, diagram, file, 2)}
` : ''; + const notes = restNotes(ctx, artifact, file, ['steps', 'branches and errors', 'branches', 'not tested', 'diagram'], 'More notes'); + return `
${objectHeader(ctx, artifact, file)}${strip}${branchHtml}${untestedHtml}${diagramHtml}${notes}
`; +} + +// ---------- Rules ---------- + +const GWT = /^(Given|When|Then|And|But)\b\s*(.*)$/i; + +function renderRuleFile(ctx, file) { + const text = stripComments(read(ctx.kb, file)); + const title = text.match(/^#\s+(.*)$/m)?.[1] ?? basename(file, '.md'); + const baseDir = dirname(file); + const blocks = text.split(/^(?=#{2,6}\s+R-\d{3}\b)/m); + const lead = blocks[0].replace(/^#\s+.*$/m, '').trim(); + const cards = blocks.slice(1).map((block) => { + const lines = block.split('\n'); + const [, id, name] = lines[0].match(/^#{2,6}\s+(R-\d{3})\b\s*(.*)$/); + const items = []; + const extra = []; + for (const line of lines.slice(1)) { + const item = line.match(/^\s*[-*]\s+(.*)$/)?.[1]; + if (item !== undefined && !extra.length) items.push(item); + else if (/^\s{2,}\S/.test(line) && items.length && !extra.length) items[items.length - 1] += ` ${line.trim()}`; + else if (line.trim() || extra.length) extra.push(line); + } + const gwt = items.filter((item) => GWT.test(item)); + const meta = items.filter((item) => !GWT.test(item)); + const dl = gwt.length + ? `
${gwt + .map((item) => { + const [, word, rest] = item.match(GWT); + return `
${escapeHtml(word[0].toUpperCase() + word.slice(1).toLowerCase())}
${renderInline(ctx, rest, baseDir)}
`; + }) + .join('')}
` + : ''; + const foot = meta.length ? `
${meta.map((item) => `${renderInline(ctx, item, baseDir)}`).join('')}
` : ''; + const more = extra.join('\n').trim() ? `
${renderMarkdown(ctx, extra.join('\n'), file, 3)}
` : ''; + return `

${id} ${renderInline(ctx, name, baseDir)}

${dl}${foot}${more}
`; + }); + return `

${renderInline(ctx, title.replace(/^Rules:\s*/i, '').replace(/^\w/, (c) => c.toUpperCase()), baseDir)} ${cards.length} rule${cards.length === 1 ? '' : 's'}

${lead ? renderMarkdown(ctx, lead, file, 2) : ''}${cards.length ? `
${cards.join('')}
` : ''}`; +} + +// ---------- Other sections ---------- + +// Collapsible section per file (entities, topics). function renderFiles(ctx, files) { return files .map((file) => { const text = read(ctx.kb, file); const title = text.match(/^#\s+(.*)$/m)?.[1] ?? basename(file, '.md'); const id = ctx.fileIds.get(file); - const attr = id && !ctx.emitted.has(id) ? ` id="${id}"` : ''; - if (attr) ctx.emitted.add(id); const body = renderMarkdown(ctx, text.replace(/^#\s+.*$/m, ''), file, 1); const [, titleId, titleRest] = title.match(/^([A-Z]+-\d{3})\b\s*(.*)$/) || []; const label = titleId ? `${titleId} ${renderInline(ctx, titleRest, dirname(file))}` : renderInline(ctx, title, dirname(file)); - return `${label}
${body}
`; + return `
${label}
${body}
`; }) .join('\n'); } -function section(id, number, title, lede, html) { - const eyebrow = String(number).padStart(2, '0'); - return `

${eyebrow}

${escapeHtml(title)}

${lede ? `

${escapeHtml(lede)}

` : ''}${html}
`; -} - function markdownSection(ctx, file, headingShift = 1) { const text = read(ctx.kb, file); return text ? renderMarkdown(ctx, text.replace(/^#\s+.*$/m, ''), file, headingShift) : ''; } -// The part of STATUS.md under one "## Heading", rendered. -function statusPart(ctx, status, name) { - const match = status.match(new RegExp(`^##\\s+${name}\\s*$([\\s\\S]*?)(?=^##\\s|$(?![\\s\\S]))`, 'm')); - return match ? renderMarkdown(ctx, match[1], 'STATUS.md') : ''; +// The raw part of STATUS.md under one "## Heading". +function statusRaw(status, name) { + return status.match(new RegExp(`^##\\s+${name}\\s*$([\\s\\S]*?)(?=^##\\s|$(?![\\s\\S]))`, 'm'))?.[1] ?? ''; } function countCoverage(kb) { @@ -294,105 +651,219 @@ function countCoverage(kb) { return counts; } -function evidenceGallery(ctx) { - const index = new Map(); - for (const line of read(ctx.kb, 'evidence/index.csv').split('\n').slice(1)) { - const cells = line.split(','); - if (cells[0]) index.set(cells[0].trim(), cells.slice(4, -1).join(',').replace(/^"|"$/g, '').trim()); +// Color tokens as swatches: any table row in the tokens file that holds a color value. +function swatches(ctx) { + const text = stripComments(read(ctx.kb, 'design/tokens.md')); + const out = []; + for (const line of text.split('\n')) { + if (!line.trim().startsWith('|')) continue; + const cells = splitRow(line); + const colors = cells.filter((cell) => /^(#[0-9a-f]{3,8}|rgba?\([\d\s.,%]+\))$/i.test(cell)); + if (!colors.length) continue; + const variable = cells.find((cell) => /^`?--/.test(cell))?.replace(/`/g, ''); + out.push(`
${colors.map((color) => ``).join('')}${escapeHtml(cells[0])}${escapeHtml(colors.join(' / '))}${variable ? `${escapeHtml(variable)}` : ''}
`); } + return out.length ? `

Color

${out.join('')}
` : ''; +} + +function evidenceGallery(ctx) { const items = [...ctx.evidence.entries()].sort(([a], [b]) => a.localeCompare(b)); - return items - .map(([id, file]) => { - const caption = `
${id} ${escapeHtml(index.get(id) || basename(file))}
`; - const attr = ctx.emitted.has(id) ? '' : ` id="${id}"`; - ctx.emitted.add(id); - if (MIME[extname(file).toLowerCase()]) { - if (ctx.embedded.has(file)) return `${caption}

Shown in the text above.

`; - return `${escapeHtml(index.get(id) || id)}${caption}`; - } + const images = []; + const files = []; + for (const [id, file] of items) { + const caption = evCaption(ctx, id); + if (isImage(file)) { + images.push(`
${pic(ctx, file, `${id}: ${caption}`, 'thumb')}
${id} ${escapeHtml(caption)}
`); + } else { const size = statSync(join(ctx.kb, file)).size; - return `${caption}

${escapeHtml(file)}, ${(size / 1024).toFixed(1)} KB, in the knowledge base folder.

`; - }) - .join('\n'); + files.push(`${id}${escapeHtml(caption)}${escapeHtml(file)}${(size / 1024).toFixed(1)} KB`); + } + } + return [ + images.length ? `
${images.join('')}
` : '', + files.length ? `

Captures that are not images

Network shapes, script output and notes, kept in the knowledge base folder.

${files.join('')}
IDShowsFileSize
` : '', + ].join(''); +} + +function section(id, number, title, lede, html) { + return `

${String(number).padStart(2, '0')}${escapeHtml(title)}

${lede ? `

${escapeHtml(lede)}

` : ''}${html}
`; } +const DARK = `color-scheme:dark;--paper:#14171b;--ink:#eef0f3;--ink-2:#b5bcc6;--muted:#8f96a1;--rule:#2b3037;--rule-strong:#4a515b;--grid:#22262c; +--accent:#7ab8e0;--accent-ink:#0d1a24;--accent-wash:#1a2733;--good-ink:#4cc14c;--good-wash:#15291a;--caution-ink:#f5c75a;--caution-wash:#2e2610;--crit:#f07272;--crit-wash:#2f1a1a;--blue-ink:#8cc0ea;--blue-wash:#172a3a;--shot-bg:#0b0b0b`; + const CSS = ` -:root{--bg:#f6f8fa;--surface:#ffffff;--fg:#14202b;--muted:#5c6a77;--line:#e1e6eb;--soft:#f1f4f7;--accent:#1f5f8b;--accent-soft:#e5eef6; ---hero:#0f1a24;--hero-fg:#eef3f7;--hero-muted:#9fb0bf; ---red:#b0413e;--amber:#9a650f;--blue:#1f6aa5;--green:#2e7d5b;--gray:#5c6a77; ---red-bg:#f8e3e2;--amber-bg:#fbf0dc;--blue-bg:#e3eef8;--green-bg:#e2f2e9;--gray-bg:#eceff2;color-scheme:light} -@media (prefers-color-scheme:dark){:root{--bg:#0c1116;--surface:#131b23;--fg:#e4eaf0;--muted:#98a6b3;--line:#25313c;--soft:#18222c;--accent:#7fb3d9;--accent-soft:#182a39; ---hero:#121e2a;--hero-fg:#eef3f7;--hero-muted:#93a5b5; ---red:#e48a86;--amber:#e2b25a;--blue:#8cc0ea;--green:#6cc59a;--gray:#98a6b3; ---red-bg:#3a1d1c;--amber-bg:#33280f;--blue-bg:#172a3a;--green-bg:#173327;--gray-bg:#222c35;color-scheme:dark}} -*{box-sizing:border-box} -body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.65 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;-webkit-font-smoothing:antialiased} -.hero{background:var(--hero);color:var(--hero-fg);border-bottom:1px solid var(--line)} -.hero-inner{max-width:1240px;margin:0 auto;padding:52px max(16px,env(safe-area-inset-right)) 40px max(16px,env(safe-area-inset-left))} -.kicker{font:600 12.5px/1 ui-monospace,SFMono-Regular,Menlo,monospace;letter-spacing:.12em;text-transform:uppercase;color:var(--hero-muted);margin:0 0 16px} -.hero h1{font-size:clamp(34px,5vw,52px);line-height:1.05;letter-spacing:-.02em;margin:0 0 8px} -.subtitle{font-size:19px;color:var(--hero-muted);margin:0 0 22px;max-width:62ch} -.meta{display:flex;flex-wrap:wrap;gap:8px}.meta span{border:1px solid rgba(255,255,255,.2);border-radius:999px;padding:3px 12px;font-size:13.5px} -.layout{display:grid;grid-template-columns:220px minmax(0,1fr);gap:48px;max-width:1240px;margin:0 auto;padding:32px max(16px,env(safe-area-inset-right)) 0 max(16px,env(safe-area-inset-left))} -nav{position:sticky;top:20px;align-self:start;font-size:14px;max-height:calc(100vh - 40px);overflow:auto} -nav a{display:flex;gap:10px;color:var(--muted);text-decoration:none;padding:5px 8px;border-radius:6px}nav a:hover{background:var(--surface);color:var(--fg)} -nav a b{font:500 12px/1.9 ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--accent);min-width:18px} -main{min-width:0;padding-bottom:40px} -.notice{display:grid;grid-template-columns:1fr 1fr;gap:14px} -.notice>div{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:16px 18px} -.notice h3{margin:0 0 6px;font-size:15px}.notice p{margin:0;color:var(--muted);font-size:14.5px} -.notice .agent{border:1px dashed var(--accent)}.notice .agent h3{color:var(--accent)} -section{margin:60px 0 0;scroll-margin-top:16px} -.eyebrow{font:600 13px/1 ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--accent);margin:0 0 8px} -h2{font-size:28px;line-height:1.2;letter-spacing:-.01em;margin:0 0 6px} -.lede{color:var(--muted);font-size:17px;margin:0 0 22px;max-width:68ch} -h3{font-size:19px;line-height:1.3;margin:30px 0 10px}h4{font-size:16.5px;margin:18px 0 8px}h5,h6{font-size:15px;margin:14px 0 6px} -p,li{max-width:80ch}ul,ol{padding-left:22px}li{margin:3px 0} -a{color:var(--accent);text-underline-offset:2px} -code{font:13.5px ui-monospace,SFMono-Regular,Menlo,monospace;background:var(--soft);padding:1px 5px;border-radius:4px;overflow-wrap:anywhere} -pre{background:var(--surface);border:1px solid var(--line);padding:14px 16px;border-radius:10px;overflow-x:auto}pre code{background:none;padding:0} -.id{display:inline-block;font:600 12.5px/1.65 ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--accent);background:var(--accent-soft);border-radius:6px;padding:0 7px;text-decoration:none;vertical-align:2px;margin-right:4px} -.table{overflow-x:auto;margin:14px 0;background:var(--surface);border:1px solid var(--line);border-radius:10px} -table{border-collapse:collapse;width:100%;font-size:14.5px} -th{font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--muted);text-align:left;padding:10px 12px;border-bottom:1px solid var(--line);background:var(--soft)} -td{text-align:left;vertical-align:top;padding:9px 12px;border-bottom:1px solid var(--line)}tr:last-child td{border-bottom:0} -img{max-width:100%;height:auto;border:1px solid var(--line);border-radius:8px;margin:10px 0;display:block} -.card{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:2px 20px 10px;margin:12px 0;box-shadow:0 1px 2px rgba(15,26,36,.04)} -.card>h3:first-child,.card>h4:first-child,.card>h5:first-child{margin-top:16px} -.card.sev-red{border-left:4px solid var(--red)}.card.sev-amber{border-left:4px solid var(--amber)}.card.sev-blue{border-left:4px solid var(--blue)}.card.sev-gray,.card.sev-green{border-left:4px solid var(--gray)} -.panel{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:4px 22px;margin:0 0 14px} -.tiles{display:grid;grid-template-columns:repeat(auto-fill,minmax(140px,1fr));gap:10px;margin:14px 0} -.tiles div{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:14px 16px} -.tiles strong{display:block;font-size:30px;line-height:1.1;letter-spacing:-.02em;font-variant-numeric:tabular-nums;color:var(--accent)}.tiles span{color:var(--muted);font-size:13.5px} -.coverage{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:14px 18px;margin:0 0 14px} -.coverage h3{margin:0 0 10px;font-size:15px}.bar{display:flex;height:12px;border-radius:999px;overflow:hidden;background:var(--soft)} -.seg.green,.dot.green{background:var(--green)}.seg.blue,.dot.blue{background:var(--blue)}.seg.amber,.dot.amber{background:var(--amber)}.seg.gray,.dot.gray{background:var(--gray-bg)} -.legend{display:flex;flex-wrap:wrap;gap:16px;color:var(--muted);font-size:13.5px;margin:10px 0 0}.dot{display:inline-block;width:9px;height:9px;border-radius:50%;margin-right:6px;border:1px solid var(--line)} -.decide{background:var(--amber-bg);border:1px solid var(--line);border-left:4px solid var(--amber);border-radius:12px;padding:4px 22px;margin:14px 0} -.decide h3{margin-top:14px;font-size:16px} +:root{color-scheme:light;--paper:#fff;--ink:#16191d;--ink-2:#4b5260;--muted:#5d646f;--rule:#dde1e6;--rule-strong:#aab1bb;--grid:#eceef1; +--accent:#1a5276;--accent-ink:#fff;--accent-wash:#eef4f9;--good-ink:#006300;--good-wash:#e6f4e6;--caution:#fab219;--caution-ink:#7a5300;--caution-wash:#fff6df; +--crit:#c23434;--crit-wash:#fbe7e7;--blue-ink:#1f5f99;--blue-wash:#e6eff8;--shot-bg:#111} +@media (prefers-color-scheme:dark){:root:not([data-theme="light"]){${DARK}}} +:root[data-theme="dark"]{${DARK}} +*,*::before,*::after{box-sizing:border-box} +html{background:var(--paper);scroll-behavior:smooth;-webkit-text-size-adjust:100%} +@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}} +body{margin:0;background:var(--paper);color:var(--ink);font-family:'IBM Plex Sans',system-ui,-apple-system,'Segoe UI',sans-serif;font-size:17px;line-height:1.55;-webkit-font-smoothing:antialiased;overflow-x:hidden} +.wrap{max-width:1040px;margin:0 auto;padding:0 16px} +a{color:var(--accent);text-decoration-thickness:1px;text-underline-offset:3px} +a:focus-visible,button:focus-visible,summary:focus-visible,.pic:focus-visible{outline:2px solid var(--accent);outline-offset:2px} +p{margin:0 0 .8rem;max-width:68ch} +code,.op,.id,.sn,.n,.evl{font-family:'IBM Plex Mono',ui-monospace,monospace} +code{font-size:.86em;background:var(--grid);padding:.05em .3em;border-radius:3px;overflow-wrap:anywhere} +.num{font-variant-numeric:tabular-nums}.dim{color:var(--muted);font-weight:400}.small{font-size:14px} +.topbar{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:14px 0;font-size:14px;color:var(--muted)} +.theme-toggle{background:transparent;border:1px solid var(--rule-strong);color:var(--ink-2);font:inherit;font-size:13px;padding:4px 10px;border-radius:4px;cursor:pointer;flex:none} +.hero{padding:18px 0 0} +.kicker{font:600 12.5px/1 'IBM Plex Mono',ui-monospace,monospace;letter-spacing:.1em;text-transform:uppercase;color:var(--accent);margin:0 0 14px} +.hero h1{font-size:clamp(30px,5vw,46px);line-height:1.1;font-weight:600;letter-spacing:-.01em;margin:0 0 12px;max-width:22ch} +.lede{font-size:19px;color:var(--ink-2);margin:0;max-width:62ch} +.chips{display:flex;gap:8px;overflow-x:auto;padding:22px 0 4px;scrollbar-width:thin} +.chips a{flex:none;font-size:14px;color:var(--ink-2);text-decoration:none;border:1px solid var(--rule);border-radius:999px;padding:4px 12px} +.chips a:hover{border-color:var(--accent);color:var(--accent)} +.answer{border-left:4px solid var(--accent);padding:4px 0 4px 18px;margin:26px 0 0} +.answer .big{font-size:clamp(21px,2.6vw,26px);line-height:1.3;font-weight:600;margin:0 0 12px;max-width:44ch} +.answer ol{margin:0;padding-left:1.2em;max-width:78ch}.answer li{margin-bottom:6px;color:var(--ink-2)}.answer li b{color:var(--ink)} +.tiles{display:grid;grid-template-columns:repeat(4,1fr);gap:1px;background:var(--rule);border-top:1px solid var(--rule);border-bottom:1px solid var(--rule);margin:26px 0 0} +.tile{padding:16px 18px;background:var(--paper)}.tile .v{font-size:30px;font-weight:600;line-height:1.1;font-variant-numeric:tabular-nums}.tile .l{font-size:15px;color:var(--ink-2);margin-top:4px} +section{padding:56px 0 8px;scroll-margin-top:8px} +h2{font-size:27px;line-height:1.2;font-weight:600;margin:0 0 6px;letter-spacing:-.005em} +h2 .sn{color:var(--accent);font-variant-numeric:tabular-nums;margin-right:12px;font-size:.8em} +.sub{color:var(--ink-2);margin:0 0 22px;max-width:70ch} +h3{font-size:19px;line-height:1.3;font-weight:600;margin:28px 0 8px}h4{font-size:16.5px;margin:18px 0 6px}h5,h6{font-size:15px;margin:14px 0 6px} +ul,ol{padding-left:22px}li{margin:3px 0;max-width:78ch} +figure{margin:0;min-width:0}figcaption{font-size:14px;color:var(--muted);margin-top:8px;max-width:80ch}figcaption b{color:var(--ink);font-weight:600} +.evl{font-size:12.5px;font-weight:500;text-decoration:none;margin-right:4px} +.shot{background:var(--shot-bg);border:1px solid var(--rule-strong);border-radius:8px;padding:8px;display:flex;align-items:center;justify-content:center;overflow:hidden} +.shot.t{padding:0;aspect-ratio:16/10}.shot.empty{background:var(--grid);border-style:dashed;color:var(--muted);font-size:13px;text-align:center;padding:10px} +.shot.inl{display:flex;margin:12px 0} +.pic{display:block;width:100%;background-repeat:no-repeat;background-size:contain;background-position:center;cursor:zoom-in;border-radius:4px} +.pic.thumb{height:100%;background-size:cover;background-position:top left;border-radius:0} +.g2,.g3,.g4{display:grid;gap:20px}.g2{grid-template-columns:1fr 1fr}.g3{grid-template-columns:repeat(3,minmax(0,1fr))}.g4{grid-template-columns:repeat(4,minmax(0,1fr));gap:16px} +.g4 figcaption{font-size:13px} +.note,.caution,.crit{border-radius:6px;padding:12px 14px;margin:18px 0;font-size:15px;max-width:82ch;display:grid;grid-template-columns:auto minmax(0,1fr);gap:10px;align-items:start} +.note{background:var(--accent-wash)}.caution{background:var(--caution-wash);border-left:4px solid var(--caution)}.crit{background:var(--crit-wash);border-left:4px solid var(--crit)} +.ic{font-weight:700;width:22px;height:22px;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;font-size:13px} +.note .ic{background:var(--accent);color:var(--accent-ink)}.caution .ic{background:var(--caution);color:#1a1a1a}.crit .ic{background:var(--crit);color:#fff} +.note p,.caution p,.crit p{margin:0 0 4px}.note h3,.caution h3,.crit h3{margin:0 0 4px;font-size:15.5px}.h{display:block;margin-bottom:2px} +.note ul,.caution ul,.crit ul{margin:4px 0 0;padding-left:18px} +.tbl-wrap{overflow-x:auto;margin:14px 0 0} +table{border-collapse:collapse;width:100%;font-size:15px} +th{text-align:left;font-weight:600;font-size:13px;color:var(--muted);border-bottom:1.5px solid var(--ink);padding:6px 12px 6px 0;vertical-align:bottom} +td{border-bottom:1px solid var(--rule);padding:8px 12px 8px 0;vertical-align:top} +td.k{font-weight:600;white-space:nowrap}td a{text-decoration:none;white-space:nowrap} +td code,.op{display:inline-block;font-size:12.5px;border:1px solid var(--rule-strong);border-radius:4px;padding:0 6px;margin:0 4px 2px 0;line-height:20px;background:none;overflow-wrap:anywhere} +.op a{text-decoration:none} +.id{display:inline-block;font-size:12.5px;font-weight:600;color:var(--accent);background:var(--accent-wash);border-radius:4px;padding:0 7px;text-decoration:none;line-height:22px;flex:none} .chip{display:inline-block;font-size:12.5px;font-weight:600;padding:1px 9px;border-radius:999px;white-space:nowrap} -.chip.red{color:var(--red);background:var(--red-bg)}.chip.amber{color:var(--amber);background:var(--amber-bg)}.chip.blue{color:var(--blue);background:var(--blue-bg)}.chip.green{color:var(--green);background:var(--green-bg)}.chip.gray{color:var(--gray);background:var(--gray-bg)} -.swatch{display:inline-block;width:14px;height:14px;border-radius:3px;border:1px solid var(--line);vertical-align:-2px;margin-right:6px} -details{background:var(--surface);border:1px solid var(--line);border-radius:12px;margin:10px 0;padding:0 20px} -summary{cursor:pointer;list-style:none;padding:14px 0;font-weight:600;display:flex;align-items:center;gap:6px}summary::-webkit-details-marker{display:none} -summary::before{content:"";flex:none;width:7px;height:7px;border-right:2px solid var(--muted);border-bottom:2px solid var(--muted);transform:rotate(-45deg);margin-right:8px;transition:transform .15s} -details[open]>summary::before{transform:rotate(45deg)}details[open]>summary{border-bottom:1px solid var(--line)} -.file{padding:4px 0 14px}blockquote{margin:12px 0;padding:6px 14px;border-left:3px solid var(--line);color:var(--muted)} -.gallery{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:14px} -figure{margin:0;background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:10px 12px}figure img{margin:0 0 8px} -figcaption{font-size:13.5px;color:var(--muted)}.note{color:var(--muted);font-size:13.5px;margin:4px 0}.missing{color:var(--red)} -footer{color:var(--muted);font-size:13.5px;margin:64px 0 0;border-top:1px solid var(--line);padding-top:16px} -@media (max-width:900px){.layout{grid-template-columns:1fr;gap:20px}nav{position:static;max-height:none;display:flex;flex-wrap:wrap;gap:2px}.notice{grid-template-columns:1fr}} -@media (prefers-reduced-motion:reduce){summary::before{transition:none}} -@media print{nav{display:none}.layout{display:block}.hero{background:none;color:inherit}.card,details,.table{box-shadow:none}} +.chip.red{color:var(--crit);background:var(--crit-wash)}.chip.amber{color:var(--caution-ink);background:var(--caution-wash)}.chip.blue{color:var(--blue-ink);background:var(--blue-wash)}.chip.green{color:var(--good-ink);background:var(--good-wash)}.chip.gray{color:var(--muted);background:var(--grid)} +.swatch{display:inline-block;width:14px;height:14px;border-radius:3px;border:1px solid var(--rule-strong);vertical-align:-2px;margin-right:6px} +pre{margin:12px 0;overflow-x:auto;font-family:'IBM Plex Mono',ui-monospace,monospace;font-size:13px;line-height:1.55;background:var(--grid);padding:14px 16px;border-radius:6px}pre code{background:none;padding:0;font-size:inherit} +blockquote{margin:12px 0;padding:6px 14px;border-left:3px solid var(--rule-strong);color:var(--ink-2)} +hr{border:0;border-top:1px solid var(--rule);margin:24px 0} +.missing{color:var(--crit)} +.obj{border-top:1.5px solid var(--ink);padding:22px 0 34px;scroll-margin-top:8px;min-width:0} +.oh{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin:0 0 8px}.oh h3{margin:0;font-size:22px;line-height:1.25} +.kvs{display:flex;flex-wrap:wrap;gap:6px 16px;font-size:14px;color:var(--ink-2);margin:0 0 14px;max-width:none} +.kv{display:inline-flex;gap:6px;align-items:baseline;min-width:0;overflow-wrap:anywhere}.kv b{font-weight:500;color:var(--muted);font-size:12px;text-transform:uppercase;letter-spacing:.04em;flex:none} +.cap-h{font-size:13px;font-weight:600;color:var(--muted);text-transform:uppercase;letter-spacing:.06em;margin:24px 0 10px} +.cap-h .dim{text-transform:none;letter-spacing:0} +.anat{display:grid;grid-template-columns:minmax(0,1.5fr) minmax(0,1fr);gap:26px;align-items:start;margin-top:16px}.anat>figure{position:sticky;top:12px}.anat .cap-h{margin-top:0} +.lg{list-style:none;margin:0;padding:0;font-size:15px} +.lg li{display:grid;grid-template-columns:34px minmax(0,1fr);gap:8px;padding:7px 0;border-top:1px solid var(--rule);margin:0}.lg li:first-child{border-top:0} +.n{justify-self:start;min-width:22px;height:22px;padding:0 6px;border-radius:11px;background:var(--ink);color:var(--paper);font-size:11px;font-weight:600;display:inline-flex;align-items:center;justify-content:center;flex:none} +.lg b{font-weight:600;margin-right:6px}.lg div>span:not(.op){display:block;color:var(--ink-2);font-size:14px} +.states{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:1px;background:var(--rule);border:1px solid var(--rule);border-radius:8px;overflow:hidden} +.stt{background:var(--paper);padding:10px 12px;font-size:14px;min-width:0}.stt b{display:block;font-size:14.5px}.stt span{color:var(--ink-2)} +.unseen{font-size:14px;color:var(--muted);margin:10px 0 0;max-width:none}.unseen b{color:var(--ink-2);font-weight:500} +details.notes,details.file{border:1px solid var(--rule);border-radius:8px;margin:16px 0 0;background:var(--paper);min-width:0} +details>summary{cursor:pointer;list-style:none;padding:10px 14px;font-weight:600;font-size:15px;display:flex;align-items:baseline;gap:8px;flex-wrap:wrap} +details>summary::-webkit-details-marker{display:none} +details>summary::before{content:"+";font-family:'IBM Plex Mono',monospace;color:var(--accent);width:12px;flex:none} +details[open]>summary::before{content:"\\2212"}details[open]>summary{border-bottom:1px solid var(--rule)} +details>summary .dim{font-size:13px;font-weight:400} +.nb{padding:4px 14px 14px;min-width:0}.nb>h4:first-child,.nb>h3:first-child{margin-top:12px} +details.more{margin-top:12px}details.more>summary{padding:6px 0;color:var(--accent)}details.more[open]>summary{border:0;margin-bottom:12px} +details.file{margin:10px 0} +.comps{display:grid;grid-template-columns:1fr 1fr;gap:0 32px} +.comp{display:flex;flex-direction:column;gap:14px}.comp .oh h3{font-size:19px}.comp .kvs{margin-bottom:4px} +.lbl{font-size:12.5px;font-weight:600;color:var(--muted);text-transform:uppercase;letter-spacing:.06em;margin:12px 0 6px}.lbl .dim{text-transform:none;letter-spacing:0} +.pills{display:flex;flex-wrap:wrap;gap:6px} +.pill{font-size:13px;border:1px solid var(--accent);color:var(--accent);background:var(--accent-wash);border-radius:999px;padding:1px 10px;cursor:help} +.pill.off{border:1px dashed var(--rule-strong);color:var(--muted);background:none} +.beh{margin:0;padding-left:18px;font-size:15px;color:var(--ink-2)} +.hint{margin:14px 0 0}.flow{list-style:none;margin:12px 0 0;padding:4px 2px 14px;display:flex;gap:34px;overflow-x:auto;scroll-snap-type:x proximity} +.st{flex:1 0 200px;max-width:300px;margin:0;position:relative;scroll-snap-align:start;display:flex;flex-direction:column;border:1px solid var(--rule);border-radius:8px;background:var(--paper);max-width:none} +.st .shot{border:0;border-bottom:1px solid var(--rule);border-radius:8px 8px 0 0} +.st+.st::before{content:"";position:absolute;left:-28px;top:72px;width:20px;height:2px;background:var(--accent)} +.st+.st::after{content:"";position:absolute;left:-12px;top:68px;border:5px solid transparent;border-left:7px solid var(--accent)} +.sb{padding:10px 12px 12px;font-size:14px;display:flex;flex-direction:column;gap:4px;flex:1} +.sh{display:flex;align-items:center;gap:8px}.sh .n{background:var(--accent);color:var(--accent-ink)}.sh .op{margin:0} +.sb b{font-size:15px;line-height:1.35}.sb>span{color:var(--ink-2)}.sb .evs{font-family:'IBM Plex Mono',monospace;font-size:11.5px;color:var(--muted);margin-top:auto;padding-top:6px} +.branches{display:grid;gap:8px} +.brn{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:start;border:1px solid var(--rule);border-left:3px solid var(--caution);border-radius:6px;padding:9px 12px;font-size:15px} +.brn.off{border-left-style:dashed;border-left-color:var(--rule-strong)} +.brn .at{font-family:'IBM Plex Mono',monospace;font-size:12px;color:var(--caution-ink);background:var(--caution-wash);border-radius:4px;padding:1px 6px;white-space:nowrap} +.brn .arrow{display:inline-block;width:18px;height:2px;background:var(--rule-strong);margin:0 10px 0 8px;vertical-align:5px;position:relative} +.brn .arrow::after{content:"";position:absolute;right:-6px;top:-4px;border:5px solid transparent;border-left:6px solid var(--rule-strong)} +.brn div>span:last-child{color:var(--ink-2)} +.grp-h{display:flex;gap:10px;align-items:baseline;flex-wrap:wrap;border-bottom:1.5px solid var(--ink);padding-bottom:6px;margin-top:36px} +.grp-h .dim{font-size:14px} +.rules{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:14px;align-items:start} +.rule{border:1px solid var(--rule);border-radius:8px;padding:14px 16px;min-width:0;scroll-margin-top:8px} +.rule h4{margin:0 0 10px;font-size:15.5px;line-height:1.4}.rule h4 .id{margin-right:4px} +.gwt{display:grid;grid-template-columns:auto minmax(0,1fr);gap:6px 10px;margin:0;font-size:14.5px} +.gwt dt{font-family:'IBM Plex Mono',monospace;font-size:11px;font-weight:600;text-transform:uppercase;color:var(--accent);background:var(--accent-wash);border-radius:4px;padding:1px 6px;height:fit-content;margin-top:2px;text-align:center} +.gwt dd{margin:0;color:var(--ink-2);min-width:0} +.rf{display:flex;flex-wrap:wrap;gap:4px 14px;margin-top:10px;padding-top:8px;border-top:1px dashed var(--rule);font-size:13px;color:var(--muted)} +.rx{font-size:14px} +.card{border:1px solid var(--rule);border-left:4px solid var(--rule-strong);border-radius:6px;padding:2px 18px 8px;margin:14px 0} +.card>h3:first-child,.card>h4:first-child,.card>h5:first-child{margin-top:14px} +.card.sev-red{border-left-color:var(--crit)}.card.sev-amber{border-left-color:var(--caution)}.card.sev-blue{border-left-color:var(--blue-ink)} +.card ul{font-size:15px} +.cov{margin:22px 0 0}.cov .bar{display:flex;height:12px;border-radius:999px;overflow:hidden;background:var(--grid)} +.seg.green,.dot.green{background:var(--good-ink)}.seg.blue,.dot.blue{background:var(--blue-ink)}.seg.amber,.dot.amber{background:var(--caution)}.seg.gray,.dot.gray{background:var(--rule-strong)} +.legend{display:flex;flex-wrap:wrap;gap:16px;color:var(--muted);font-size:14px;margin:10px 0 0}.dot{display:inline-block;width:10px;height:10px;border-radius:50%;margin-right:6px} +.sws{display:grid;grid-template-columns:repeat(auto-fill,minmax(170px,1fr));gap:12px;margin:8px 0 20px} +.sw{display:grid;grid-template-columns:repeat(var(--n,1),1fr);font-size:13.5px;border:1px solid var(--rule);border-radius:8px;overflow:hidden;min-width:0} +.sw i{display:block;height:44px;border-bottom:1px solid var(--rule)}.sw b,.sw span,.sw code{grid-column:1/-1;padding:0 10px;overflow-wrap:anywhere}.sw b{padding-top:8px;font-weight:600}.sw span{color:var(--muted);font-size:12.5px} +.sw code{background:none;font-size:11.5px;color:var(--muted);padding-bottom:8px} +dialog#lb{border:0;padding:0;background:transparent;max-width:96vw;max-height:94vh} +dialog#lb::backdrop{background:rgba(0,0,0,.85)} +dialog#lb img{display:block;max-width:96vw;max-height:86vh;width:auto;height:auto;border-radius:4px;cursor:zoom-out} +dialog#lb p{color:#eee;font-size:14px;margin:8px 0 0;max-width:none} +footer{color:var(--muted);font-size:14px;margin:64px 0 32px;border-top:1px solid var(--rule);padding-top:16px} +@media (max-width:880px){.anat,.comps,.rules,.g2{grid-template-columns:1fr}.g3{grid-template-columns:1fr 1fr}.g4{grid-template-columns:repeat(3,minmax(0,1fr))}} +@media (max-width:760px){.tiles{grid-template-columns:1fr 1fr}} +@media (max-width:600px){body{font-size:16px}.g3,.g4{grid-template-columns:1fr 1fr;gap:12px}.g3 figcaption{font-size:12.5px}.anat>figure{position:static} +.flow{flex-direction:column;gap:30px;overflow:visible;padding:4px 0 0}.st{flex:none} +.st+.st::before{left:calc(50% - 1px);top:-26px;width:2px;height:16px}.st+.st::after{left:calc(50% - 5px);top:-11px;border:5px solid transparent;border-top:7px solid var(--accent)} +.hint{display:none}.brn{grid-template-columns:1fr}.brn .at{justify-self:start}.oh h3{font-size:20px}} +@media print{.topbar,.chips,dialog{display:none}.pic{-webkit-print-color-adjust:exact;print-color-adjust:exact}} `; +const HEAD_SCRIPT = "(function(){try{var t=localStorage.getItem('res-theme');if(t==='dark'||t==='light')document.documentElement.setAttribute('data-theme',t)}catch(e){}})();"; +const BODY_SCRIPT = `(function(){var b=document.getElementById('themeBtn');function cur(){var a=document.documentElement.getAttribute('data-theme');if(a)return a;return window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light'} +function lab(){b.textContent=cur()==='dark'?'Light theme':'Dark theme'}b.addEventListener('click',function(){var n=cur()==='dark'?'light':'dark';document.documentElement.setAttribute('data-theme',n);try{localStorage.setItem('res-theme',n)}catch(e){}lab()});lab(); +var d=document.getElementById('lb'),im=d.querySelector('img'),cp=d.querySelector('p');function open(el){if(!d.showModal)return;var m=getComputedStyle(el).backgroundImage.match(/url\\(["']?([\\s\\S]*?)["']?\\)/);if(!m)return;im.src=m[1];im.alt=el.getAttribute('aria-label')||'';var f=el.closest('figure');var c=f&&f.querySelector('figcaption');cp.textContent=c?c.textContent:im.alt;d.showModal()} +document.addEventListener('click',function(e){var el=e.target.closest&&e.target.closest('.pic');if(el)open(el)});document.addEventListener('keydown',function(e){if((e.key==='Enter'||e.key===' ')&&e.target.classList&&e.target.classList.contains('pic')){e.preventDefault();open(e.target)}});d.addEventListener('click',function(){d.close()})})();`; + const AGENT_COMMENT = ''; +// "Covered: a, b" becomes "Covered. a, b". +function answerItem(ctx, item) { + const [, label, rest] = item.match(/^([A-Z][\w ]{1,24}):\s+(.*)$/) || []; + return label ? `
  • ${escapeHtml(label)}. ${renderInline(ctx, rest, '.')}
  • ` : `
  • ${renderInline(ctx, item, '.')}
  • `; +} + +function charterValue(kb, key) { + const row = parseTable(stripComments(read(kb, '00-charter.md'))).rows.find((cells) => cells[0]?.toLowerCase() === key); + return row?.[1] || ''; +} + +const plural = (count, word) => `${count} ${word}${count === 1 ? '' : 's'}`; + export function buildReport(kbDir) { const kb = resolve(kbDir); const ctx = makeContext(kb); - const status = read(kb, 'STATUS.md'); + const status = stripComments(read(kb, 'STATUS.md')); const product = status.match(/^# Status:\s*(.+)$/m)?.[1]?.trim() || basename(kb); const updated = status.match(/^Updated:\s*([\d-]+)/m)?.[1]; const phase = status.match(/Phase:\s*([^·\n]+)/)?.[1]?.trim(); @@ -401,25 +872,59 @@ export function buildReport(kbDir) { const measured = COVERAGE.slice(0, 4).reduce((sum, value) => sum + coverage[value], 0); const count = (pattern, text) => (text.match(pattern) || []).length; const rulesFiles = listDir(kb, 'rules', (name) => name.endsWith('.md')); - const numbers = [ - [count(/^\|\s*F-\d{3}/gm, stripComments(read(kb, 'inventory/features.md'))), 'features'], - [listDir(kb, 'screens', (name) => /^S-\d{3}/.test(name)).length, 'screens'], - [listDir(kb, 'components', (name) => /^C-\d{3}/.test(name)).length, 'components'], - [count(/^#{1,6}\s+R-\d{3}/gm, stripComments(rulesFiles.map((file) => read(kb, file)).join('\n'))), 'business rules'], - [listDir(kb, 'data-model/entities', (name) => /^E-\d{3}/.test(name)).length, 'entities'], - [count(/^#{1,6}\s+BR-\d{3}/gm, stripComments(read(kb, 'clone/barriers.md'))), 'launch items'], - [ctx.evidence.size, 'evidence files'], - ]; - const parts = ['done', 'partial', 'blocked', 'todo']; + const screenFiles = listDir(kb, 'screens', (name) => name.endsWith('.md')); + const componentFiles = listDir(kb, 'components', (name) => name.endsWith('.md')); + const flowFiles = listDir(kb, 'flows', (name) => name.endsWith('.md')); + const n = { + features: count(/^\|\s*F-\d{3}/gm, stripComments(read(kb, 'inventory/features.md'))), + screens: screenFiles.filter((file) => /\/S-\d{3}/.test(file)).length, + components: componentFiles.filter((file) => /\/C-\d{3}/.test(file)).length, + flows: flowFiles.filter((file) => /\/FL-\d{3}/.test(file)).length, + rules: count(/^#{1,6}\s+R-\d{3}/gm, stripComments(rulesFiles.map((file) => read(kb, file)).join('\n'))), + entities: listDir(kb, 'data-model/entities', (name) => /^E-\d{3}/.test(name)).length, + barriers: count(/^#{1,6}\s+BR-\d{3}/gm, stripComments(read(kb, 'clone/barriers.md'))), + evidence: ctx.evidence.size, + }; + const tiles = [ + [n.features, 'features'], + [n.screens, 'screens'], + [n.components, 'components'], + [n.flows, 'user flows'], + [n.rules, 'business rules'], + [n.entities, 'entities'], + [n.barriers, 'launch items'], + [n.evidence, 'evidence files'], + ].filter(([value]) => value > 0); + + // Hero: one line that says what the study holds, then the summary as numbered findings. + const held = [n.screens && plural(n.screens, 'screen'), n.components && plural(n.components, 'component'), n.flows && plural(n.flows, 'user flow'), n.rules && plural(n.rules, 'business rule')].filter(Boolean); + const big = held.length + ? `${product}, documented from the outside: ${held.length > 1 ? `${held.slice(0, -1).join(', ')} and ${held.at(-1)}` : held[0]}, each tied to evidence.` + : `${product}, documented from the outside.`; + const summaryItems = listItems(statusRaw(status, 'Summary')); + const answer = `

    ${escapeHtml(big)}

    ${summaryItems.length ? `
      ${summaryItems.map((item) => answerItem(ctx, item)).join('')}
    ` : ''}
    `; + const lede = charterValue(kb, 'goal') || `How ${product} works, how to rebuild it, and what to prepare before launch.`; + + const statusParts = ['done', 'partial', 'blocked', 'todo']; const coverageHtml = measured - ? `

    How far the study went: ${Math.round((coverage.done / measured) * 100)}% done

    ${parts + ? `

    How far the study went: ${Math.round((coverage.done / measured) * 100)}% of checks done

    ${statusParts .filter((value) => coverage[value]) .map((value) => ``) - .join('')}

    ${parts.map((value) => `${coverage[value]} ${value}`).join('')}

    ` + .join('')}

    ${statusParts.map((value) => `${coverage[value]} ${value}`).join('')}

    ` : ''; - const summary = statusPart(ctx, status, 'Summary'); - const decide = statusPart(ctx, status, 'Needs human'); - const blocked = statusPart(ctx, status, 'Blocked'); + const isNone = (raw) => !raw.trim() || /^\s*[-*]\s*None\.?\s*$/i.test(raw.trim()); + const decideRaw = statusRaw(status, 'Needs human'); + const blockedRaw = statusRaw(status, 'Blocked'); + const nextRaw = statusRaw(status, 'Next actions'); + const callout = (kind, icon, title, raw) => `
    ${icon}
    ${title}${renderMarkdown(ctx, raw, 'STATUS.md')}
    `; + const overview = [ + '
    i

    If you are an AI agent

    Do not build from this page: it is generated for people. Open BUILD.md in this folder and follow its read order. The Markdown files next to it are the source of truth.

    ', + isNone(decideRaw) ? '' : callout('caution', '!', 'Needs your decision', decideRaw), + isNone(blockedRaw) ? '' : callout('crit', '×', 'Blocked', blockedRaw), + coverageHtml, + isNone(nextRaw) ? '' : `

    Next actions

    ${renderMarkdown(ctx, nextRaw, 'STATUS.md')}`, + ].join(''); + const about = [ ['00-charter.md', 'Charter'], ['glossary.md', 'Glossary'], @@ -428,26 +933,25 @@ export function buildReport(kbDir) { .map(([file, title]) => (read(kb, file) ? `

    ${title}

    ${markdownSection(ctx, file, 2)}` : '')) .join('\n'); - // Order: understand the product, then how to build it, then what to prepare before launch. + // Screens, components and flows are rendered as designed views; the rest as text. const sections = [ - ['summary', 'Overview', 'What was studied, how far the study went, and what needs your decision.', - `${summary ? `
    ${summary}
    ` : ''}
    ${numbers.map(([n, label]) => `
    ${n}${label}
    `).join('')}
    ${coverageHtml}${decide && !/^\s*