Linear

Last updated: May 5, 2025

Linear is our nervous system. If work isn't here, it isn't real. Use this playbook to keep projects visible, momentum high, and clients delighted.


Shorthand Principles

Choose the practice on the left whenever you hesitate.

ArrowWhy It Wins
Public > PrivateShared context lets cross‑functional teams swarm a problem and solve it faster.
Done > In ProgressShipped value—not effort—earns trust and revenue. Close loops or slice scope until you can finish.
Single Source of TruthLinear holds every committed task. Docs and Slack may link to tickets—never replace them.

Operating Principles

Public > Private

Open issues and projects whenever legal and HR allow.

Done > In Progress

Solve problems, don't accumulate work‑in‑progress. Cancel or split anything that stalls.

Single Source of Truth

Store scope, owner, status, and estimate in Linear. Nowhere else.

One Issue → One Branch

Create a branch from the ticket name. Linear links the PR and sets "In Review" automatically.

Cycles = Shippable

Work in one‑week cycles (Mon–Sun). Include only deliverables that can hit production. Keep discovery, workshops, and hand‑off docs outside cycles.

Alephic Intelligence

Our AI triage partner:

  • Auto‑file issues, slotting them into the right Team + Project.
  • Suggest assignees and Fibonacci estimates (0–8). Edit freely—the model learns.

Initiative Updates

Every Friday, post two sentences: what changed and what you need.


Foundational Requirements

RuleReasonDo / Don't
ProjectsOne per client SOW or major internal initiative; defines scope, timeline, and done.Do mirror the SOW title. Don't mix multiple SOWs in one project.
Teams & Sub‑TeamsMirror the consulting org (e.g., Client‑Acme › Data‑Science). Shared workflows reduce admin.Do nest. Don't create misc teams, Alephic is for internal work.
Roadmap ≠ LinearShape work in the roadmap workspace, then execute in Linear.Don't store "someday" ideas in Linear.

Labels

Most labels are optional and only used for filtering, except the following:

  • Bug — Fixes an error that breaks expected behaviour. This tag typically has SLA implications.
  • Tech Debt — When tech debt is identified but can't be addressed right away (this helps filter out our backlogs)

Use optional secondary tags (e.g., api, ios) for filtering.


Cycles

Linear creates weekly cycles automatically. Load next week by Friday; plan up to two cycles ahead. Track Strategy, Fine‑Tune, and Transfer deliverables as non‑cycled issues in the same project.


Workflow

Triage → Backlog → Todo → In Progress → In Review → Done → Cancelled

  • Triage — Every new issue lands here. Assess quickly, then move it.
  • Backlog — Committed, sized, and prioritised work.
  • Todo — Ready for a maker to pick up (assigned to a cycle).
  • In Progress — Branch open; work underway.
  • In Review — PR open or design ready for critique.
  • Done — Code merged or design signed off.
  • Cancelled — Superseded or obsolete; link to any successor.

Estimation

We map Fibonacci points to rough days to keep planning simple.

PointsEffort
0< ½ day
11 day
22 days
33 days
55 days
88 days — split bigger work

Dependency Management

Track interconnected workflows with structured dependencies to ensure nothing blocks delivery.

Setting Dependencies

Use Linear's relationship types for clarity:

  • Blocks → This issue prevents progress on the dependent issue
  • Relates to → Issues share context but don't block each other
  • Duplicates → Issue captures the same work (close the duplicate)

Alephic Intelligence

Our AI system enhances Linear project management through intelligent categorization and research capabilities.

How the System Works

Confidence Scoring

  • The system provides confidence scores (0-100) with each categorization and estimate:
    • Above 80% confidence for project categorization: Automatically assigns issues
    • Above 75% confidence for estimates: Automatically applies story points
    • Below threshold: Provides reasoning but requires human review
    • Project descriptions use 50% confidence threshold for automatic updates

Research Capability

  • System identifies when additional research would benefit the assignee
  • Automatically conducts research using multiple tools:
    • Web search via Google and Perplexity
    • PDF content extraction
    • URL scraping
    • Company information lookup
  • Posts structured research findings as comments directly on issues
  • Includes confidence rating and source citations for transparency

Project Context Generation

  • Automatically detects new Linear projects lacking descriptions
  • Generates comprehensive descriptions using internal data sources:
    • Database queries for related information
    • Vector search for semantic context
    • Structured data from company warehouse
  • Updates Linear projects directly when confidence exceeds threshold

Hygiene Checklist

WhenAction
MondayCheck status of active tasks, update comments. Identify the most important work.
FridayUpdate status, add notes to initiatives as necessary.

Why This Playbook Matters

  1. We capture every committed task. Nothing slips through the cracks.
  2. Alephic Intelligence keeps boards tidy. Less admin, more progress.
  3. Projects & Teams enforce consultancy discipline. Clear scope and ownership from day one.

Live these rules and we'll ship remarkable client value—every single week.


Changelog

  • May 5, 2025: Initial Linear playbook with workflows, estimation guidelines, and AI capabilities.