learnship 1.9.11 → 1.9.13

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 — 42 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": "1.9.11",
4
+ "version": "1.9.13",
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 — 42 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system.",
5
- "version": "1.9.11",
5
+ "version": "1.9.13",
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": "1.9.11",
3
+ "version": "1.9.13",
4
4
  "description": "Agentic engineering done right — 42 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/",
@@ -121,36 +121,67 @@ Display:
121
121
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
122
122
  ```
123
123
 
124
- Ask openly: **"What do you want to build?"**
124
+ This step is **strictly sequential**. You must complete each numbered exchange fully before moving to the next. Do not batch questions. Do not skip exchanges. Do not proceed to Step 4 until Exchange 4 is complete.
125
125
 
126
- Wait for their response. Then follow the thread each answer opens new questions. Dig into:
127
- - What excited them / what problem sparked this
128
- - What they mean by vague terms ("simple", "fast", "clean")
129
- - What it would actually look like in use
130
- - What's already decided vs. open
131
- - Who the users are and what they need
126
+ **Exchange 1Opening question:**
132
127
 
133
- Use the questioning techniques from `@./references/questioning.md`.
128
+ Ask: **"What do you want to build?"**
134
129
 
135
- When you have enough to write a clear PROJECT.md, ask:
130
+ > 🛑 STOP. Wait for the user's answer. Do not continue until you have received it. Record their answer internally as `ANSWER_1`.
136
131
 
137
- "I think I understand what you're after. Ready to create PROJECT.md, or do you want to explore more?"
132
+ **Exchange 2 First follow-up:**
138
133
 
139
- - **Create PROJECT.md** proceed
140
- - **Keep exploring** continue questions
134
+ Based on `ANSWER_1`, ask one focused follow-up. Choose the most important unknown from:
135
+ - Who are the users and what problem does this solve for them specifically?
136
+ - What does success look like — how will you know it's working?
137
+ - What's already decided vs. still open?
138
+ - What must NOT happen (constraints, anti-goals)?
141
139
 
142
- Loop until ready.
140
+ > 🛑 STOP. Wait for the user's answer. Do not continue until you have received it. Record their answer internally as `ANSWER_2`.
141
+
142
+ **Exchange 3 — Second follow-up:**
143
+
144
+ Based on `ANSWER_1` + `ANSWER_2`, ask a second focused follow-up that digs into a gap the first two answers left open. Do not repeat themes already covered.
145
+
146
+ > 🛑 STOP. Wait for the user's answer. Do not continue until you have received it. Record their answer internally as `ANSWER_3`.
147
+
148
+ **Exchange 4 — Third follow-up:**
149
+
150
+ Based on all previous answers, ask a third follow-up that clarifies scope, edge cases, or the most important implementation decision not yet surfaced.
151
+
152
+ > 🛑 STOP. Wait for the user's answer. Do not continue until you have received it. Record their answer internally as `ANSWER_4`.
153
+
154
+ **Gate check — before proceeding to Step 4:**
155
+
156
+ Verify internally: do you have `ANSWER_1`, `ANSWER_2`, `ANSWER_3`, and `ANSWER_4` recorded? If any is missing, go back and ask it. Only after all four answers are in hand may you ask:
157
+
158
+ "I think I have a solid picture of what you're building. Ready for me to write PROJECT.md, or is there more you want to cover first?"
159
+
160
+ - **Write PROJECT.md** → proceed to Step 4
161
+ - **More to cover** → continue asking follow-ups, then re-ask this gate question
162
+
163
+ Use the questioning techniques from `@./references/questioning.md` to shape the follow-up questions.
143
164
 
144
165
  ## Step 4: Write PROJECT.md
145
166
 
146
167
  Synthesize all gathered context into `.planning/PROJECT.md` using `@./templates/project.md` as the template.
147
168
 
169
+ Once written, display the full raw contents of `.planning/PROJECT.md` in your response — do not summarize it, show the whole file.
170
+
171
+ Then ask exactly this:
172
+
173
+ "That's the PROJECT.md I've written. Does this capture what you want to build? Reply **yes** to continue, or tell me what to change."
174
+
175
+ > 🛑 STOP. Wait for the user's explicit reply. Do not proceed to Step 5 under any circumstances until the user has replied to this question. A reply of "yes", "looks good", "go ahead", or any clear positive is acceptable. Silence, no reply, or a new unrelated message is NOT acceptable — ask again.
176
+
177
+ If user requests changes: update PROJECT.md, show the full file again, re-ask the confirmation question. Loop until confirmed.
178
+
148
179
  **If `commit_mode` is `auto`:**
149
180
  ```bash
150
181
  git add .planning/PROJECT.md && git commit -m "docs: initialize project"
151
182
  ```
152
183
 
153
- > **⚠ STOP do not proceed to Step 5 until you have asked the research question below and received the user's answer.**
184
+ > 🛑 STOP. Do not proceed to Step 5 until you have asked the research question below AND received the user's explicit answer to it.
154
185
 
155
186
  ## Step 5: Research Decision
156
187
 
@@ -158,7 +189,7 @@ Ask: "Research the domain ecosystem before defining requirements?"
158
189
  - **Research first** (recommended) — Discover standard stacks, expected features, architecture patterns
159
190
  - **Skip research** — I know this domain well, go straight to requirements
160
191
 
161
- > **⚠ STOP wait for the user's choice before continuing.**
192
+ > 🛑 STOP. Wait for the user's explicit choice before continuing. Do not default to "Research first" — wait for the user's actual reply.
162
193
 
163
194
  **If Research first:**
164
195
 
@@ -192,7 +223,7 @@ Files: .planning/research/
192
223
 
193
224
  ## Step 6: Define Requirements
194
225
 
195
- > **⚠ STOP do not write REQUIREMENTS.md until you have presented feature categories to the user and received their v1 selections. This is an interactive step.**
226
+ > 🛑 STOP. Do not write REQUIREMENTS.md until you have presented feature categories to the user and received their explicit v1 selections. This is a fully interactive step — you must wait for input.
196
227
 
197
228
  ```
198
229
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -216,7 +247,7 @@ Create `.planning/REQUIREMENTS.md` with v1 requirements (with REQ-IDs like `AUTH
216
247
 
217
248
  Present the full list for confirmation. If user wants adjustments, iterate.
218
249
 
219
- > **⚠ STOP wait for the user to confirm the requirements list before writing REQUIREMENTS.md or continuing.**
250
+ > 🛑 STOP. Wait for the user to explicitly confirm the requirements list before writing REQUIREMENTS.md or continuing to Step 7.
220
251
 
221
252
  **If `commit_mode` is `auto`:**
222
253
  ```bash
@@ -260,7 +291,7 @@ Ask for approval:
260
291
  - **Adjust phases** → get feedback, revise, re-present
261
292
  - **Review full file** → show raw ROADMAP.md, then re-ask
262
293
 
263
- > **⚠ STOP do not proceed to Step 8 until the user has explicitly approved the roadmap.**
294
+ > 🛑 STOP. Do not proceed to Step 8 until the user has explicitly approved the roadmap.
264
295
 
265
296
  **If `commit_mode` is `auto`:**
266
297
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "learnship",
3
- "version": "1.9.11",
3
+ "version": "1.9.13",
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",