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.
|
|
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.
|
|
5
|
+
"version": "1.9.13",
|
|
6
6
|
"logo": "assets/logo.png",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Favio Vazquez",
|
package/gemini-extension.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "learnship",
|
|
3
|
-
"version": "1.9.
|
|
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
|
-
|
|
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
|
-
|
|
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 1 — Opening question:**
|
|
132
127
|
|
|
133
|
-
|
|
128
|
+
Ask: **"What do you want to build?"**
|
|
134
129
|
|
|
135
|
-
|
|
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
|
-
|
|
132
|
+
**Exchange 2 — First follow-up:**
|
|
138
133
|
|
|
139
|
-
|
|
140
|
-
-
|
|
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
|
-
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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
|
-
>
|
|
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.
|
|
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",
|