learnship 2.0.5 → 2.0.7

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "learnship",
3
3
  "description": "Agentic engineering done right — 49 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system. Works with Claude Code, Windsurf, Cursor, Gemini CLI, OpenCode, and Codex.",
4
- "version": "2.0.5",
4
+ "version": "2.0.7",
5
5
  "author": {
6
6
  "name": "Favio Vazquez",
7
7
  "email": "favio.vazquezp@gmail.com"
@@ -2,7 +2,7 @@
2
2
  "name": "learnship",
3
3
  "displayName": "learnship",
4
4
  "description": "Agentic engineering done right — 49 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system.",
5
- "version": "2.0.5",
5
+ "version": "2.0.7",
6
6
  "logo": "assets/logo.png",
7
7
  "author": {
8
8
  "name": "Favio Vazquez",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "learnship",
3
- "version": "2.0.5",
3
+ "version": "2.0.7",
4
4
  "description": "Agentic engineering done right — 49 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system.",
5
5
  "author": "Favio Vazquez",
6
6
  "homepage": "https://faviovazquez.github.io/learnship/",
@@ -184,6 +184,14 @@ Ask: "Ready to start the next milestone?"
184
184
  - Create new ROADMAP.md
185
185
  - **Not yet** → stop here
186
186
 
187
+ ```
188
+ 💡 Not sure what to build next? Run `/ideate` for codebase-grounded idea generation —
189
+ it scans TODOs, test gaps, and hotspots to surface high-impact improvements.
190
+
191
+ 💡 For ambitious next milestones, consider `/challenge` to stress-test the scope
192
+ before committing.
193
+ ```
194
+
187
195
  ---
188
196
 
189
197
  ## Learning Checkpoint
@@ -9,9 +9,24 @@ Codebase-grounded divergent ideation. Scans the actual codebase for hotspots, TO
9
9
  **Usage:** `ideate` — open-ended ideation on the current project
10
10
  **Usage:** `ideate [focus]` — focused ideation on a specific area, concept, or constraint
11
11
 
12
- **Sequencing:** Run before `/new-project`, `/challenge`, or `/discuss-milestone` to discover what's worth building.
12
+ **Sequencing:** Run between milestones — after `/complete-milestone`, before `/discuss-milestone` or `/new-milestone`. Requires an existing project with `AGENTS.md` and `.planning/`.
13
13
 
14
- ## Step 1: Scope
14
+ > **No project yet?** Use `@agentic-learning brainstorm [idea]` for pure divergent thinking without codebase grounding. `/ideate` is for projects that already have code to scan.
15
+
16
+ ## Step 1: Pre-flight Check
17
+
18
+ Verify the project has artifacts to ground ideation on:
19
+
20
+ ```bash
21
+ ls AGENTS.md 2>/dev/null && ls .planning/PROJECT.md 2>/dev/null
22
+ ```
23
+
24
+ **If neither exists:** Stop. Tell the user:
25
+ > `/ideate` needs an existing project to scan. Run `/new-project` first to set up the project, or use `@agentic-learning brainstorm [idea]` for pre-project ideation.
26
+
27
+ **If project exists:** Continue.
28
+
29
+ ## Step 2: Scope
15
30
 
16
31
  If a focus argument was provided, use it as the ideation lens.
17
32
  If no argument, proceed with open-ended ideation.
@@ -23,7 +38,7 @@ find .planning/ -name "*-ideation-*.md" -mtime -30 2>/dev/null
23
38
 
24
39
  If recent ideation exists, ask: "Found recent ideation work. Resume from it, or start fresh?"
25
40
 
26
- ## Step 2: Codebase Scan
41
+ ## Step 3: Codebase Scan
27
42
 
28
43
  Gather grounding context before generating ideas:
29
44
 
@@ -55,7 +70,7 @@ ls .planning/solutions/ 2>/dev/null
55
70
  cat .planning/KNOWLEDGE.md 2>/dev/null
56
71
  ```
57
72
 
58
- ## Step 3: Divergent Ideation
73
+ ## Step 4: Divergent Ideation
59
74
 
60
75
  Read `parallelization` from `.planning/config.json` (defaults to `false`).
61
76
 
@@ -94,7 +109,7 @@ Task(
94
109
 
95
110
  Using `@./agents/ideation-agent.md`, generate 15-25 ideas across all four frames sequentially.
96
111
 
97
- ## Step 4: Deduplicate & Filter
112
+ ## Step 5: Deduplicate & Filter
98
113
 
99
114
  Merge ideas from all frames:
100
115
 
@@ -106,7 +121,7 @@ Merge ideas from all frames:
106
121
  - Would a senior engineer roll their eyes at this suggestion?
107
122
  3. **Eliminate** weak ideas with explicit reasons
108
123
 
109
- ## Step 5: Rank Survivors
124
+ ## Step 6: Rank Survivors
110
125
 
111
126
  Rank the surviving ideas (target: 5-7) by:
112
127
 
@@ -117,7 +132,7 @@ Rank the surviving ideas (target: 5-7) by:
117
132
  | **Feasibility** — can this be done in a reasonable scope? | Medium |
118
133
  | **Compounding** — does this make future work easier? | Medium |
119
134
 
120
- ## Step 6: Present Results
135
+ ## Step 7: Present Results
121
136
 
122
137
  ```
123
138
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -155,13 +170,13 @@ git add .planning/[DATE]-ideation-[slug].md
155
170
  git commit -m "docs: ideation — [focus or 'open-ended'] ([N] survivors)"
156
171
  ```
157
172
 
158
- ## Step 7: Route to Action
173
+ ## Step 8: Route to Action
159
174
 
160
175
  Present the "What's next?" options using the platform's blocking question tool:
161
176
 
162
177
  - **Deep-dive an idea** → expand on the selected idea with more detail
163
- - **Start a new project** → feed selected idea into `/new-project`
164
178
  - **Add to current milestone** → feed into `/add-phase`
179
+ - **Start a new milestone** → feed into `/discuss-milestone` then `/new-milestone`
165
180
  - **Challenge an idea** → run `/challenge [idea]` to stress-test it
166
181
  - **Save and return later** → already saved to `.planning/`
167
182
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "learnship",
3
- "version": "2.0.5",
3
+ "version": "2.0.7",
4
4
  "description": "Learn as you build. Build with intent. — A multi-platform agentic engineering system for Windsurf, Claude Code, Cursor, OpenCode, Gemini CLI, and Codex: spec-driven workflows, integrated learning, and production-grade design.",
5
5
  "keywords": [
6
6
  "agentic",