@dabble/linear-cli 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,11 +15,11 @@ Help the developer wrap up their work on the current Linear issue.
15
15
  2. **Summarize the work** by checking:
16
16
  - `git log --oneline <base>..HEAD` to see commits
17
17
  - `git diff --stat <base>..HEAD` to see files changed
18
- 3. **Ask what they want to do** using AskUserQuestion:
19
- - Close the issue in Linear
20
- - Create a PR first
21
- - Add final notes to the issue
22
- - Just clean up (worktree only)
18
+ 3. **Ask what they want to do:**
19
+ - Create PR and close
20
+ - Close issue (no PR)
21
+ - Add notes and close
22
+ - Just clean up (keep issue open)
23
23
 
24
24
  ## After Selection
25
25
 
@@ -50,11 +50,7 @@ You've made 3 commits on ISSUE-12: Add caching layer
50
50
  - src/cache.ts (new file, 45 lines)
51
51
  - src/api.ts (modified, +12 -3)
52
52
 
53
- What would you like to do?
54
- 1. Create PR and close issue
55
- 2. Close issue (no PR)
56
- 3. Add notes and close
57
- 4. Just clean up worktree (don't close)
53
+ [Presents options above]
58
54
  ```
59
55
 
60
56
  ## Notes
@@ -21,47 +21,11 @@ Skip straight to starting work on that issue (see "Starting Work on an Issue" be
21
21
 
22
22
  ### Presenting Options
23
23
 
24
- Always present a numbered list with these rules:
25
- - Show up to **5 issues maximum** (yours are already sorted first by the CLI)
26
- - If more than 5 issues exist, note how many more after the list
27
- - **Always** include "Product planning" as the final option
28
-
29
- ### Format
30
-
31
- ```
32
- Here's what's ready to work on:
33
-
34
- 1. ISSUE-5: Add caching layer [Backlog] (assigned to you)
35
- 2. ISSUE-8: Fix login timeout [Backlog]
36
- 3. ISSUE-12: Update API docs [Backlog]
37
- 4. ISSUE-18: Do Something Else [Backlog]
38
- 5. ISSUE-29: Another thing [Backlog]
39
- ... and 7 more unblocked issues
40
- 6. Product planning - brainstorm features, review backlog, plan next phase
41
-
42
- Which would you like to work on?
43
- ```
44
-
45
- ### If NO unblocked issues:
46
-
47
- ```
48
- No unblocked issues at the moment.
49
-
50
- 1. Product planning - brainstorm features, review backlog, plan next phase
51
-
52
- Would you like to work on product planning?
53
- ```
54
-
55
- ### If exactly ONE issue:
56
-
57
- ```
58
- There's one issue ready to work on:
59
-
60
- 1. ISSUE-5: Add caching layer [Backlog] (assigned to you)
61
- 2. Product planning - brainstorm features, review backlog, plan next phase
62
-
63
- Which would you like?
64
- ```
24
+ Present interactive options:
25
+ - Up to **3 issues** (CLI already sorts yours first)
26
+ - **Always** include "Product planning" as an option
27
+ - If >3 issues, note how many more
28
+ - User can always type a specific issue ID
65
29
 
66
30
  ## Starting Work on an Issue
67
31
 
@@ -70,25 +34,19 @@ When the user selects an issue (or provides one directly via `/next ISSUE-12`):
70
34
  1. Run `linear issue start <id>` to assign and set In Progress
71
35
  2. Run `linear branch <id>` to create a git branch
72
36
  3. Run `linear issue show <id>` to display full context
73
- 4. **Enter plan mode** using the EnterPlanMode tool
74
-
75
- This ensures every issue starts with a proper implementation plan before writing code.
37
+ 4. **Enter plan mode** to explore the codebase and design an implementation approach
76
38
 
77
39
  ## If they choose "Product planning"
78
40
 
79
- Start a planning session by asking:
80
-
81
- "What would you like to focus on?"
82
- - Review and prioritize the backlog
41
+ Ask what they want to focus on:
42
+ - Review and prioritize backlog
83
43
  - Brainstorm new features
84
44
  - Plan the next phase
85
- - Something specific
86
45
 
87
- Then follow the product-planning skill guidelines to facilitate the session.
46
+ Then follow the product-planning skill guidelines.
88
47
 
89
48
  ## Notes
90
49
 
91
50
  - Always use long flags (--unblocked, not -u) for clarity
92
51
  - The CLI already sorts your assigned issues first
93
- - If presenting options, use the AskUserQuestion tool for a clean interface
94
52
  - The "Product planning" option ensures there's always something productive to do
@@ -24,10 +24,10 @@ Run `linear standup` to get:
24
24
  ## After Running
25
25
 
26
26
  1. Present the output from `linear standup` to the user
27
- 2. Offer to help with:
28
- - Drafting a standup message for Slack/Teams
29
- - Identifying what to work on next (suggest `/next`)
30
- - Resolving any blockers
27
+ 2. Ask what they want to do next:
28
+ - Draft standup message (for Slack/Teams)
29
+ - Find next issue (run /next)
30
+ - Resolve blockers
31
31
 
32
32
  ## Example Flow
33
33
 
@@ -52,7 +52,7 @@ Here's your standup summary:
52
52
  - 4 commits on beautiful-tech
53
53
  - PR #42 merged: ISSUE-5: Add caching layer
54
54
 
55
- Would you like me to help draft a standup message, or shall we look at what to work on next?
55
+ [Presents options above]
56
56
  ```
57
57
 
58
58
  ## Notes
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: product-planning
3
3
  description: Facilitate product thinking and structure work in Linear.
4
- allowed-tools: Bash(linear:*), Bash(curl:*), "WebFetch(domain:*)", "WebSearch"
5
4
  ---
6
5
 
7
6
  # Product Planning
@@ -28,8 +27,6 @@ linear issues --open # Active work
28
27
 
29
28
  Read `product.md` if it exists—contains product vision, brand, tech decisions, prior planning context.
30
29
 
31
- Offer web research when exploring new territory (market landscape, competitors, technical feasibility).
32
-
33
30
  ## Process
34
31
 
35
32
  ### 1. Explore the Problem
@@ -41,6 +38,8 @@ Before solutions:
41
38
  - What constraints? (time, tech, dependencies)
42
39
  - What's uncertain or risky?
43
40
 
41
+ Proactively search the web when exploring unfamiliar territory (competitors, market, technical approaches).
42
+
44
43
  ### 2. Design the Solution
45
44
 
46
45
  - What approaches exist? Tradeoffs?
@@ -51,6 +50,8 @@ Before solutions:
51
50
 
52
51
  Cut scope aggressively—except for core/differentiating features where polish and detail set you apart.
53
52
 
53
+ For technical work, explore the existing codebase first to understand patterns and architecture.
54
+
54
55
  ### 3. Structure the Work
55
56
 
56
57
  **Sizing:** XS/S/M = single issue, < 1 day. L/XL = needs breakdown.
@@ -99,6 +100,8 @@ Create the file if it doesn't exist. Keep it concise.
99
100
 
100
101
  ## Session Summary
101
102
 
103
+ Track progress throughout the session, then summarize:
104
+
102
105
  1. **Created** - Issues/milestones with IDs
103
106
  2. **Decided** - Key decisions and rationale
104
107
  3. **Deferred** - What we cut (and why)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dabble/linear-cli",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "Linear CLI with unblocked issue filtering, built for AI-assisted development",
5
5
  "type": "module",
6
6
  "bin": {