@jakkrichm/create-nexus-devflow 2.0.14 → 2.0.15
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/README.md +4 -4
- package/dist/lib/update.js +1 -1
- package/dist/lib/update.js.map +1 -1
- package/package.json +1 -1
- package/template/.agents/skills/30-plan/SKILL.md +6 -6
- package/template/.agents/skills/{40-implement → 40-execute}/SKILL.md +21 -26
- package/template/.agents/skills/50-verify/SKILL.md +10 -10
- package/template/.agents/skills/60-report/SKILL.md +1 -1
- package/template/.agents/skills/70-release/SKILL.md +6 -6
- package/template/.agents/skills/agent/SKILL.md +3 -3
- package/template/.agents/skills/autopilot/SKILL.md +6 -6
- package/template/.agents/skills/brainstorm/SKILL.md +1 -1
- package/template/.agents/skills/brief/SKILL.md +1 -1
- package/template/.agents/skills/codebase-design/SKILL.md +2 -2
- package/template/.agents/skills/commit/SKILL.md +1 -1
- package/template/.agents/skills/debug/SKILL.md +2 -2
- package/template/.agents/skills/devflow/SKILL.md +5 -5
- package/template/.agents/skills/doctor/SKILL.md +1 -1
- package/template/.agents/skills/feature/SKILL.md +103 -0
- package/template/.agents/skills/fix/SKILL.md +102 -0
- package/template/.agents/skills/followup/SKILL.md +5 -5
- package/template/.agents/skills/help/SKILL.md +4 -4
- package/template/.agents/skills/insight/SKILL.md +1 -1
- package/template/.agents/skills/pr/SKILL.md +1 -1
- package/template/.agents/skills/preview/SKILL.md +1 -1
- package/template/.agents/skills/review/SKILL.md +1 -1
- package/template/.agents/skills/rollback/SKILL.md +3 -3
- package/template/.agents/skills/security-review/SKILL.md +2 -2
- package/template/.agents/skills/simplify/SKILL.md +1 -1
- package/template/.agents/skills/spec/SKILL.md +17 -84
- package/template/.agents/skills/test/SKILL.md +2 -2
- package/template/.agents/skills/try/SKILL.md +2 -2
- package/template/.claude/skills/30-plan/SKILL.md +6 -6
- package/template/.claude/skills/{40-implement → 40-execute}/SKILL.md +21 -26
- package/template/.claude/skills/50-verify/SKILL.md +10 -10
- package/template/.claude/skills/60-report/SKILL.md +1 -1
- package/template/.claude/skills/70-release/SKILL.md +6 -6
- package/template/.claude/skills/agent/SKILL.md +3 -3
- package/template/.claude/skills/autopilot/SKILL.md +6 -6
- package/template/.claude/skills/brainstorm/SKILL.md +1 -1
- package/template/.claude/skills/brief/SKILL.md +1 -1
- package/template/.claude/skills/codebase-design/SKILL.md +2 -2
- package/template/.claude/skills/commit/SKILL.md +1 -1
- package/template/.claude/skills/debug/SKILL.md +2 -2
- package/template/.claude/skills/devflow/SKILL.md +5 -5
- package/template/.claude/skills/doctor/SKILL.md +1 -1
- package/template/.claude/skills/feature/SKILL.md +103 -0
- package/template/.claude/skills/fix/SKILL.md +102 -0
- package/template/.claude/skills/followup/SKILL.md +5 -5
- package/template/.claude/skills/help/SKILL.md +4 -4
- package/template/.claude/skills/insight/SKILL.md +1 -1
- package/template/.claude/skills/pr/SKILL.md +1 -1
- package/template/.claude/skills/preview/SKILL.md +1 -1
- package/template/.claude/skills/review/SKILL.md +1 -1
- package/template/.claude/skills/rollback/SKILL.md +3 -3
- package/template/.claude/skills/security-review/SKILL.md +2 -2
- package/template/.claude/skills/simplify/SKILL.md +1 -1
- package/template/.claude/skills/spec/SKILL.md +17 -84
- package/template/.claude/skills/test/SKILL.md +2 -2
- package/template/.claude/skills/try/SKILL.md +2 -2
- package/template/AGENTS.md +11 -10
- package/template/devflow/context/ai-interaction.md +2 -2
- package/template/devflow/context/coding-standards.md +1 -1
- package/template/devflow/context/current-stage.md +3 -2
- package/template/devflow/context/project-overview.md +10 -6
- package/template/devflow/history/HISTORY.md +2 -0
- package/template/devflow/ideas.md +1 -1
- package/template/devflow/reference/running-id-contract.md +2 -2
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fix
|
|
3
|
+
description: "[Devflow] Fast-Track Fix stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living spec.md contract for bug fixes."
|
|
4
|
+
argument-hint: "{bug description, issue ID, or IDEA-xxx}"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Fast-Track: Fix (Blueprint Mode)
|
|
8
|
+
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
Fast-Track entry point combining Bug Triage, Root Cause Isolation, Specification, and Implementation Planning into one streamlined, review-gated step for **bug fixes and hotfixes**. Creates and maintains the **Single Living Spec (`spec.md`)** for the fix run.
|
|
12
|
+
|
|
13
|
+
## Invocations & Aliases
|
|
14
|
+
|
|
15
|
+
- `/fix <bug-description>` or `fix <bug-description>`: Fast-Track ad-hoc bugfix workflow
|
|
16
|
+
- `/fix IDEA-xxx`: Intake and fix a reported issue or idea from `devflow/ideas.md`
|
|
17
|
+
- `$fix`: Codex CLI invocation
|
|
18
|
+
|
|
19
|
+
## Fast-Track Mainline Workflow
|
|
20
|
+
|
|
21
|
+
```text
|
|
22
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Behavior & Contract
|
|
26
|
+
|
|
27
|
+
When invoked:
|
|
28
|
+
|
|
29
|
+
### 1. Work Identity & Issue Intake
|
|
30
|
+
1. Inspect `devflow/context/current-stage.md` and `devflow/runs/`.
|
|
31
|
+
2. **Idea / Issue Inbox Intake**: If the argument is an identifier (e.g. `IDEA-001`):
|
|
32
|
+
- Read `devflow/ideas.md` or issue notes and extract problem statement and root cause hints.
|
|
33
|
+
- In `devflow/ideas.md`, update status to `[x] Claimed ({RUNNING_ID})` and move under `## 📦 Archived / Shipped Ideas`.
|
|
34
|
+
3. Determine or allocate the sequential Running ID (e.g. `RUN-018-{slug}`).
|
|
35
|
+
4. Identify Git branch naming:
|
|
36
|
+
- `fix/{slug}-{RUNNING_ID}`
|
|
37
|
+
5. Create directory `devflow/runs/{RUNNING_ID}/`.
|
|
38
|
+
|
|
39
|
+
### 2. Generate the Single Living Spec (`spec.md`)
|
|
40
|
+
Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
|
|
41
|
+
|
|
42
|
+
```markdown
|
|
43
|
+
# 📐 [{RUNNING_ID}] {Bug/Fix Title} (Living Spec)
|
|
44
|
+
|
|
45
|
+
> **Status**: In-Progress
|
|
46
|
+
> **Track**: Fast-Track (Blueprint Mode - Fix)
|
|
47
|
+
> **Branch**: `{branch_name}`
|
|
48
|
+
> **Created Date**: {YYYY-MM-DD}
|
|
49
|
+
> **Owner**: {Contributor or Team}
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 1. Specification & Scope
|
|
54
|
+
- **Problem Statement & Reproduction**: {อาการบั๊กที่พบ ขั้นตอนที่ทำให้เกิดปัญหา หรือ Error Log}
|
|
55
|
+
- **Root Cause Analysis**: {สาเหตุที่แท้จริงของบั๊ก}
|
|
56
|
+
- **In-Scope**:
|
|
57
|
+
- {ขอบเขตการแก้ไขบั๊กและการป้องกัน regression}
|
|
58
|
+
- **Out-of-Scope**:
|
|
59
|
+
- {สิ่งที่ไม่แตะต้องหรืออยู่นอกเหนือการแก้จุดนี้}
|
|
60
|
+
- **Acceptance Criteria**:
|
|
61
|
+
- [ ] AC-1: {เงื่อนไขการแก้ปัญหาสำเร็จและพฤติกรรมที่ถูกต้อง}
|
|
62
|
+
- [ ] AC-2: {มี Regression Test ป้องกันไม่ให้เกิดซ้ำ}
|
|
63
|
+
|
|
64
|
+
## 2. Plan & Test Strategy
|
|
65
|
+
- **Files to Modify / Create**:
|
|
66
|
+
- `{path/to/file1}`: {หน้าที่ที่ต้องแก้ไข}
|
|
67
|
+
- `{path/to/test_file}`: {เทสต์เคสจำลองและป้องกันบั๊ก}
|
|
68
|
+
- **Test Decision**: `Required (TDD / Regression Test)`
|
|
69
|
+
- *Rationale*: {การแก้บั๊กต้องมี Regression Test ยืนยันเสมอ}
|
|
70
|
+
- *Planned Cases*: {เคสทดสอบจำลองบั๊ก (Red) และทดสอบหลังแก้ (Green)}
|
|
71
|
+
- **Impact & Rollback Strategy**:
|
|
72
|
+
- *Impact*: {ผลกระทบต่อโมดูลข้างเคียง}
|
|
73
|
+
- *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
|
|
74
|
+
|
|
75
|
+
## 3. Implementation Checklist
|
|
76
|
+
- [ ] Task 1.1: {เขียน Regression Test เพื่อ reproduce บั๊ก}
|
|
77
|
+
- [ ] Task 1.2: {แก้ไขโค้ดที่จุดเกิดเหตุ}
|
|
78
|
+
- [ ] Task 1.3: {รันชุดทดสอบเพื่อยืนยันว่าบั๊กหายและไม่กระทบจุดอื่น}
|
|
79
|
+
|
|
80
|
+
## 4. Implementation Record
|
|
81
|
+
- *(จะถูกบันทึกเมื่อรัน /implement)*
|
|
82
|
+
|
|
83
|
+
## 5. Verification Evidence
|
|
84
|
+
- *(จะถูกบันทึกเมื่อรัน /check)*
|
|
85
|
+
|
|
86
|
+
## 6. Release & Handoff
|
|
87
|
+
- *(จะถูกบันทึกเมื่อรัน /complete)*
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### 3. Update Workspace Status
|
|
91
|
+
Update `devflow/context/current-stage.md`:
|
|
92
|
+
- `Active Running ID`: `{RUNNING_ID}`
|
|
93
|
+
- `Current Stage`: `fix (Fast-Track -> Ready for /implement)`
|
|
94
|
+
- `Living Spec`: `devflow/runs/{RUNNING_ID}/spec.md`
|
|
95
|
+
- `Last Updated`: `{YYYY-MM-DD}`
|
|
96
|
+
|
|
97
|
+
### 4. Output Summary & Next Step
|
|
98
|
+
Report to the user:
|
|
99
|
+
- Running ID and allocated branch
|
|
100
|
+
- Summary of Scope, Reproduction, and Acceptance Criteria
|
|
101
|
+
- Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
|
|
102
|
+
- **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
|
|
@@ -36,7 +36,7 @@ Read:
|
|
|
36
36
|
- `devflow/runs/{ID}-*10-define.md`
|
|
37
37
|
- `devflow/runs/{ID}-*20-spec.md`
|
|
38
38
|
- `devflow/runs/{ID}-*30-plan.md`
|
|
39
|
-
- `devflow/runs/{ID}-*40-
|
|
39
|
+
- `devflow/runs/{ID}-*40-execute.md`
|
|
40
40
|
- `devflow/runs/{ID}-*50-verify.md` if present
|
|
41
41
|
|
|
42
42
|
### 2. Classify The Follow-Up
|
|
@@ -57,7 +57,7 @@ Append the follow-up scope directly to the relevant stage markdown files for the
|
|
|
57
57
|
|
|
58
58
|
### 4. Ask For Confirmation
|
|
59
59
|
|
|
60
|
-
After adding or proposing follow-up subtasks, ask the user to confirm before `40-
|
|
60
|
+
After adding or proposing follow-up subtasks, ask the user to confirm before `40-execute`.
|
|
61
61
|
|
|
62
62
|
## Output
|
|
63
63
|
|
|
@@ -66,18 +66,18 @@ Return:
|
|
|
66
66
|
- follow-up category
|
|
67
67
|
- new phase/subtask plan
|
|
68
68
|
- validation result
|
|
69
|
-
- next command: `40-
|
|
69
|
+
- next command: `40-execute {ID}`
|
|
70
70
|
|
|
71
71
|
## Relationship To DevFlow 2.0
|
|
72
72
|
|
|
73
73
|
- Classification: Companion command
|
|
74
74
|
- Mainline status: Not a numbered stage
|
|
75
75
|
- Typical entry points: after review, triage, or release follow-up work is identified
|
|
76
|
-
- Typical handoff targets: `10-define`, `20-spec`, `30-plan`, `40-
|
|
76
|
+
- Typical handoff targets: `10-define`, `20-spec`, `30-plan`, `40-execute`
|
|
77
77
|
|
|
78
78
|
## Sources
|
|
79
79
|
|
|
80
80
|
- `AGENTS.md`
|
|
81
|
-
- Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`, `10-define`, `20-spec`, `40-
|
|
81
|
+
- Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`, `10-define`, `20-spec`, `40-execute`
|
|
82
82
|
|
|
83
83
|
|
|
@@ -77,14 +77,14 @@ Help Summary:
|
|
|
77
77
|
Environment: All OK
|
|
78
78
|
|
|
79
79
|
Active Runs:
|
|
80
|
-
- 010-auth-refactor: stage=40-
|
|
80
|
+
- 010-auth-refactor: stage=40-execute | approval=Pending | next=50-verify 010 | warnings: manual review open
|
|
81
81
|
- 011-billing-phase-1: stage=20-spec | approval=Approved | next=30-plan 011
|
|
82
82
|
- 012-admin-console: stage=50-verify | approval=Approved | next=60-report 012 | warnings: not ready for release
|
|
83
83
|
|
|
84
84
|
Recommended Next Action:
|
|
85
85
|
- 010 -> 50-verify 010
|
|
86
86
|
- 011 -> 20-spec 011
|
|
87
|
-
- 012 -> 40-
|
|
87
|
+
- 012 -> 40-execute 012
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
### Phase C: Manual Review Soft Gate
|
|
@@ -114,7 +114,7 @@ Manual Review Warning:
|
|
|
114
114
|
## DevFlow 2.0 Mainline
|
|
115
115
|
|
|
116
116
|
```text
|
|
117
|
-
00-discover -> 10-define -> 20-spec -> 30-plan -> 40-
|
|
117
|
+
00-discover -> 10-define -> 20-spec -> 30-plan -> 40-execute -> 50-verify -> 60-report -> 70-release
|
|
118
118
|
```
|
|
119
119
|
|
|
120
120
|
## Public Companion Commands
|
|
@@ -182,7 +182,7 @@ Recommend `30-plan`.
|
|
|
182
182
|
|
|
183
183
|
### 5. If planning is done and work should begin
|
|
184
184
|
|
|
185
|
-
Recommend `40-
|
|
185
|
+
Recommend `40-execute`.
|
|
186
186
|
|
|
187
187
|
### 6. If implementation exists and needs checking
|
|
188
188
|
|
|
@@ -27,7 +27,7 @@ What Broke ➔ Business Impact ➔ Root Cause ➔ Fix Evidence ➔ Prevention &
|
|
|
27
27
|
|
|
28
28
|
## 2. Process & Recording Destinations
|
|
29
29
|
|
|
30
|
-
1. **Load Evidence**: Review `git diff`, `40-
|
|
30
|
+
1. **Load Evidence**: Review `git diff`, `40-execute.md`, `50-verify.md`, or test logs.
|
|
31
31
|
2. **Distill Insights**: Formulate clear, actionable, non-generic takeaways.
|
|
32
32
|
3. **Save to Persistent Memory**:
|
|
33
33
|
- Save project-wide engineering lessons to `devflow/context/lessons.md` (or `knowledge/lessons.md`).
|
|
@@ -40,7 +40,7 @@ You are an orchestrator. Your goal is to call the specialized Git PR Maker agent
|
|
|
40
40
|
- Prefer markdown-first stage artifacts as the source narrative:
|
|
41
41
|
- `20-spec.md`
|
|
42
42
|
- `30-plan.md`
|
|
43
|
-
- `40-
|
|
43
|
+
- `40-execute.md`
|
|
44
44
|
- `50-verify.md`
|
|
45
45
|
- `60-report.md` when the final summary already exists
|
|
46
46
|
- `70-release.md` when release execution notes already exist
|
|
@@ -38,5 +38,5 @@ This is the preview master skill for Nexus-DevFlow. It manages local development
|
|
|
38
38
|
## Relationship To DevFlow 2.0
|
|
39
39
|
|
|
40
40
|
- **Classification**: Companion command & Runtime support
|
|
41
|
-
- **Mainline stages**: `40-
|
|
41
|
+
- **Mainline stages**: `40-execute` (interactive visual check), `50-verify` (smoke test check)
|
|
42
42
|
- **Handoff**: `50-verify`
|
|
@@ -68,4 +68,4 @@ Categorize all findings into actionable severities:
|
|
|
68
68
|
|
|
69
69
|
- **Classification**: Companion command & Verification support
|
|
70
70
|
- **Mainline stages**: `50-verify` (QA & Code Review lane), `70-release` (Pre-merge review)
|
|
71
|
-
- **Handoff**: `40-
|
|
71
|
+
- **Handoff**: `40-execute` (for fixes), `50-verify`, `70-release`
|
|
@@ -8,7 +8,7 @@ description: "[Devflow] Plan safe feature or run reversal with dependency and co
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
completed run + git history -> [rollback] -> 40-
|
|
11
|
+
completed run + git history -> [rollback] -> 40-execute (or fix run) -> 50-verify -> 70-release
|
|
12
12
|
(run archive + commits) (risk review (reverse product diff) (prove) (log & finalize)
|
|
13
13
|
+ plan)
|
|
14
14
|
```
|
|
@@ -51,7 +51,7 @@ Identify:
|
|
|
51
51
|
|
|
52
52
|
- Exact commit SHA(s) introducing the feature.
|
|
53
53
|
- Parent commit before the feature was introduced.
|
|
54
|
-
- Associated stage artifacts (`20-spec.md`, `40-
|
|
54
|
+
- Associated stage artifacts (`20-spec.md`, `40-execute.md`, `70-release.md`).
|
|
55
55
|
|
|
56
56
|
## Step 2 - Separate Product Changes From DevFlow History
|
|
57
57
|
|
|
@@ -98,7 +98,7 @@ Draft the rollback plan containing:
|
|
|
98
98
|
Present the rollback plan to the user:
|
|
99
99
|
|
|
100
100
|
- Summarize affected files and dependency risks.
|
|
101
|
-
- If approved, route to `40-
|
|
101
|
+
- If approved, route to `40-execute` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
|
|
102
102
|
|
|
103
103
|
## Rules
|
|
104
104
|
|
|
@@ -59,5 +59,5 @@ This is the comprehensive security master skill for Nexus-DevFlow. It combines s
|
|
|
59
59
|
## Relationship To DevFlow 2.0
|
|
60
60
|
|
|
61
61
|
- **Classification**: Companion command & Safety gate
|
|
62
|
-
- **Mainline integration**: Run during `40-
|
|
63
|
-
- **Handoff**: P0/P1 security findings block release and return to `40-
|
|
62
|
+
- **Mainline integration**: Run during `40-execute` or `50-verify` before `70-release`.
|
|
63
|
+
- **Handoff**: P0/P1 security findings block release and return to `40-execute` for immediate remediation.
|
|
@@ -66,5 +66,5 @@ Delete commented-out code blocks, `// removed` notes, and unused variables (`_un
|
|
|
66
66
|
## Relationship To DevFlow 2.0
|
|
67
67
|
|
|
68
68
|
- **Classification**: Companion command & Refactoring support
|
|
69
|
-
- **Mainline integration**: Used during `40-
|
|
69
|
+
- **Mainline integration**: Used during `40-execute` (Refactor step of TDD) or `50-verify`.
|
|
70
70
|
- **Handoff**: `50-verify` (proves zero regressions).
|
|
@@ -1,105 +1,38 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: spec
|
|
3
|
-
description: "[Devflow] Fast-Track Spec
|
|
3
|
+
description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the single living spec.md contract."
|
|
4
4
|
argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# Fast-Track: Spec (Blueprint Mode)
|
|
7
|
+
# Fast-Track: Spec Router (Blueprint Mode)
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Fast-Track entry point
|
|
11
|
+
Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`spec.md`)**.
|
|
12
|
+
|
|
13
|
+
> [!TIP]
|
|
14
|
+
> **Preferred Commands**:
|
|
15
|
+
> - ใช้ **`/feature <title>`** สำหรับฟีเจอร์ใหม่หรืองานพัฒนาทั่วไป
|
|
16
|
+
> - ใช้ **`/fix <bug-description>`** สำหรับแก้บั๊กหรือ hotfix
|
|
12
17
|
|
|
13
18
|
## Invocations & Aliases
|
|
14
19
|
|
|
15
|
-
- `/
|
|
16
|
-
- `/
|
|
17
|
-
- `/
|
|
18
|
-
-
|
|
19
|
-
- `$spec`, `$feature`, `$fix`: Codex CLI invocation
|
|
20
|
+
- `/feature <title>`: Fast-Track feature workflow (แนะนำ)
|
|
21
|
+
- `/fix <bug-description>`: Fast-Track ad-hoc bugfix workflow (แนะนำ)
|
|
22
|
+
- `/spec <title>` or `/spec IDEA-xxx`: Generic Fast-Track specification
|
|
23
|
+
- `$feature`, `$fix`, `$spec`: Codex CLI invocation
|
|
20
24
|
|
|
21
25
|
## Fast-Track Mainline Workflow
|
|
22
26
|
|
|
23
27
|
```text
|
|
24
|
-
/
|
|
28
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
25
29
|
```
|
|
26
30
|
|
|
27
31
|
## Behavior & Contract
|
|
28
32
|
|
|
29
33
|
When invoked:
|
|
30
34
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
- Use these details as the primary input for Specification & Scope.
|
|
36
|
-
- In `devflow/ideas.md`, update the item's status to `[x] Claimed ({RUNNING_ID})` and move it under `## 📦 Archived / Shipped Ideas`.
|
|
37
|
-
3. Determine or allocate the sequential Running ID (e.g. `RUN-016-{slug}`).
|
|
38
|
-
4. Identify Git branch naming:
|
|
39
|
-
- For features: `feature/{slug}-{RUNNING_ID}`
|
|
40
|
-
- For bug fixes: `fix/{slug}-{RUNNING_ID}`
|
|
41
|
-
5. Create directory `devflow/runs/{RUNNING_ID}/`.
|
|
42
|
-
|
|
43
|
-
### 2. Generate the Single Living Spec (`spec.md`)
|
|
44
|
-
Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
|
|
45
|
-
|
|
46
|
-
```markdown
|
|
47
|
-
# 📐 [{RUNNING_ID}] {Title} (Living Spec)
|
|
48
|
-
|
|
49
|
-
> **Status**: In-Progress
|
|
50
|
-
> **Track**: Fast-Track (Blueprint Mode)
|
|
51
|
-
> **Branch**: `{branch_name}`
|
|
52
|
-
> **Created Date**: {YYYY-MM-DD}
|
|
53
|
-
> **Owner**: {Contributor or Team}
|
|
54
|
-
|
|
55
|
-
---
|
|
56
|
-
|
|
57
|
-
## 1. Specification & Scope
|
|
58
|
-
- **Problem Statement**: {ปัญหาหรือที่มาที่ต้องทำ}
|
|
59
|
-
- **In-Scope**:
|
|
60
|
-
- {ขอบเขตสิ่งที่ต้องทำ}
|
|
61
|
-
- **Out-of-Scope**:
|
|
62
|
-
- {สิ่งที่ไม่ทำในรอบนี้}
|
|
63
|
-
- **Acceptance Criteria**:
|
|
64
|
-
- [ ] AC-1: {เงื่อนไขการตรวจรับข้อที่ 1}
|
|
65
|
-
- [ ] AC-2: {เงื่อนไขการตรวจรับข้อที่ 2}
|
|
66
|
-
|
|
67
|
-
## 2. Plan & Test Strategy
|
|
68
|
-
- **Files to Modify / Create**:
|
|
69
|
-
- `{path/to/file1}`: {หน้าที่ที่ต้องแก้ไข}
|
|
70
|
-
- `{path/to/file2}`: {หน้าที่ที่ต้องแก้ไข}
|
|
71
|
-
- **Test Decision**: `Required (TDD)` | `Manual/Command Only` | `Not Required`
|
|
72
|
-
- *Rationale*: {เหตุผลความจำเป็นในการเขียนเทสต์}
|
|
73
|
-
- *Planned Cases*: {กรณีทดสอบหลักตาม AAA Pattern}
|
|
74
|
-
- **Impact & Rollback Strategy**:
|
|
75
|
-
- *Impact*: {ผลกระทบต่อโมดูลอื่น}
|
|
76
|
-
- *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
|
|
77
|
-
|
|
78
|
-
## 3. Implementation Checklist
|
|
79
|
-
- [ ] Task 1.1: {งานย่อยข้อที่ 1}
|
|
80
|
-
- [ ] Task 1.2: {งานย่อยข้อที่ 2}
|
|
81
|
-
- [ ] Task 1.3: {งานย่อยข้อที่ 3}
|
|
82
|
-
|
|
83
|
-
## 4. Implementation Record
|
|
84
|
-
- *(จะถูกบันทึกเมื่อรัน /implement)*
|
|
85
|
-
|
|
86
|
-
## 5. Verification Evidence
|
|
87
|
-
- *(จะถูกบันทึกเมื่อรัน /check)*
|
|
88
|
-
|
|
89
|
-
## 6. Release & Handoff
|
|
90
|
-
- *(จะถูกบันทึกเมื่อรัน /complete)*
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### 3. Update Workspace Status
|
|
94
|
-
Update `devflow/context/current-stage.md`:
|
|
95
|
-
- `Active Running ID`: `{RUNNING_ID}`
|
|
96
|
-
- `Current Stage`: `spec (Fast-Track -> Ready for /implement)`
|
|
97
|
-
- `Last Updated`: `{YYYY-MM-DD}`
|
|
98
|
-
|
|
99
|
-
### 4. Output Summary & Next Step
|
|
100
|
-
Report to the user:
|
|
101
|
-
- Running ID and allocated branch
|
|
102
|
-
- Summary of Scope and Acceptance Criteria
|
|
103
|
-
- Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
|
|
104
|
-
- If promoted from `IDEA-xxx`, confirm status update in `devflow/ideas.md`
|
|
105
|
-
- **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
|
|
35
|
+
1. If the input describes a bug or hotfix, routes to `/fix` behavior.
|
|
36
|
+
2. Otherwise, routes to `/feature` behavior.
|
|
37
|
+
3. Allocates sequential Running ID (`RUN-xxx`), creates directory `devflow/runs/{RUNNING_ID}/`, and generates `spec.md` in **Thai (`th`)**.
|
|
38
|
+
4. Updates `devflow/context/current-stage.md` and reports next step: `/implement`.
|
|
@@ -81,7 +81,7 @@ For browser and UI features, unit tests alone are insufficient:
|
|
|
81
81
|
|
|
82
82
|
## 6. Test Generation & Persistent Execution Reports
|
|
83
83
|
|
|
84
|
-
When generating or logging test runs during `40-
|
|
84
|
+
When generating or logging test runs during `40-execute` or `50-verify`:
|
|
85
85
|
- Save summary reports to `devflow/reports/{date}-test-report-{slug}.md`
|
|
86
86
|
- Include: Target, Test Cases (Happy Path, Error, Edge Cases), Pass/Fail statistics, and gaps/risks.
|
|
87
87
|
|
|
@@ -90,5 +90,5 @@ When generating or logging test runs during `40-implement` or `50-verify`:
|
|
|
90
90
|
## Relationship To DevFlow 2.0
|
|
91
91
|
|
|
92
92
|
- **Classification**: Companion command & Engineering standard
|
|
93
|
-
- **Mainline stages**: `30-plan` (TDD decisions), `40-
|
|
93
|
+
- **Mainline stages**: `30-plan` (TDD decisions), `40-execute` (TDD execution), `50-verify` (QA gate)
|
|
94
94
|
- **Handoff**: `50-verify`, `Debug`, `autopilot`
|
|
@@ -8,7 +8,7 @@ description: "[Devflow] Generate human manual QA review walkthrough guide (where
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
40-
|
|
11
|
+
40-execute or 50-verify or 60-report -> [try] -> human review & verification
|
|
12
12
|
(work implemented / verified) (manual (where to go,
|
|
13
13
|
steps) what to click)
|
|
14
14
|
```
|
|
@@ -36,7 +36,7 @@ Read:
|
|
|
36
36
|
- `devflow/context/current-stage.md`
|
|
37
37
|
- `devflow/context/project-overview.md`
|
|
38
38
|
- `devflow/context/coding-standards.md`
|
|
39
|
-
- Active run artifacts: `20-spec.md`, `30-plan.md`, `40-
|
|
39
|
+
- Active run artifacts: `20-spec.md`, `30-plan.md`, `40-execute.md`, `50-verify.md` (or archived run artifacts)
|
|
40
40
|
- Current git branch and status
|
|
41
41
|
|
|
42
42
|
Do not dump the full spec. Extract only the concrete routes, screens, CLI commands, API endpoints, test data, and expected outcomes that a human needs to verify the feature.
|
package/template/AGENTS.md
CHANGED
|
@@ -29,10 +29,10 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
|
|
|
29
29
|
|
|
30
30
|
### Universal Invocation & Agent Directives:
|
|
31
31
|
|
|
32
|
-
1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `
|
|
33
|
-
- **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `
|
|
34
|
-
- **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/
|
|
35
|
-
- **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$
|
|
32
|
+
1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `feature`, `fix`, `implement`, `check`, `complete`, `00-discover`, `10-define`, `20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`, `report-html`, `devflow`, `onboard`, `adopt`, `doctor`, `try`, `rollback`, `ci`, `brief`, `autopilot`, `idea`, `spec`). The way you invoke commands depends on your AI Provider / Tool:
|
|
33
|
+
- **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `feature`, `40-execute`, `devflow`).
|
|
34
|
+
- **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/feature`, `/fix`, `/implement`, `/40-execute`, `/devflow`.
|
|
35
|
+
- **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$feature`, `$fix`, `$40-execute`, `$devflow`.
|
|
36
36
|
2. **OpenAI Codex & Non-Native CLI Tools**: In environments without automatic background skill discovery (such as OpenAI Codex CLI, Aider, or generic terminals), **you MUST use your file reading tool to inspect `.agents/skills/<skill>/SKILL.md` before executing the stage** to strictly follow its schema, artifact contract, and quality gates.
|
|
37
37
|
3. **Google Antigravity & Claude Code**: Native skill engines automatically discover and surface `.agents/skills/` and `.claude/skills/`.
|
|
38
38
|
4. **State-Aware Inspection**: When unsure what to do next, invoke `devflow` to automatically inspect `devflow/context/current-stage.md` and active runs in `devflow/runs/`.
|
|
@@ -45,10 +45,10 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
|
|
|
45
45
|
Recommended for 85% of daily work (features, bug fixes, UI improvements, iterative tasks):
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
|
-
/
|
|
48
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
1. **`
|
|
51
|
+
1. **`feature` / `fix` (`/feature`, `/fix`, `/spec`)**:
|
|
52
52
|
- **Purpose**: Combines Discover, Define, Spec, and Plan into one unified step. Allocates sequential Running ID (`RUN-xxx`) and creates the **Single Living Spec (`spec.md`)**.
|
|
53
53
|
- **Artifact**: `devflow/runs/{running-id}-{slug}/spec.md`
|
|
54
54
|
2. **`implement` (`/implement`)**:
|
|
@@ -65,14 +65,14 @@ Recommended for 85% of daily work (features, bug fixes, UI improvements, iterati
|
|
|
65
65
|
Recommended for large architectural epics, database migrations, and multi-agent coordination:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
00-discover ──▶ 10-define ──▶ 20-spec ──▶ 30-plan ──▶ 40-
|
|
68
|
+
00-discover ──▶ 10-define ──▶ 20-spec ──▶ 30-plan ──▶ 40-execute ──▶ 50-verify ──▶ 60-report ──▶ 70-release
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
1. `00-discover`: Explore request before delivery commitment without allocating running ID (`00-discover.md`).
|
|
72
72
|
2. `10-define`: Turn approved discovery into bounded delivery run(s) with sequential Running IDs (`10-define.md`).
|
|
73
73
|
3. `20-spec`: Formalize markdown-first delivery contract & acceptance criteria (`20-spec.md`).
|
|
74
74
|
4. `30-plan`: Breakdown spec into executable tasks with test decisions (`30-plan.md` + checklists).
|
|
75
|
-
5. `40-
|
|
75
|
+
5. `40-execute`: Incremental task execution behind review gates (`40-execute.md`).
|
|
76
76
|
6. `50-verify`: Senior QA review & multi-lane verification checks (`50-verify.md`).
|
|
77
77
|
7. `60-report`: Standardized markdown delivery digest (`60-report.md`).
|
|
78
78
|
8. `70-release`: Release packaging, release notes, git merge, and deployment (`70-release.md`).
|
|
@@ -116,7 +116,8 @@ Recommended for large architectural epics, database migrations, and multi-agent
|
|
|
116
116
|
|
|
117
117
|
| Track / Category | Canonical Name | Claude / Antigravity (`/`) | OpenAI Codex (`$`) | Purpose / Action |
|
|
118
118
|
| :--- | :--- | :--- | :--- | :--- |
|
|
119
|
-
| **Fast:
|
|
119
|
+
| **Fast: Feature** | `feature` | `/feature` | `$feature` | 4-step Fast-Track spec & living spec creation for new features (supports `IDEA-xxx`) |
|
|
120
|
+
| **Fast: Fix** | `fix` | `/fix` | `$fix` | 4-step Fast-Track spec & living spec creation for bug fixes (supports `IDEA-xxx`) |
|
|
120
121
|
| **Fast: Implement** | `implement` | `/implement` | `$implement` | Fast-Track incremental execution with TDD |
|
|
121
122
|
| **Fast: Check** | `check` | `/check` | `$check` | Fast-Track QA review & multi-lane verification |
|
|
122
123
|
| **Fast: Complete** | `complete` | `/complete` | `$complete` | Fast-Track safety pass, release digest & git merge |
|
|
@@ -126,7 +127,7 @@ Recommended for large architectural epics, database migrations, and multi-agent
|
|
|
126
127
|
| **Deep: 10** | `10-define` | `/10-define` | `$10-define` | Turn approved discovery into bounded delivery run(s) |
|
|
127
128
|
| **Deep: 20** | `20-spec` | `/20-spec` | `$20-spec` | Formal markdown delivery contract & acceptance criteria |
|
|
128
129
|
| **Deep: 30** | `30-plan` | `/30-plan` | `$30-plan` | Breakdown spec into executable tasks with test decisions |
|
|
129
|
-
| **Deep: 40** | `40-
|
|
130
|
+
| **Deep: 40** | `40-execute` | `/40-execute` | `$40-execute` | Execute planned tasks in small reviewable increments (`40-execute.md`) |
|
|
130
131
|
| **Deep: 50** | `50-verify` | `/50-verify` | `$50-verify` | Senior QA review & multi-lane verification checks |
|
|
131
132
|
| **Deep: 60** | `60-report` | `/60-report` | `$60-report` | Standalone markdown summary report |
|
|
132
133
|
| **Deep: 70** | `70-release` | `/70-release` | `$70-release` | Package for delivery, git merge, PR, or deployment |
|
|
@@ -24,12 +24,12 @@
|
|
|
24
24
|
## DevFlow Timeline Lifecycle
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-
|
|
27
|
+
/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Execute -> /50-Verify -> /60-Report -> /70-Release
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
- Run `/00-Discover` to explore requests under a Discovery ID.
|
|
31
31
|
- Run `/10-Define` to set delivery boundaries and allocate Running IDs.
|
|
32
32
|
- Run `/20-Spec` and `/30-Plan` to establish formal delivery specifications and execution plans.
|
|
33
|
-
- Run `/40-
|
|
33
|
+
- Run `/40-Execute` for step-by-step code implementation with evidence.
|
|
34
34
|
- Run `/50-Verify`, `/60-Report`, and `/70-Release` for quality verification, reporting, and release packaging.
|
|
35
35
|
- Use **Fast-Track / Quick-Fix mode** for minor hotfixes to skip heavy ceremony while keeping test evidence.
|
|
@@ -36,5 +36,5 @@ General engineering standards for code, tests, and documentation in Nexus-DevFlo
|
|
|
36
36
|
|
|
37
37
|
- For trivial bug fixes, typo corrections, or single-file non-architectural changes, developers and agents may use the **Quick-Fix Fast-Track**:
|
|
38
38
|
- Consolidate Discovery, Define, and Spec into an inline fix brief (`devflow/runs/{fix-id}/fix-brief.md`).
|
|
39
|
-
- Jump directly to `40-
|
|
39
|
+
- Jump directly to `40-execute` (with reproduction unit test) ➔ `50-verify` ➔ `70-release`.
|
|
40
40
|
- Avoid creating heavy redundant documentation for changes under 20 lines of code while preserving Empirical Proof and Unit Test requirements.
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
- **Active Discovery ID**: None
|
|
4
4
|
- **Active Running ID**: None
|
|
5
|
-
- **Current Stage**: Ready for
|
|
6
|
-
- **
|
|
5
|
+
- **Current Stage**: Idle (Ready for next run)
|
|
6
|
+
- **Living Spec**: None
|
|
7
|
+
- **Last Completed Run**: RUN-018-update-documentation-and-guides (2026-08-20)
|
|
7
8
|
- **Last Updated**: 2026-08-20
|
|
@@ -19,19 +19,23 @@ Primary source of truth for the project context, architecture, tech stack, and a
|
|
|
19
19
|
|
|
20
20
|
## Architecture & Key Modules
|
|
21
21
|
|
|
22
|
+
- **Dual-Track Delivery Engine**:
|
|
23
|
+
- **Fast-Track (Blueprint Mode — 4 Steps)**: High-velocity spec loop (`/feature` or `/fix` ➔ `/implement` ➔ `/check` ➔ `/complete`) with Single Living Spec (`spec.md`).
|
|
24
|
+
- **Deep-Track (Architect Mode — 8 Steps)**: Full-lifecycle delivery pipeline (`00-discover` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-release`).
|
|
22
25
|
- **`packages/create-nexus-devflow/`**: Distribution CLI package with TypeScript compilation (`dist/bin/create-nexus-devflow.js`), atomic update engine (`lib/update.ts`), and prepack template bundler (`scripts/prepare-template.ts`).
|
|
23
|
-
- **`.agents/skills/` & `.claude/skills/`**:
|
|
26
|
+
- **`.agents/skills/` & `.claude/skills/`**: 80 synchronized AI agent skills covering Dual-Track workflows and companion tools (`devflow`, `idea`, `report-html`, `try`, `doctor`, `overview`, `sync-upstream`, `ci`, `rollback`).
|
|
24
27
|
- **`scripts/`**: Maintainer infrastructure (`check-devflow.ts`, `validate-framework.ts`, `smoke-package.ts`, `upstream-monitor.ts`, `evals/routing.ts`).
|
|
25
|
-
- **`devflow/`**: Workspace state, discoveries, runs, context, reference contracts, and master release history ledger.
|
|
28
|
+
- **`devflow/`**: Workspace state, discoveries, runs, ideas, context, reference contracts, and master release history ledger.
|
|
26
29
|
|
|
27
30
|
## Shipped Capabilities (Recent Milestones)
|
|
28
31
|
|
|
32
|
+
- **`RUN-017` (2026-08-20)**: Separate Fast-Track skills (`/feature`, `/fix`) and rename Deep-Track stage 40 to `40-execute` to eliminate command collisions.
|
|
33
|
+
- **`RUN-016` (2026-08-20)**: Quick Idea Capture and AI Feasibility Assessment (`/idea`) with centralized Idea Inbox (`devflow/ideas.md`).
|
|
34
|
+
- **`RUN-015` (2026-08-20)**: Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Reporting Policy.
|
|
29
35
|
- **`RUN-014` (2026-08-20)**: Upgraded DevFlow to full TypeScript architecture (`tsconfig.json`, `tsx`, `tsc`, `dist/`), migrated AI Blueprint Upstream Monitor workflow to DevFlow, and established multi-lane verification matrix.
|
|
30
|
-
- **`RUN-013` (2026-08-20)**: Added `/overview` skill for living context scanning and synchronization.
|
|
31
|
-
- **`RUN-008` (2026-08-18)**: Lean & Clean DevFlow optimization, consolidated skill taxonomy, and safe rollback mechanisms.
|
|
32
36
|
|
|
33
37
|
## DevFlow Workspace Status
|
|
34
38
|
|
|
35
39
|
- **Active Discovery ID**: None (Idle)
|
|
36
|
-
- **Active Running ID**:
|
|
37
|
-
- **Last Completed Run**: `RUN-
|
|
40
|
+
- **Active Running ID**: `RUN-018-update-documentation-and-guides`
|
|
41
|
+
- **Last Completed Run**: `RUN-017-split-spec-and-rename-40-execute`
|
|
@@ -8,6 +8,8 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
|
|
|
8
8
|
|
|
9
9
|
| Release Date | Running ID | Title | Git Tag / Commit | Release Status | Report Link |
|
|
10
10
|
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
11
|
+
| 2026-08-20 | `RUN-018` | อัปเดตคู่มือ เอกสาร และ Website Documentation ให้เป็นปัจจุบันและครอบคลุม Dual-Track Model ล่าสุด | `HEAD` | `Released` | [`spec.md`](../runs/RUN-018-update-documentation-and-guides/spec.md) |
|
|
12
|
+
| 2026-08-20 | `RUN-017` | แยกคำสั่ง Fast-Track เป็น `/feature`, `/fix` และเปลี่ยน Deep-Track สเตจ 40 เป็น `40-execute` | `HEAD` | `Released` | [`spec.md`](../runs/RUN-017-split-spec-and-rename-40-execute/spec.md) |
|
|
11
13
|
| 2026-08-20 | `RUN-016` | ระบบบันทึกไอเดียพร้อม AI วิเคราะห์ความเป็นไปได้ (`/idea`) และเชื่อมต่อกับ Status Backlog | `HEAD` | `Released` | [`spec.md`](../runs/RUN-016-idea-capture-inbox-and-status-integration/spec.md) |
|
|
12
14
|
| 2026-08-20 | `RUN-015` | Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Report Policy | `HEAD` | `Released` | [`spec.md`](../runs/RUN-015-fast-track-and-living-blueprint/spec.md) |
|
|
13
15
|
| 2026-08-20 | `RUN-014` | ยกระดับสถาปัตยกรรม DevFlow สู่ TypeScript และย้ายระบบ Check AI Blueprint Upstream Monitor | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-014-typescript-migration-and-upstream-monitor-for-devflow/60-report.md) |
|
|
@@ -15,7 +15,7 @@ All DevFlow framework context, active runs, templates, and history are consolida
|
|
|
15
15
|
- `10-define.md`
|
|
16
16
|
- `20-spec.md`
|
|
17
17
|
- `30-plan.md`
|
|
18
|
-
- `40-
|
|
18
|
+
- `40-execute.md`
|
|
19
19
|
- `50-verify.md`
|
|
20
20
|
- `60-report.md` (and `60-report.html`)
|
|
21
21
|
- `70-release.md`
|
|
@@ -34,6 +34,6 @@ All DevFlow framework context, active runs, templates, and history are consolida
|
|
|
34
34
|
|
|
35
35
|
## Mainline Lifecycle Rules
|
|
36
36
|
|
|
37
|
-
1. Mainline stages move linearly: `/00-Discover` ➔ `/10-Define` ➔ `/20-Spec` ➔ `/30-Plan` ➔ `/40-
|
|
37
|
+
1. Mainline stages move linearly: `/00-Discover` ➔ `/10-Define` ➔ `/20-Spec` ➔ `/30-Plan` ➔ `/40-Execute` ➔ `/50-Verify` ➔ `/60-Report` ➔ `/70-Release`.
|
|
38
38
|
2. Companion commands (`Goal`, `Brainstorm`, `Research`, `Debug`, `PRD`, `Issue-Triage`, `Security-Review`, `Check-For-Updates`, `Help`) provide supporting context without replacing mainline stage numbers.
|
|
39
39
|
3. Every stage produces markdown-first evidence in `devflow/runs/` before passing verification gates.
|