Explore

Linear Sample Walkthrough

Purpose

Capture exactly what the Redfin gym UI shows, organized so an AI can generate tasks. No guessing, no screenshots— please write the fields, options, and constraints as text.

Deliverable (Google Doc)

Tool Overview

Environment (region, snapshot counts, sample tables)

Actions (with limitations) (nav path + fields + constraints)

UI Description (UI mapping) (nav path + field tables)/Feature Availability table (for anything missing/disabled)

1. Tool Overview

Linear is a fast issue and project tracker. Core entities: Issues, Projects, Cycles (sprints), Views, Labels, Workflow States, Teams, Users, Roadmap Initiatives. Collaboration features include comments, @mentions, attachments, and PR linking.

⁠

⁠

2. Environment

Organization/Workspace: Acme-Main

Users (role): alex (Admin), sarah (Designer), mike (Engineer), lisa (Engineer), priya (QA), tom (Maintainer), emily (Engineer), david (Eng Manager)

Teams → Projects:

Product & Web → Website Revamp, Growth Experiments

Mobile → iOS App Launch

Platform → Backend Migration

Workflow States (ordered): Backlog → In Progress → Review → Done → Canceled

Priorities: Urgent, High, Medium, Low

Labels (name, color): Bug (#D0021B), Feature (#2F80ED), Design (#9B51E0), Backend (#F2994A), Frontend (#27AE60), QA (#FF69B4), Research (#F2C94C), Chore (#56CCF2), Accessibility (#27AE60), Low Priority (#95A5A6)

Cycles: Cycle 32 (Aug 4–29, 2025), Cycle 31 (Closed), Cycle 30 (Closed)

Roadmap Initiatives: Q3 Site Speed (Website Revamp), Services Split (Backend Migration)

Integrations: GitHub (PR linking), Slack (project alerts) — note: may be disabled in gym

Notifications (defaults): Mentions ON; Email digests Daily

Labels:

⁠

⁠

Roadmaps:

⁠

⁠

⁠

3. Actions (with limitations)

State-changing operations. Give Navigation Path, required fields, and limits.

Create Issue — Path: Issues → + New Issue → Fill fields → Create

Limits: Title required; Due Date cannot be past; attachments ≤ 25 MB

⁠

⁠

⁠

Change Status (Drag & Drop) — Path: Project → Board → drag card Backlog → In Progress

Limits: Only moves within the visible board; some columns may not accept drops in the gym

Comment on Issue — Path: Issue Detail → Comments

Limits: @mentions must target workspace users; attachment size ≤ 25 MB

⁠

⁠

Set/Change Due Date — Path: Issues list or Issue Detail → Due Date

Limits: Must be future date

Filters/Search/Sort/Save View — Path: Issues

Filters: Project, Priority, Label, Assignee, Status

Sort options (must click): Due Date ↑/↓, Priority ↑/↓, Created ↑/↓, Updated ↑/↓

Search scope: Title + Description (not comments)

⁠

⁠

⁠

Create Label / Workflow State — Path: Labels → + New Label / Workflow → + Add State

Limits: May require Admin; in gym, creation could be disabled

Create Cycle — Path: Cycles → + New Cycle

Limits: Dates cannot overlap existing cycle

Integrations (Slack/GitHub) — Path: Project → Settings → Integrations → Slack/GitHub

Limits (gym): Often Disabled. Capture error text verbatim.

4. UI Description (UI mapping)

Create Issue (modal) Navigation Path: Issues → + New Issue

Issue Table

Issue Table

Field Label

Type

Mandatory

Allowed Inputs

Options / Constraints

Title

Text input

Yes

Any UTF-8 text

≤ 200 chars

Description

Text area (Markdown)

Markdown

Links/code supported

Assignee

Dropdown

alex, sarah, mike, lisa, priya…

Workspace users only

Labels

Multi-select dropdown

Bug, Feature, Design, Backend…

Multiple selection allowed

Priority

Dropdown

Urgent, High, Medium, Low

Default = Medium

Project

Dropdown

Website Revamp, iOS App, Backend…

Active projects only

Due Date

Date picker

YYYY-MM-DD

Future only

There are no rows in this table

⁠

Issues — Filters & Sort Navigation Path: Issues

Filters: Project, Priority, Label, Assignee, Status (show applied chips)

Sort (click to expand): Due Date ↑/↓, Priority ↑/↓, Created ↑/↓, Updated ↑/↓

Search bar: keyword over Title + Description

Board (Kanban) Navigation Path: Project → Board

Columns: Backlog, In Progress, Review, Done, Canceled

Card anatomy: Title, Key, Assignee avatar, Labels, Priority, Due date

Behavior: Drag between columns updates Status; reorder within column

Feature Availability (Disabled/Errors Log) — example row

Feature Area: Integrations

Feature Name: Slack push alerts

Navigation Path: Project → Settings → Integrations → Slack

UI Element: Connect Slack

Attempted Action: Connect Slack to channel

Observed Behavior: Modal opens; API call fails

Error Text (verbatim): Error: endpoint /slack/connect not implemented

Status: Disabled

Repro Steps: (1) Project Settings (2) Integrations (3) Slack → Connect (4) Observe error

Expected Behavior: OAuth to Slack + channel toggle

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.