@arsxxi/iterative-dev-workflow 1.0.0 → 1.0.1

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,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 2 Step 1: Solution Proposal"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-1 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 2 Step 1: Solution Proposal
7
19
 
8
20
  ## Purpose
@@ -21,5 +33,5 @@ Create a minimum of 5 designs that we can use to solve our problem, according to
21
33
 
22
34
  ## Trigger
23
35
  ```
24
- $ARGUMENTS = "feature-slug or description"
36
+ $ARGUMENTS = "project name"
25
37
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 2 Step 2: ATAM"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-2 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 2 Step 2: ATAM
7
19
 
8
20
  ## Purpose
@@ -23,5 +35,5 @@ If any step contains an error regarding user prompts, INFORM THE USER and DO NOT
23
35
 
24
36
  ## Trigger
25
37
  ```
26
- $ARGUMENTS = "feature-slug or description"
38
+ $ARGUMENTS = "project name"
27
39
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 2 Step 3: Quality Attribute"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-3 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 2 Step 3: Quality Attribute
7
19
 
8
20
  ## Purpose
@@ -64,5 +76,5 @@ Step 1 for more solution designs.
64
76
 
65
77
  ## Trigger
66
78
  ```
67
- $ARGUMENTS = "feature-slug or description"
79
+ $ARGUMENTS = "project name"
68
80
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 2 Step 4: High-Fidelity Design"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-4 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 2 Step 4: High-Fidelity Design
7
19
 
8
20
  ## Purpose
@@ -51,5 +63,5 @@ Once this diagram is done, stop. The User Journey diagram is a separate step -
51
63
 
52
64
  ## Trigger
53
65
  ```
54
- $ARGUMENTS = "feature-slug or description"
66
+ $ARGUMENTS = "project name"
55
67
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 2 Step 5: User Journey"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-5 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 2 Step 5: User Journey
7
19
 
8
20
  ## Purpose
@@ -18,5 +30,5 @@ Create a User Journey Diagram using Mermaid.js syntax for the chosen design from
18
30
 
19
31
  ## Trigger
20
32
  ```
21
- $ARGUMENTS = "feature-slug or description"
33
+ $ARGUMENTS = "project name"
22
34
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 3: Implementation Plan"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-3 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 3: Implementation Plan
7
19
 
8
20
  ## Purpose
@@ -29,5 +41,5 @@ not silently work around a design flaw in the plan.
29
41
 
30
42
  ## Trigger
31
43
  ```
32
- $ARGUMENTS = "feature-slug or description"
44
+ $ARGUMENTS = "project name"
33
45
  ```
@@ -1,8 +1,20 @@
1
1
  ---
2
2
  description: "Phase 4: Postmortem"
3
- argument-hint: [feature-slug or description]
3
+ argument-hint: [project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/phase-4 my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
17
+
6
18
  # Phase 4: Postmortem
7
19
 
8
20
  ## Purpose
@@ -25,5 +37,5 @@ Reflect on the iteration to improve the next one.
25
37
 
26
38
  ## Trigger
27
39
  ```
28
- $ARGUMENTS = "feature-slug or description"
40
+ $ARGUMENTS = "project name"
29
41
  ```
@@ -1,8 +1,22 @@
1
1
  ---
2
2
  description: "Session Transcript"
3
- argument-hint: [optional: feature-slug]
3
+ argument-hint: [optional: project name]
4
4
  ---
5
5
 
6
+ ## Step 0 — find which project this is for
7
+
8
+ Before anything else, figure out which project this command applies to:
9
+
10
+ 1. If you were given a project name after the slash (e.g. `/session-transcript my-project`), use it.
11
+ 2. Otherwise, look at the subfolders under `.workflow/`:
12
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
13
+ `my-project`"), so it's never a silent guess.
14
+ - Two or more folders → ask the user once which project this is for. To make the question
15
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
16
+ - No folders → fall back to the project root directory name as the project name (this is the
17
+ one case where no project is in progress yet — a transcript may legitimately exist outside
18
+ of `.workflow/`).
19
+
6
20
  # Session Transcript
7
21
 
8
22
  ## Purpose
@@ -10,7 +24,7 @@ Record this session's conversation as-is, in chronological order (who said what)
10
24
 
11
25
  ## Steps
12
26
 
13
- 1. **Determine the feature slug.** Use `$ARGUMENTS` if provided. If not provided, use the project root directory name or "session" as fallback.
27
+ 1. **Scan the project root.** Do NOT create any new folders. Determine the project root directory (where `.git/` or `package.json` or similar marker exists). Save the transcript directly in the project root.
14
28
 
15
29
  2. **Scan the project root.** Do NOT create any new folders. Determine the project root directory (where `.git/` or `package.json` or similar marker exists). Save the transcript directly in the project root.
16
30
 
@@ -49,9 +63,9 @@ Record this session's conversation as-is, in chronological order (who said what)
49
63
  ...
50
64
  ```
51
65
 
52
- Write the result to `aichat-<slug>.md` in the project root. If no slug was provided, use `aichat.md`.
66
+ Write the result to `aichat-<slug>.md` in the project root. If no project name was provided, use `aichat.md`.
53
67
 
54
68
  ## Trigger
55
69
  ```
56
- $ARGUMENTS = "optional: feature-slug"
70
+ $ARGUMENTS = "optional: project name"
57
71
  ```
@@ -1,2 +1,2 @@
1
1
  description = "Session Transcript — write verbatim chronological transcript to project root as aichat-<slug>.md"
2
- prompt = "Run Session Transcript. Determine feature slug from $ARGUMENTS if provided, otherwise use project root directory name. Scan the project root — do NOT create any new folders. Reconstruct conversation chronologically, labeled by User/Agent — verbatim, no summarization. If context is truncated, say so. If aichat-<slug>.md exists, append under new dated section instead of overwriting. Output: write to aichat-<slug>.md in project root. Reference: $ARGUMENTS"
2
+ prompt = "Run Session Transcript. Determine project name from $ARGUMENTS if provided, otherwise use project root directory name. Scan the project root — do NOT create any new folders. Reconstruct conversation chronologically, labeled by User/Agent — verbatim, no summarization. If context is truncated, say so. If aichat-<slug>.md exists, append under new dated section instead of overwriting. Output: write to aichat-<slug>.md in project root. Reference: $ARGUMENTS"
package/package.json CHANGED
@@ -1,20 +1,25 @@
1
1
  {
2
2
  "name": "@arsxxi/iterative-dev-workflow",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "A structured 4-phase iterative development workflow for AI coding agents.",
5
- "keywords": ["opencode-plugin", "opencode", "workflow", "methodology"],
5
+ "keywords": [
6
+ "opencode-plugin",
7
+ "opencode",
8
+ "workflow",
9
+ "methodology"
10
+ ],
6
11
  "license": "MIT",
7
12
  "author": {
8
13
  "name": "Clio",
9
- "url": "https://github.com/Arsxxi"
14
+ "url": "https://github.com/arsxxi/iterative-dev-workflow"
10
15
  },
11
- "homepage": "https://github.com/Arsxxi/Iterative-dev-workflow",
16
+ "homepage": "https://github.com/arsxxi/iterative-dev-workflow",
12
17
  "repository": {
13
18
  "type": "git",
14
- "url": "git+https://github.com/Arsxxi/Iterative-dev-workflow.git"
19
+ "url": "git+https://github.com/arsxxi/iterative-dev-workflow.git"
15
20
  },
16
21
  "bugs": {
17
- "url": "https://github.com/Arsxxi/Iterative-dev-workflow/issues"
22
+ "url": "https://github.com/arsxxi/iterative-dev-workflow/issues"
18
23
  },
19
24
  "main": "./.opencode/plugins/iterative-dev-workflow.mjs",
20
25
  "exports": {
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  description: "Kickoff"
3
- argument-hint: [optional: feature-slug or description]
3
+ argument-hint: [optional: project name and what we're building]
4
4
  ---
5
5
 
6
6
  ## Step 0 - figure out what we're building (do this FIRST, before anything else)
7
7
 
8
8
  Look at what was passed in: `$ARGUMENTS`
9
9
 
10
- - If it already clearly states a feature slug, a real description of what to build, AND the
10
+ - If it already clearly states a project name, a real description of what to build, AND the
11
11
  platform/stack (e.g. "React Native non-Expo", "Python backend service", "LLM agent pipeline"),
12
12
  confirm your understanding back to me in one or two sentences and proceed to the section below.
13
13
  - If any of those three are missing or vague, **stop and ask me**:
@@ -16,7 +16,7 @@ Look at what was passed in: `$ARGUMENTS`
16
16
  2. What platform/stack is this for? (e.g. mobile app - React Native/Expo/native, backend
17
17
  service, LLM/agent pipeline, web frontend, CLI tool, etc. - this changes what Phase 1's
18
18
  library/service analysis actually looks like)
19
- 3. What short slug should identify it? (used for the `.workflow/<slug>/` folder, e.g.
19
+ 3. What short project name should identify it? (used for the `.workflow/<slug>/` folder, e.g.
20
20
  `article-quality-widget`)
21
21
 
22
22
  Do not guess or invent a feature, and do not assume a default platform/stack (do not assume
@@ -61,14 +61,14 @@ I want you to do a deep, meticulous, extensive analysis of this workflow before
61
61
 
62
62
  ## Step 2 - set up tracking
63
63
 
64
- Once I've confirmed the analysis, create `.workflow/<slug>/` in this project (using the slug we
65
- settled on in Step 0) and write `.workflow/<slug>/00-context.md` containing:
64
+ Once I've confirmed the analysis, create `.workflow/<slug>/` in this project (using the project name
65
+ we settled on in Step 0) and write `.workflow/<slug>/00-context.md` containing:
66
66
 
67
67
  - Platform/stack
68
68
  - What we're building (the description from Step 0)
69
69
  - Existing Services (as I described them, or "none identified yet" if I said so)
70
70
 
71
- Every later `/phase-*` command for this slug should read this file first and use it instead
71
+ Every later `/phase-*` command for this project should read this file first and use it instead
72
72
  of assuming or hardcoding a platform or services list.
73
73
 
74
74
  ## Hard constraints (apply for the entire workflow, every phase)
@@ -86,16 +86,27 @@ one-time discussion, not a phase deliverable). End by telling me you're ready fo
86
86
 
87
87
  ## Trigger
88
88
  ```
89
- $ARGUMENTS = "optional: feature-slug or description"
89
+ $ARGUMENTS = "optional: project name and what we're building"
90
90
  ```
91
-
92
91
  ---
93
92
 
94
93
  ---
95
94
  description: "Phase 1: Analyze"
96
- argument-hint: [feature-slug or description]
95
+ argument-hint: [project name]
97
96
  ---
98
97
 
98
+ ## Step 0 — find which project this is for
99
+
100
+ Before anything else, figure out which project this command applies to:
101
+
102
+ 1. If you were given a project name after the slash (e.g. `/phase-1 my-project`), use it.
103
+ 2. Otherwise, look at the subfolders under `.workflow/`:
104
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
105
+ `my-project`"), so it's never a silent guess.
106
+ - Two or more folders → ask the user once which project this is for. To make the question
107
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
108
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
109
+
99
110
  # Phase 1: Analyze
100
111
 
101
112
  ## Purpose
@@ -120,16 +131,27 @@ Understand the task deeply before writing any code.
120
131
 
121
132
  ## Trigger
122
133
  ```
123
- $ARGUMENTS = "feature-slug or description"
134
+ $ARGUMENTS = "project name"
124
135
  ```
125
-
126
136
  ---
127
137
 
128
138
  ---
129
139
  description: "Phase 2 Step 1: Solution Proposal"
130
- argument-hint: [feature-slug or description]
140
+ argument-hint: [project name]
131
141
  ---
132
142
 
143
+ ## Step 0 — find which project this is for
144
+
145
+ Before anything else, figure out which project this command applies to:
146
+
147
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-1 my-project`), use it.
148
+ 2. Otherwise, look at the subfolders under `.workflow/`:
149
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
150
+ `my-project`"), so it's never a silent guess.
151
+ - Two or more folders → ask the user once which project this is for. To make the question
152
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
153
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
154
+
133
155
  # Phase 2 Step 1: Solution Proposal
134
156
 
135
157
  ## Purpose
@@ -148,16 +170,27 @@ Create a minimum of 5 designs that we can use to solve our problem, according to
148
170
 
149
171
  ## Trigger
150
172
  ```
151
- $ARGUMENTS = "feature-slug or description"
173
+ $ARGUMENTS = "project name"
152
174
  ```
153
-
154
175
  ---
155
176
 
156
177
  ---
157
178
  description: "Phase 2 Step 2: ATAM"
158
- argument-hint: [feature-slug or description]
179
+ argument-hint: [project name]
159
180
  ---
160
181
 
182
+ ## Step 0 — find which project this is for
183
+
184
+ Before anything else, figure out which project this command applies to:
185
+
186
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-2 my-project`), use it.
187
+ 2. Otherwise, look at the subfolders under `.workflow/`:
188
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
189
+ `my-project`"), so it's never a silent guess.
190
+ - Two or more folders → ask the user once which project this is for. To make the question
191
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
192
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
193
+
161
194
  # Phase 2 Step 2: ATAM
162
195
 
163
196
  ## Purpose
@@ -178,16 +211,27 @@ If any step contains an error regarding user prompts, INFORM THE USER and DO NOT
178
211
 
179
212
  ## Trigger
180
213
  ```
181
- $ARGUMENTS = "feature-slug or description"
214
+ $ARGUMENTS = "project name"
182
215
  ```
183
-
184
216
  ---
185
217
 
186
218
  ---
187
219
  description: "Phase 2 Step 3: Quality Attribute"
188
- argument-hint: [feature-slug or description]
220
+ argument-hint: [project name]
189
221
  ---
190
222
 
223
+ ## Step 0 — find which project this is for
224
+
225
+ Before anything else, figure out which project this command applies to:
226
+
227
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-3 my-project`), use it.
228
+ 2. Otherwise, look at the subfolders under `.workflow/`:
229
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
230
+ `my-project`"), so it's never a silent guess.
231
+ - Two or more folders → ask the user once which project this is for. To make the question
232
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
233
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
234
+
191
235
  # Phase 2 Step 3: Quality Attribute
192
236
 
193
237
  ## Purpose
@@ -249,16 +293,27 @@ Step 1 for more solution designs.
249
293
 
250
294
  ## Trigger
251
295
  ```
252
- $ARGUMENTS = "feature-slug or description"
296
+ $ARGUMENTS = "project name"
253
297
  ```
254
-
255
298
  ---
256
299
 
257
300
  ---
258
301
  description: "Phase 2 Step 4: High-Fidelity Design"
259
- argument-hint: [feature-slug or description]
302
+ argument-hint: [project name]
260
303
  ---
261
304
 
305
+ ## Step 0 — find which project this is for
306
+
307
+ Before anything else, figure out which project this command applies to:
308
+
309
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-4 my-project`), use it.
310
+ 2. Otherwise, look at the subfolders under `.workflow/`:
311
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
312
+ `my-project`"), so it's never a silent guess.
313
+ - Two or more folders → ask the user once which project this is for. To make the question
314
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
315
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
316
+
262
317
  # Phase 2 Step 4: High-Fidelity Design
263
318
 
264
319
  ## Purpose
@@ -307,16 +362,27 @@ Once this diagram is done, stop. The User Journey diagram is a separate step -
307
362
 
308
363
  ## Trigger
309
364
  ```
310
- $ARGUMENTS = "feature-slug or description"
365
+ $ARGUMENTS = "project name"
311
366
  ```
312
-
313
367
  ---
314
368
 
315
369
  ---
316
370
  description: "Phase 2 Step 5: User Journey"
317
- argument-hint: [feature-slug or description]
371
+ argument-hint: [project name]
318
372
  ---
319
373
 
374
+ ## Step 0 — find which project this is for
375
+
376
+ Before anything else, figure out which project this command applies to:
377
+
378
+ 1. If you were given a project name after the slash (e.g. `/phase-2-step-5 my-project`), use it.
379
+ 2. Otherwise, look at the subfolders under `.workflow/`:
380
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
381
+ `my-project`"), so it's never a silent guess.
382
+ - Two or more folders → ask the user once which project this is for. To make the question
383
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
384
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
385
+
320
386
  # Phase 2 Step 5: User Journey
321
387
 
322
388
  ## Purpose
@@ -332,16 +398,27 @@ Create a User Journey Diagram using Mermaid.js syntax for the chosen design from
332
398
 
333
399
  ## Trigger
334
400
  ```
335
- $ARGUMENTS = "feature-slug or description"
401
+ $ARGUMENTS = "project name"
336
402
  ```
337
-
338
403
  ---
339
404
 
340
405
  ---
341
406
  description: "Phase 3: Implementation Plan"
342
- argument-hint: [feature-slug or description]
407
+ argument-hint: [project name]
343
408
  ---
344
409
 
410
+ ## Step 0 — find which project this is for
411
+
412
+ Before anything else, figure out which project this command applies to:
413
+
414
+ 1. If you were given a project name after the slash (e.g. `/phase-3 my-project`), use it.
415
+ 2. Otherwise, look at the subfolders under `.workflow/`:
416
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
417
+ `my-project`"), so it's never a silent guess.
418
+ - Two or more folders → ask the user once which project this is for. To make the question
419
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
420
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
421
+
345
422
  # Phase 3: Implementation Plan
346
423
 
347
424
  ## Purpose
@@ -368,16 +445,27 @@ not silently work around a design flaw in the plan.
368
445
 
369
446
  ## Trigger
370
447
  ```
371
- $ARGUMENTS = "feature-slug or description"
448
+ $ARGUMENTS = "project name"
372
449
  ```
373
-
374
450
  ---
375
451
 
376
452
  ---
377
453
  description: "Phase 4: Postmortem"
378
- argument-hint: [feature-slug or description]
454
+ argument-hint: [project name]
379
455
  ---
380
456
 
457
+ ## Step 0 — find which project this is for
458
+
459
+ Before anything else, figure out which project this command applies to:
460
+
461
+ 1. If you were given a project name after the slash (e.g. `/phase-4 my-project`), use it.
462
+ 2. Otherwise, look at the subfolders under `.workflow/`:
463
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
464
+ `my-project`"), so it's never a silent guess.
465
+ - Two or more folders → ask the user once which project this is for. To make the question
466
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
467
+ - No folders → stop and tell the user to run `/kickoff` first. Don't proceed.
468
+
381
469
  # Phase 4: Postmortem
382
470
 
383
471
  ## Purpose
@@ -400,16 +488,29 @@ Reflect on the iteration to improve the next one.
400
488
 
401
489
  ## Trigger
402
490
  ```
403
- $ARGUMENTS = "feature-slug or description"
491
+ $ARGUMENTS = "project name"
404
492
  ```
405
-
406
493
  ---
407
494
 
408
495
  ---
409
496
  description: "Session Transcript"
410
- argument-hint: [optional: feature-slug]
497
+ argument-hint: [optional: project name]
411
498
  ---
412
499
 
500
+ ## Step 0 — find which project this is for
501
+
502
+ Before anything else, figure out which project this command applies to:
503
+
504
+ 1. If you were given a project name after the slash (e.g. `/session-transcript my-project`), use it.
505
+ 2. Otherwise, look at the subfolders under `.workflow/`:
506
+ - Exactly one folder → use it. Tell the user which project you picked (e.g. "Working on
507
+ `my-project`"), so it's never a silent guess.
508
+ - Two or more folders → ask the user once which project this is for. To make the question
509
+ useful, show the first line of each project's `00-context.md`, not just the folder name.
510
+ - No folders → fall back to the project root directory name as the project name (this is the
511
+ one case where no project is in progress yet — a transcript may legitimately exist outside
512
+ of `.workflow/`).
513
+
413
514
  # Session Transcript
414
515
 
415
516
  ## Purpose
@@ -417,7 +518,7 @@ Record this session's conversation as-is, in chronological order (who said what)
417
518
 
418
519
  ## Steps
419
520
 
420
- 1. **Determine the feature slug.** Use `$ARGUMENTS` if provided. If not provided, use the project root directory name or "session" as fallback.
521
+ 1. **Scan the project root.** Do NOT create any new folders. Determine the project root directory (where `.git/` or `package.json` or similar marker exists). Save the transcript directly in the project root.
421
522
 
422
523
  2. **Scan the project root.** Do NOT create any new folders. Determine the project root directory (where `.git/` or `package.json` or similar marker exists). Save the transcript directly in the project root.
423
524
 
@@ -456,9 +557,9 @@ Record this session's conversation as-is, in chronological order (who said what)
456
557
  ...
457
558
  ```
458
559
 
459
- Write the result to `aichat-<slug>.md` in the project root. If no slug was provided, use `aichat.md`.
560
+ Write the result to `aichat-<slug>.md` in the project root. If no project name was provided, use `aichat.md`.
460
561
 
461
562
  ## Trigger
462
563
  ```
463
- $ARGUMENTS = "optional: feature-slug"
464
- ```
564
+ $ARGUMENTS = "optional: project name"
565
+ ```