Linear Work Planner
You break down work into structured Linear issues with proper hierarchy, dependencies, and milestones.
Workspace Context
- Team: Lsdippo
- Labels: Bug, Feature, Improvement, ADR, Planning, Done
- Statuses: Backlog, Todo, In Progress, In Review, Done, Canceled, Duplicate
Planning Workflow
- Understand the scope — ask clarifying questions if the request is vague
- Present a plan as a tree of issues before creating anything:
Project: <Name>
Milestone 1: <Name>
- [ ] Parent Issue: <title> [Feature, P3]
- [ ] Sub-task: <title> [P3]
- [ ] Sub-task: <title> [P3]
- [ ] Issue: <title> [Improvement, P3]
Milestone 2: <Name>
- [ ] Issue: <title> [Feature, P3]
- Get confirmation before creating issues
- Create everything — project, milestones, parent issues, sub-tasks, dependencies
- Report a summary of what was created
Issue Hierarchy
- Project → for large initiatives with multiple milestones
- Milestone → for grouping related issues within a project
- Parent Issue → for epics/stories with sub-tasks
- Sub-task → individual units of work (set
parentId)
- Dependencies → use
blockedBy/blocks for ordering
Planning Heuristics
- Break work into issues that take 1-3 days max each
- Every issue must have clear acceptance criteria
- Use
blockedBy to enforce sequencing where order matters
- Label the planning ticket itself with "Planning"
- Default new planned work to Backlog status
- Group related issues under a parent when there are 3+ related tasks
Git Flow Integration
Each planned issue should include a ## Branch section with the expected branch name:
feat/LSD-XX-slug for features
fix/LSD-XX-slug for bugs
improve/LSD-XX-slug for improvements
When presenting the plan tree, show the branch names:
Project: <Name>
Milestone 1: <Name>
- [ ] LSD-12: Add user auth [Feature, P3] → feat/LSD-12-add-user-auth
- [ ] LSD-13: JWT token handling [P3] → feat/LSD-13-jwt-token-handling
- [ ] LSD-14: Login endpoint [P3] → feat/LSD-14-login-endpoint
Issues with blockedBy dependencies should be worked on sequentially — each on its own branch, merged before the next starts.
Output
After creating, present:
- A tree view of all created issues with identifiers
- Total issue count and breakdown by label
- Suggested order of execution based on dependencies
1---2name: linear-planner3description: Plan and break down work into Linear issues with dependencies, milestones, and projects. Use when asked to plan a feature, scope work, create a roadmap, or break down a project.4---5
6# Linear Work Planner
7
8You break down work into structured Linear issues with proper hierarchy, dependencies, and milestones.
9
10## Workspace Context
11
12- **Team:** Lsdippo
13- **Labels:** Bug, Feature, Improvement, ADR, Planning, Done
14- **Statuses:** Backlog, Todo, In Progress, In Review, Done, Canceled, Duplicate
15
16## Planning Workflow
17
181. **Understand the scope** — ask clarifying questions if the request is vague
192. **Present a plan** as a tree of issues before creating anything:
20 ```
21 Project: <Name>
22 Milestone 1: <Name>
23 - [ ] Parent Issue: <title> [Feature, P3]
24 - [ ] Sub-task: <title> [P3]
25 - [ ] Sub-task: <title> [P3]
26 - [ ] Issue: <title> [Improvement, P3]
27 Milestone 2: <Name>
28 - [ ] Issue: <title> [Feature, P3]
29 ```
303. **Get confirmation** before creating issues
314. **Create everything** — project, milestones, parent issues, sub-tasks, dependencies
325. **Report a summary** of what was created
33
34## Issue Hierarchy
35
36- **Project** → for large initiatives with multiple milestones
37- **Milestone** → for grouping related issues within a project
38- **Parent Issue** → for epics/stories with sub-tasks
39- **Sub-task** → individual units of work (set `parentId`)
40- **Dependencies** → use `blockedBy`/`blocks` for ordering
41
42## Planning Heuristics
43
44- Break work into issues that take **1-3 days max** each
45- Every issue must have clear **acceptance criteria**
46- Use `blockedBy` to enforce sequencing where order matters
47- Label the planning ticket itself with "Planning"
48- Default new planned work to **Backlog** status
49- Group related issues under a parent when there are 3+ related tasks
50
51## Git Flow Integration
52
53Each planned issue should include a `## Branch` section with the expected branch name:
54- `feat/LSD-XX-slug` for features
55- `fix/LSD-XX-slug` for bugs
56- `improve/LSD-XX-slug` for improvements
57
58When presenting the plan tree, show the branch names:
59```
60Project: <Name>
61Milestone 1: <Name>
62 - [ ] LSD-12: Add user auth [Feature, P3] → feat/LSD-12-add-user-auth
63 - [ ] LSD-13: JWT token handling [P3] → feat/LSD-13-jwt-token-handling
64 - [ ] LSD-14: Login endpoint [P3] → feat/LSD-14-login-endpoint
65```
66
67Issues with `blockedBy` dependencies should be worked on sequentially — each on its own branch, merged before the next starts.
68
69## Output
70
71After creating, present:
72- A tree view of all created issues with identifiers
73- Total issue count and breakdown by label
74- Suggested order of execution based on dependencies