@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,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: feature
|
|
3
|
+
description: "[Devflow] Fast-Track Feature stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living spec.md contract for new features."
|
|
4
|
+
argument-hint: "{feature title, IDEA-xxx, or feature description}"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Fast-Track: Feature (Blueprint Mode)
|
|
8
|
+
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
Fast-Track entry point combining Discovery, Definition, Specification, and Implementation Planning into one streamlined, review-gated step for **new features or enhancements**. Creates and maintains the **Single Living Spec (`spec.md`)** for the feature run. Supports intake from Idea Inbox (`IDEA-xxx`).
|
|
12
|
+
|
|
13
|
+
## Invocations & Aliases
|
|
14
|
+
|
|
15
|
+
- `/feature <title>` or `feature <title>`: Fast-Track feature specification
|
|
16
|
+
- `/feature IDEA-xxx`: Intake and promote a pending idea from `devflow/ideas.md`
|
|
17
|
+
- `$feature`: 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 & Idea Intake
|
|
30
|
+
1. Inspect `devflow/context/current-stage.md` and `devflow/runs/`.
|
|
31
|
+
2. **Idea Inbox Intake**: If the argument is an idea identifier (e.g. `IDEA-001`):
|
|
32
|
+
- Read `devflow/ideas.md` and extract the idea's title, raw problem statement, AI Feasibility notes, and Quick Seed points.
|
|
33
|
+
- Use these details as the primary input for Specification & Scope.
|
|
34
|
+
- In `devflow/ideas.md`, update the item's status to `[x] Claimed ({RUNNING_ID})` and move it under `## 📦 Archived / Shipped Ideas`.
|
|
35
|
+
3. Determine or allocate the sequential Running ID (e.g. `RUN-018-{slug}`).
|
|
36
|
+
4. Identify Git branch naming:
|
|
37
|
+
- `feature/{slug}-{RUNNING_ID}`
|
|
38
|
+
5. Create directory `devflow/runs/{RUNNING_ID}/`.
|
|
39
|
+
|
|
40
|
+
### 2. Generate the Single Living Spec (`spec.md`)
|
|
41
|
+
Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
|
|
42
|
+
|
|
43
|
+
```markdown
|
|
44
|
+
# 📐 [{RUNNING_ID}] {Feature Title} (Living Spec)
|
|
45
|
+
|
|
46
|
+
> **Status**: In-Progress
|
|
47
|
+
> **Track**: Fast-Track (Blueprint Mode - Feature)
|
|
48
|
+
> **Branch**: `{branch_name}`
|
|
49
|
+
> **Created Date**: {YYYY-MM-DD}
|
|
50
|
+
> **Owner**: {Contributor or Team}
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 1. Specification & Scope
|
|
55
|
+
- **Problem Statement**: {ปัญหาหรือที่มาของฟีเจอร์นี้}
|
|
56
|
+
- **In-Scope**:
|
|
57
|
+
- {ขอบเขตสิ่งที่ต้องทำสำหรับฟีเจอร์นี้}
|
|
58
|
+
- **Out-of-Scope**:
|
|
59
|
+
- {สิ่งที่ไม่ทำในรอบนี้}
|
|
60
|
+
- **Acceptance Criteria**:
|
|
61
|
+
- [ ] AC-1: {เงื่อนไขการตรวจรับข้อที่ 1}
|
|
62
|
+
- [ ] AC-2: {เงื่อนไขการตรวจรับข้อที่ 2}
|
|
63
|
+
|
|
64
|
+
## 2. Plan & Test Strategy
|
|
65
|
+
- **Files to Modify / Create**:
|
|
66
|
+
- `{path/to/file1}`: {หน้าที่ที่ต้องสร้าง/แก้ไข}
|
|
67
|
+
- `{path/to/file2}`: {หน้าที่ที่ต้องสร้าง/แก้ไข}
|
|
68
|
+
- **Test Decision**: `Required (TDD)` | `Manual/Command Only` | `Not Required`
|
|
69
|
+
- *Rationale*: {เหตุผลความจำเป็นในการเขียนเทสต์}
|
|
70
|
+
- *Planned Cases*: {กรณีทดสอบหลักตาม AAA Pattern}
|
|
71
|
+
- **Impact & Rollback Strategy**:
|
|
72
|
+
- *Impact*: {ผลกระทบต่อโมดูลอื่น}
|
|
73
|
+
- *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
|
|
74
|
+
|
|
75
|
+
## 3. Implementation Checklist
|
|
76
|
+
- [ ] Task 1.1: {งานย่อยข้อที่ 1}
|
|
77
|
+
- [ ] Task 1.2: {งานย่อยข้อที่ 2}
|
|
78
|
+
- [ ] Task 1.3: {งานย่อยข้อที่ 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`: `feature (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 and Acceptance Criteria
|
|
101
|
+
- Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
|
|
102
|
+
- If promoted from `IDEA-xxx`, confirm status update in `devflow/ideas.md`
|
|
103
|
+
- **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
|
|
@@ -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.
|
|
@@ -48,7 +48,7 @@ Run planning as an evidence loop, not as a one-shot outline.
|
|
|
48
48
|
- **Observation**: use concrete evidence such as file paths, existing patterns, package scripts, validation commands, and unresolved assumptions.
|
|
49
49
|
- **Adjustment**: if evidence is missing, search/read more, recommend `Research` or `Agent codebase-explorer`, split the work, or route back to `20-spec` when the contract is not plan-ready.
|
|
50
50
|
- **Stop Condition**: stop only when phases are ordered, subtasks are scoped, verification is explicit, test decisions are recorded, and any blockers are visible.
|
|
51
|
-
- **Handoff**: `30-plan.md` must give `40-
|
|
51
|
+
- **Handoff**: `30-plan.md` must give `40-execute` enough context to select one scoped unit and execute it without inventing intent.
|
|
52
52
|
|
|
53
53
|
### 1. Read Task Artifacts
|
|
54
54
|
|
|
@@ -161,12 +161,12 @@ If validation fails, repair only what is necessary and keep `30-plan.md` aligned
|
|
|
161
161
|
|
|
162
162
|
### 7. Manual Review Soft Gate
|
|
163
163
|
|
|
164
|
-
Before recommending `40-
|
|
164
|
+
Before recommending `40-execute`, check whether the plan still shows pending review.
|
|
165
165
|
If `Approval Status` is still pending or major dependencies remain unresolved:
|
|
166
166
|
|
|
167
167
|
- warn that implementation should wait for review
|
|
168
168
|
- recommend human confirmation of sequencing, scope, and verification strategy
|
|
169
|
-
- keep `40-
|
|
169
|
+
- keep `40-execute` as a soft recommendation only
|
|
170
170
|
|
|
171
171
|
## Output Checklist
|
|
172
172
|
|
|
@@ -184,7 +184,7 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
|
|
|
184
184
|
|
|
185
185
|
- Classification: Mainline workflow
|
|
186
186
|
- Previous state: `20-spec`
|
|
187
|
-
- Next state: `40-
|
|
187
|
+
- Next state: `40-execute` when execution steps and verification are clear
|
|
188
188
|
- Common companion commands: `Research` or `Agent` when architecture, data flow, or external constraints still need investigation; support skills: `grill-with-docs`, `domain-modeling`, `codebase-design`, `tdd`, and `to-issues` for final design stress-testing, durable terminology capture, test planning, and issue packaging
|
|
189
189
|
|
|
190
190
|
## Sources
|
|
@@ -192,11 +192,11 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
|
|
|
192
192
|
- `AGENTS.md`
|
|
193
193
|
- `docs/workspace-artifacts.md`
|
|
194
194
|
- `.agent/resources/schemas/plan.template.md`
|
|
195
|
-
- Related commands: `20-spec`, `Research`, `Agent`, `40-
|
|
195
|
+
- Related commands: `20-spec`, `Research`, `Agent`, `40-execute`
|
|
196
196
|
|
|
197
197
|
## Next Workflow Recommendation
|
|
198
198
|
|
|
199
|
-
- **Primary**: `40-
|
|
199
|
+
- **Primary**: `40-execute {ID}`
|
|
200
200
|
- **Why**: Approved planning is the gate before implementation in DevFlow 2.0.
|
|
201
201
|
- **Alternatives**:
|
|
202
202
|
- `Research` - choose this when the plan still depends on missing evidence.
|