@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.
- package/.opencode/commands/kickoff.md +90 -0
- package/.opencode/commands/phase-1.md +43 -0
- package/.opencode/commands/phase-2-step-1.md +37 -0
- package/.opencode/commands/phase-2-step-2.md +39 -0
- package/.opencode/commands/phase-2-step-3.md +80 -0
- package/.opencode/commands/phase-2-step-4.md +67 -0
- package/.opencode/commands/phase-2-step-5.md +34 -0
- package/.opencode/commands/phase-3.md +45 -0
- package/.opencode/commands/phase-4.md +41 -0
- package/.opencode/commands/session-transcript.md +71 -0
- package/AGENTS.md +31 -447
- package/README.md +14 -11
- package/commands/kickoff.md +7 -7
- package/commands/kickoff.toml +1 -1
- package/commands/phase-1.md +14 -2
- package/commands/phase-2-step-1.md +14 -2
- package/commands/phase-2-step-2.md +14 -2
- package/commands/phase-2-step-3.md +14 -2
- package/commands/phase-2-step-4.md +14 -2
- package/commands/phase-2-step-5.md +14 -2
- package/commands/phase-3.md +14 -2
- package/commands/phase-4.md +14 -2
- package/commands/session-transcript.md +18 -4
- package/commands/session-transcript.toml +1 -1
- package/package.json +11 -6
- package/skills/workflow-methodology/SKILL.md +138 -37
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 2 Step 1: Solution Proposal"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
36
|
+
$ARGUMENTS = "project name"
|
|
25
37
|
```
|
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 2 Step 2: ATAM"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
38
|
+
$ARGUMENTS = "project name"
|
|
27
39
|
```
|
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 2 Step 3: Quality Attribute"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
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: [
|
|
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 = "
|
|
66
|
+
$ARGUMENTS = "project name"
|
|
55
67
|
```
|
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 2 Step 5: User Journey"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
33
|
+
$ARGUMENTS = "project name"
|
|
22
34
|
```
|
package/commands/phase-3.md
CHANGED
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 3: Implementation Plan"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
44
|
+
$ARGUMENTS = "project name"
|
|
33
45
|
```
|
package/commands/phase-4.md
CHANGED
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Phase 4: Postmortem"
|
|
3
|
-
argument-hint: [
|
|
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 = "
|
|
40
|
+
$ARGUMENTS = "project name"
|
|
29
41
|
```
|
|
@@ -1,8 +1,22 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: "Session Transcript"
|
|
3
|
-
argument-hint: [optional:
|
|
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. **
|
|
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
|
|
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:
|
|
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
|
|
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.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "A structured 4-phase iterative development workflow for AI coding agents.",
|
|
5
|
-
"keywords": [
|
|
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/
|
|
14
|
+
"url": "https://github.com/arsxxi/iterative-dev-workflow"
|
|
10
15
|
},
|
|
11
|
-
"homepage": "https://github.com/
|
|
16
|
+
"homepage": "https://github.com/arsxxi/iterative-dev-workflow",
|
|
12
17
|
"repository": {
|
|
13
18
|
"type": "git",
|
|
14
|
-
"url": "git+https://github.com/
|
|
19
|
+
"url": "git+https://github.com/arsxxi/iterative-dev-workflow.git"
|
|
15
20
|
},
|
|
16
21
|
"bugs": {
|
|
17
|
-
"url": "https://github.com/
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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: [
|
|
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 = "
|
|
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: [
|
|
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 = "
|
|
173
|
+
$ARGUMENTS = "project name"
|
|
152
174
|
```
|
|
153
|
-
|
|
154
175
|
---
|
|
155
176
|
|
|
156
177
|
---
|
|
157
178
|
description: "Phase 2 Step 2: ATAM"
|
|
158
|
-
argument-hint: [
|
|
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 = "
|
|
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: [
|
|
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 = "
|
|
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: [
|
|
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 = "
|
|
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: [
|
|
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 = "
|
|
401
|
+
$ARGUMENTS = "project name"
|
|
336
402
|
```
|
|
337
|
-
|
|
338
403
|
---
|
|
339
404
|
|
|
340
405
|
---
|
|
341
406
|
description: "Phase 3: Implementation Plan"
|
|
342
|
-
argument-hint: [
|
|
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 = "
|
|
448
|
+
$ARGUMENTS = "project name"
|
|
372
449
|
```
|
|
373
|
-
|
|
374
450
|
---
|
|
375
451
|
|
|
376
452
|
---
|
|
377
453
|
description: "Phase 4: Postmortem"
|
|
378
|
-
argument-hint: [
|
|
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 = "
|
|
491
|
+
$ARGUMENTS = "project name"
|
|
404
492
|
```
|
|
405
|
-
|
|
406
493
|
---
|
|
407
494
|
|
|
408
495
|
---
|
|
409
496
|
description: "Session Transcript"
|
|
410
|
-
argument-hint: [optional:
|
|
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. **
|
|
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
|
|
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:
|
|
464
|
-
```
|
|
564
|
+
$ARGUMENTS = "optional: project name"
|
|
565
|
+
```
|