@jakkrichm/create-nexus-devflow 2.0.16 → 2.0.18
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/dist/bin/create-nexus-devflow.d.ts +2 -1
- package/dist/bin/create-nexus-devflow.js +81 -3
- package/dist/bin/create-nexus-devflow.js.map +1 -1
- package/dist/lib/current-work.d.ts +2 -3
- package/dist/lib/current-work.js +93 -66
- package/dist/lib/current-work.js.map +1 -1
- package/dist/lib/uninstall.d.ts +20 -0
- package/dist/lib/uninstall.js +129 -0
- package/dist/lib/uninstall.js.map +1 -0
- package/dist/scripts/prepare-template.js +120 -10
- package/dist/scripts/prepare-template.js.map +1 -1
- package/package.json +1 -1
- package/template/.agents/skills/00-discover/SKILL.md +2 -2
- package/template/.agents/skills/10-define/SKILL.md +24 -140
- package/template/.agents/skills/20-spec/SKILL.md +2 -2
- package/template/.agents/skills/30-plan/SKILL.md +2 -2
- package/template/.agents/skills/50-verify/SKILL.md +2 -2
- package/template/.agents/skills/60-report/SKILL.md +1 -1
- package/template/.agents/skills/70-release/SKILL.md +19 -143
- package/template/.agents/skills/check/SKILL.md +10 -10
- package/template/.agents/skills/ci/SKILL.md +1 -1
- package/template/.agents/skills/complete/SKILL.md +49 -28
- package/template/.agents/skills/deploy/SKILL.md +1 -1
- package/template/.agents/skills/devflow/SKILL.md +5 -5
- package/template/.agents/skills/feature/SKILL.md +25 -20
- package/template/.agents/skills/fix/SKILL.md +25 -19
- package/template/.agents/skills/implement/SKILL.md +10 -10
- package/template/.agents/skills/insight/SKILL.md +1 -1
- package/template/.agents/skills/overview/SKILL.md +3 -3
- package/template/.agents/skills/report-html/SKILL.md +3 -3
- package/template/.agents/skills/security-review/SKILL.md +1 -1
- package/template/.agents/skills/spec/SKILL.md +7 -6
- package/template/.agents/skills/spec-driven-development/SKILL.md +2 -2
- package/template/.agents/skills/test/SKILL.md +1 -1
- package/template/.claude/skills/00-discover/SKILL.md +2 -2
- package/template/.claude/skills/10-define/SKILL.md +24 -140
- package/template/.claude/skills/20-spec/SKILL.md +2 -2
- package/template/.claude/skills/30-plan/SKILL.md +2 -2
- package/template/.claude/skills/50-verify/SKILL.md +2 -2
- package/template/.claude/skills/60-report/SKILL.md +1 -1
- package/template/.claude/skills/70-release/SKILL.md +19 -143
- package/template/.claude/skills/check/SKILL.md +10 -10
- package/template/.claude/skills/ci/SKILL.md +1 -1
- package/template/.claude/skills/complete/SKILL.md +49 -28
- package/template/.claude/skills/deploy/SKILL.md +1 -1
- package/template/.claude/skills/devflow/SKILL.md +5 -5
- package/template/.claude/skills/feature/SKILL.md +25 -20
- package/template/.claude/skills/fix/SKILL.md +25 -19
- package/template/.claude/skills/implement/SKILL.md +10 -10
- package/template/.claude/skills/insight/SKILL.md +1 -1
- package/template/.claude/skills/overview/SKILL.md +3 -3
- package/template/.claude/skills/report-html/SKILL.md +3 -3
- package/template/.claude/skills/security-review/SKILL.md +1 -1
- package/template/.claude/skills/spec/SKILL.md +7 -6
- package/template/.claude/skills/spec-driven-development/SKILL.md +2 -2
- package/template/.claude/skills/test/SKILL.md +1 -1
- package/template/AGENTS.md +15 -59
- package/template/devflow/context/ai-interaction.md +110 -23
- package/template/devflow/context/coding-standards.md +123 -32
- package/template/devflow/context/current-feature.md +3 -0
- package/template/devflow/context/current-stage.md +6 -6
- package/template/devflow/context/findings.md +10 -10
- package/template/devflow/context/project-overview.md +18 -32
- package/template/devflow/history/HISTORY.md +10 -25
- package/template/devflow/ideas.md +9 -5
- package/template/devflow/reference/running-id-contract.md +39 -39
- package/template/devflow/runs/.gitkeep +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: check
|
|
3
|
-
description: "[Devflow] Fast-Track Check stage in DevFlow (Blueprint Mode) - perform senior QA review, run multi-lane verification, and record evidence in
|
|
3
|
+
description: "[Devflow] Fast-Track Check stage in DevFlow (Blueprint Mode) - perform senior QA review, run multi-lane verification, and record evidence in current-feature.md in context."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Quality assurance and multi-lane verification stage in Fast-Track. Validates the implementation against Acceptance Criteria, runs test suites, checks for regressions, and records evidence in the Single Living Spec (`
|
|
11
|
+
Quality assurance and multi-lane verification stage in Fast-Track. Validates the implementation against Acceptance Criteria, runs test suites, checks for regressions, and records evidence in the Single Living Spec (`devflow/context/current-feature.md`).
|
|
12
12
|
|
|
13
13
|
## Invocations & Aliases
|
|
14
14
|
|
|
15
15
|
- `/check`: Run verification on current active run
|
|
16
|
-
- `/check {
|
|
16
|
+
- `/check {id}`: Run verification on specified ID
|
|
17
17
|
- `$check`: Codex CLI invocation
|
|
18
18
|
|
|
19
19
|
## Fast-Track Mainline Workflow
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
/
|
|
22
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## Behavior & Contract
|
|
@@ -27,8 +27,8 @@ Quality assurance and multi-lane verification stage in Fast-Track. Validates the
|
|
|
27
27
|
When invoked:
|
|
28
28
|
|
|
29
29
|
### 1. Load Active Context
|
|
30
|
-
1. Identify active Running ID from `devflow/context/current-stage.md` or
|
|
31
|
-
2. Read `devflow/
|
|
30
|
+
1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
|
|
31
|
+
2. Read `devflow/context/current-feature.md`.
|
|
32
32
|
3. Locate `## 1. Specification & Scope` (Acceptance Criteria) and `## 3. Implementation Checklist`.
|
|
33
33
|
|
|
34
34
|
### 2. Multi-lane Verification Execution
|
|
@@ -41,8 +41,8 @@ Execute the verification gates across all lanes:
|
|
|
41
41
|
- Verify specific scenarios against Acceptance Criteria (`AC-1`, `AC-2`).
|
|
42
42
|
- Summarize "Where to go", "What to click/call", and "What to expect".
|
|
43
43
|
|
|
44
|
-
### 3. Update Living Spec (`
|
|
45
|
-
Append or update `## 5. Verification Evidence` in `
|
|
44
|
+
### 3. Update Living Spec (`current-feature.md`)
|
|
45
|
+
Append or update `## 5. Verification Evidence` in `devflow/context/current-feature.md` in **Thai (`th`)**:
|
|
46
46
|
|
|
47
47
|
```markdown
|
|
48
48
|
## 5. Verification Evidence
|
|
@@ -64,5 +64,5 @@ Update `devflow/context/current-stage.md`:
|
|
|
64
64
|
### 5. Output Summary & Next Step
|
|
65
65
|
Report to the user:
|
|
66
66
|
- Summary of verification results across all lanes
|
|
67
|
-
- Evidence recorded in `
|
|
68
|
-
- **Next Command**: `/complete` (or `/complete {
|
|
67
|
+
- Evidence recorded in `devflow/context/current-feature.md`
|
|
68
|
+
- **Next Command**: `/complete` (or `/complete {ID}`)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ci
|
|
3
|
-
description: "[Devflow]
|
|
3
|
+
description: "[Devflow] Set up automated GitHub Actions CI workflow (.github/workflows/verify.yml) aligned with project verify command."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# CI/CD Pipeline Automation & Quality Gates
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: complete
|
|
3
|
-
description: "[Devflow] Fast-Track Complete stage in DevFlow (Blueprint Mode) -
|
|
3
|
+
description: "[Devflow] Fast-Track Complete stage in DevFlow (Blueprint Mode) - final safety pass, archive living spec into categorized history, reset stub, git merge, and close run."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Final delivery, safety pass, and run closure stage in Fast-Track. Validates verification status,
|
|
11
|
+
Final delivery, safety pass, archive, and run closure stage in Fast-Track. Validates verification status, archives `devflow/context/current-feature.md` to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`, resets the stub, performs git merge, and closes the run **without auto-generating HTML reports**.
|
|
12
12
|
|
|
13
13
|
## Invocations & Aliases
|
|
14
14
|
|
|
15
15
|
- `/complete`: Complete current active run
|
|
16
|
-
- `/complete {
|
|
16
|
+
- `/complete {id}`: Complete specified ID
|
|
17
17
|
- `$complete`: Codex CLI invocation
|
|
18
18
|
|
|
19
19
|
## Fast-Track Mainline Workflow
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
/
|
|
22
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## Behavior & Contract
|
|
@@ -27,47 +27,68 @@ Final delivery, safety pass, and run closure stage in Fast-Track. Validates veri
|
|
|
27
27
|
When invoked:
|
|
28
28
|
|
|
29
29
|
### 1. Validate Delivery Pre-conditions
|
|
30
|
-
1. Identify active Running ID from `devflow/context/current-stage.md` or
|
|
31
|
-
2. Read `devflow/
|
|
30
|
+
1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
|
|
31
|
+
2. Read `devflow/context/current-feature.md`.
|
|
32
32
|
3. Confirm:
|
|
33
|
+
- File contains an active spec (not the idle stub `_Nothing in progress._`).
|
|
33
34
|
- All checklist items in `## 3. Implementation Checklist` are marked `- [x]`.
|
|
34
|
-
- `## 5. Verification Evidence` contains passing verification results.
|
|
35
|
+
- `## 5. Verification Evidence` contains passing verification results and empirical command outputs.
|
|
35
36
|
|
|
36
|
-
### 2. Final Safety Pass &
|
|
37
|
+
### 2. Final Safety Pass & Findings Check
|
|
37
38
|
1. Verify working directory hygiene (no accidental leftover test files or debug statements).
|
|
38
|
-
2.
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
39
|
+
2. Inspect `devflow/context/findings.md`:
|
|
40
|
+
- No `P0` or `P1` finding is in `open` or `fixed` status (`fixed` requires re-audit).
|
|
41
|
+
- Only `closed`, `accepted` (user waived), or `invalid` findings are permitted for completion.
|
|
42
|
+
|
|
43
|
+
### 3. Update Living Spec & Archive to Categorized History
|
|
44
|
+
1. Append `## 6. Release & Handoff` in `current-feature.md` in **Thai (`th`)**:
|
|
45
|
+
```markdown
|
|
46
|
+
## 6. Release & Handoff
|
|
47
|
+
- **Release Digest**: สรุปสิ่งที่ส่งมอบในรอบนี้
|
|
48
|
+
- **Git Branch**: `{branch_name}`
|
|
49
|
+
- **Merge Status**: Merged into `main` (Commit `{commit_hash}`)
|
|
50
|
+
- **Archive Date**: {YYYY-MM-DD}
|
|
51
|
+
```
|
|
52
|
+
2. Determine Category:
|
|
53
|
+
- If spec has `Category: Fix` or `Type: Fix` ➔ `fixes`
|
|
54
|
+
- If spec has `Category: Rollback` or `Type: Rollback` ➔ `rollbacks`
|
|
55
|
+
- Otherwise ➔ `features`
|
|
56
|
+
3. Archive `devflow/context/current-feature.md` ➔ `devflow/history/{category}/{xxx-slug}.md`.
|
|
57
|
+
4. If `findings.md` contains resolved entries (`closed`, `accepted`, `invalid`), append a `## Resolved Findings` section to the archive file and clean those resolved entries from `findings.md`.
|
|
58
|
+
5. **Reset Living Spec Stub**: Reset `devflow/context/current-feature.md` to:
|
|
59
|
+
```markdown
|
|
60
|
+
# Current Feature
|
|
61
|
+
|
|
62
|
+
_Nothing in progress. Run /feature, /fix, or /rollback to start._
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### 4. Update Master Ledger (`HISTORY.md`)
|
|
66
|
+
Append a new row to `devflow/history/HISTORY.md` under `## 📜 Master Release Log`:
|
|
43
67
|
```markdown
|
|
44
|
-
|
|
45
|
-
- **Release Digest**: สรุปสิ่งที่ส่งมอบในรอบนี้
|
|
46
|
-
- **Git Branch**: `{branch_name}`
|
|
47
|
-
- **Merge Status**: Merged into `main` (Commit `{commit_hash}`)
|
|
48
|
-
- **Artifact Contract**: Fast-Track Single Living Spec completed.
|
|
68
|
+
| {YYYY-MM-DD} | `{ID}` | {Category} | {Title} | `{commit_hash}` | `Released` | [`{xxx-slug}.md`]({category}/{xxx-slug}.md) |
|
|
49
69
|
```
|
|
50
|
-
Update header status in `spec.md`: `> **Status**: Completed`.
|
|
51
70
|
|
|
52
|
-
###
|
|
71
|
+
### 5. Policy on HTML Reports (Strict Rule)
|
|
53
72
|
> [!IMPORTANT]
|
|
54
73
|
> **No Auto-Generated HTML**: ห้ามสร้างไฟล์ `report.html` หรือ `60-report.html` แบบอัตโนมัติในขั้นตอนนี้โดยเด็ดขาด!
|
|
55
74
|
> หากผู้ใช้ต้องการดู HTML Dashboard สวยงาม ให้แจ้งผู้ใช้ว่าสามารถเรียกคำสั่งแยกได้: `/report:html`
|
|
56
75
|
|
|
57
|
-
###
|
|
58
|
-
1. Commit all modified tracking files
|
|
59
|
-
2.
|
|
76
|
+
### 6. Git Merge & Branch Cleanup
|
|
77
|
+
1. Commit all modified tracking files.
|
|
78
|
+
2. Squash-merge feature branch into target base branch (`main` / `master`) with explicit user approval.
|
|
60
79
|
|
|
61
|
-
###
|
|
80
|
+
### 7. Close Active Run
|
|
62
81
|
Update `devflow/context/current-stage.md`:
|
|
82
|
+
- `Active Discovery ID`: `None`
|
|
63
83
|
- `Active Running ID`: `None (Idle)`
|
|
64
|
-
- `Current Stage`: `Idle (Ready for new /
|
|
65
|
-
- `
|
|
84
|
+
- `Current Stage`: `Idle (Ready for new /feature, /fix, or /00-discover)`
|
|
85
|
+
- `Living Spec`: `None`
|
|
86
|
+
- `Last Completed Run`: `{ID} ({YYYY-MM-DD})`
|
|
66
87
|
- `Last Updated`: `{YYYY-MM-DD}`
|
|
67
88
|
|
|
68
|
-
###
|
|
89
|
+
### 8. Output Completion Report
|
|
69
90
|
Report to the user:
|
|
70
91
|
- Run successfully completed and merged
|
|
71
|
-
-
|
|
92
|
+
- Archived path: `devflow/history/{category}/{xxx-slug}.md`
|
|
72
93
|
- Standalone HTML command tip: `/report:html` (if HTML view is desired)
|
|
73
94
|
- Workspace is now Idle and ready for the next task.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: deploy
|
|
3
|
-
description: "[Devflow] Production deployment pre-flight checks,
|
|
3
|
+
description: "[Devflow] Production deployment pre-flight checks, smoke validation, and deployment execution."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Production Deployment & Launch Readiness
|
|
@@ -16,7 +16,7 @@ Use this skill to guide the user on what to do next, inspect current workspace s
|
|
|
16
16
|
|
|
17
17
|
Nexus-DevFlow supports two seamless workflow tracks:
|
|
18
18
|
1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: `/spec` ➔ `/implement` ➔ `/check` ➔ `/complete`
|
|
19
|
-
*Driven by a **Single Living Spec (`
|
|
19
|
+
*Driven by a **Single Living Spec (`current-feature.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
|
|
20
20
|
2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `00-discover` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-release`
|
|
21
21
|
*Driven by modular separate stage files for large, high-stakes architectural epics and multi-agent coordination.*
|
|
22
22
|
|
|
@@ -28,8 +28,8 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
28
28
|
|
|
29
29
|
1. **Project Setup Baseline**: Read `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`. If empty or default placeholders, recommend `onboard` (for fresh projects) or `adopt` (for existing codebases).
|
|
30
30
|
2. **Active Delivery Run**: Read `devflow/context/current-stage.md` and check `devflow/runs/{RUNNING_ID}/`.
|
|
31
|
-
- **If Fast-Track (`spec.md
|
|
32
|
-
- If `spec.md` has incomplete checklist items -> Recommend `/implement` (or `implement {RUNNING_ID}`).
|
|
31
|
+
- **If Fast-Track (`current-feature.md`, `spec.md`, or `blueprint.md` present)**:
|
|
32
|
+
- If `current-feature.md` (or `spec.md`) has incomplete checklist items -> Recommend `/implement` (or `implement {RUNNING_ID}`).
|
|
33
33
|
- If all tasks done but no passing verification evidence -> Recommend `/check` (or `check {RUNNING_ID}`).
|
|
34
34
|
- If verification evidence passed -> Recommend `/complete` (or `complete {RUNNING_ID}`).
|
|
35
35
|
- **If Deep-Track (numbered stage files present)**:
|
|
@@ -61,7 +61,7 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
61
61
|
| **"Execute implementation tasks"** | `implement` | `/implement` | **Fast-Track**: `/implement` -> `/check` |
|
|
62
62
|
| **"Run QA verification & check"** | `check` | `/check` | **Fast-Track**: `/check` -> `/complete` |
|
|
63
63
|
| **"Complete run & git merge"** | `complete` | `/complete` | **Fast-Track**: `/complete` |
|
|
64
|
-
| **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts `
|
|
64
|
+
| **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts `current-feature.md` / `60-report.md` to HTML |
|
|
65
65
|
| "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/spec` or `10-define` |
|
|
66
66
|
| "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/spec` or `10-define` |
|
|
67
67
|
| "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
|
|
@@ -85,7 +85,7 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
85
85
|
## Available Skills Sitemap
|
|
86
86
|
|
|
87
87
|
### 1. Fast-Track (Blueprint Mode - 4 Steps)
|
|
88
|
-
- `spec` (`/spec`, `/feature`, `/fix`, `$spec`) - Define, spec, plan, and create `
|
|
88
|
+
- `spec` (`/spec`, `/feature`, `/fix`, `$spec`) - Define, spec, plan, and create `current-feature.md`
|
|
89
89
|
- `implement` (`/implement`, `$implement`) - Execute planned checklist tasks with TDD
|
|
90
90
|
- `check` (`/check`, `$check`) - Senior QA review, multi-lane verification, record evidence
|
|
91
91
|
- `complete` (`/complete`, `$complete`) - Safety pass, release digest, git merge, close run
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: feature
|
|
3
|
-
description: "[Devflow] Fast-Track Feature stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living
|
|
3
|
+
description: "[Devflow] Fast-Track Feature stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living current-feature.md contract in context for new features."
|
|
4
4
|
argument-hint: "{feature title, IDEA-xxx, or feature description}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ argument-hint: "{feature title, IDEA-xxx, or feature description}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
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 (`
|
|
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 (`devflow/context/current-feature.md`)** for the feature run. Supports intake from Idea Inbox (`IDEA-xxx`).
|
|
12
12
|
|
|
13
13
|
## Invocations & Aliases
|
|
14
14
|
|
|
@@ -26,25 +26,31 @@ Fast-Track entry point combining Discovery, Definition, Specification, and Imple
|
|
|
26
26
|
|
|
27
27
|
When invoked:
|
|
28
28
|
|
|
29
|
-
### 1.
|
|
30
|
-
1. Inspect `devflow/context/current-stage.md` and `devflow/
|
|
31
|
-
2.
|
|
29
|
+
### 1. Single Active Run Guardrail (One Thing at a Time)
|
|
30
|
+
1. Inspect `devflow/context/current-stage.md` and `devflow/context/current-feature.md`.
|
|
31
|
+
2. If `Active Running ID` is not `None` and `Current Stage` is not `Idle`, or if `current-feature.md` contains an active uncompleted spec:
|
|
32
|
+
- **HALT and reject opening a new feature**.
|
|
33
|
+
- Explain to the user that an active run is currently in progress:
|
|
34
|
+
> ⚠️ *"มีงาน `{active_id}` กำลังดำเนินการอยู่ กรุณาปิดงานเดิมด้วย `/complete` หรือ `70-release` (หรือสั่ง `/rollback`) ก่อนเริ่มงานใหม่"*
|
|
35
|
+
|
|
36
|
+
### 2. Work Identity & Idea Intake
|
|
37
|
+
1. **Idea Inbox Intake**: If the argument is an idea identifier (e.g. `IDEA-001`):
|
|
32
38
|
- Read `devflow/ideas.md` and extract the idea's title, raw problem statement, AI Feasibility notes, and Quick Seed points.
|
|
33
39
|
- Use these details as the primary input for Specification & Scope.
|
|
34
|
-
- In `devflow/ideas.md`, update the item's status to `[x] Claimed ({
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
- `feature/{slug}
|
|
38
|
-
5. Create directory `devflow/runs/{RUNNING_ID}/`.
|
|
40
|
+
- In `devflow/ideas.md`, update the item's status to `[x] Claimed ({ID})` and move it under `## 📦 Archived / Shipped Ideas`.
|
|
41
|
+
2. Inspect `devflow/history/HISTORY.md` and determine the next sequential ID without prefix (e.g. `022-{slug}`).
|
|
42
|
+
3. Identify Git branch naming:
|
|
43
|
+
- `feature/{xxx-slug}`
|
|
39
44
|
|
|
40
|
-
###
|
|
41
|
-
Write `devflow/
|
|
45
|
+
### 3. Generate the Living Spec (`devflow/context/current-feature.md`)
|
|
46
|
+
Write `devflow/context/current-feature.md` using the structured template below in **Thai (`th`)**:
|
|
42
47
|
|
|
43
48
|
```markdown
|
|
44
|
-
# 📐 [{
|
|
49
|
+
# 📐 [{ID}] {Feature Title} (Living Spec)
|
|
45
50
|
|
|
46
51
|
> **Status**: In-Progress
|
|
47
52
|
> **Track**: Fast-Track (Blueprint Mode - Feature)
|
|
53
|
+
> **Category**: Feature
|
|
48
54
|
> **Branch**: `{branch_name}`
|
|
49
55
|
> **Created Date**: {YYYY-MM-DD}
|
|
50
56
|
> **Owner**: {Contributor or Team}
|
|
@@ -87,17 +93,16 @@ Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in
|
|
|
87
93
|
- *(จะถูกบันทึกเมื่อรัน /complete)*
|
|
88
94
|
```
|
|
89
95
|
|
|
90
|
-
###
|
|
96
|
+
### 4. Update Workspace Status
|
|
91
97
|
Update `devflow/context/current-stage.md`:
|
|
92
|
-
- `Active
|
|
98
|
+
- `Active Discovery ID`: `None`
|
|
99
|
+
- `Active Running ID`: `{ID}`
|
|
93
100
|
- `Current Stage`: `feature (Fast-Track -> Ready for /implement)`
|
|
94
|
-
- `Living Spec`: `devflow/
|
|
101
|
+
- `Living Spec`: `devflow/context/current-feature.md`
|
|
95
102
|
- `Last Updated`: `{YYYY-MM-DD}`
|
|
96
103
|
|
|
97
|
-
###
|
|
104
|
+
### 5. Output Summary & Next Step
|
|
98
105
|
Report to the user:
|
|
99
106
|
- Running ID and allocated branch
|
|
100
107
|
- Summary of Scope and Acceptance Criteria
|
|
101
|
-
-
|
|
102
|
-
- If promoted from `IDEA-xxx`, confirm status update in `devflow/ideas.md`
|
|
103
|
-
- **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
|
|
108
|
+
- Explicit next step: `/implement`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: fix
|
|
3
|
-
description: "[Devflow] Fast-Track Fix stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living
|
|
3
|
+
description: "[Devflow] Fast-Track Fix stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living current-feature.md contract in context for bug fixes."
|
|
4
4
|
argument-hint: "{bug description, issue ID, or IDEA-xxx}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ argument-hint: "{bug description, issue ID, or IDEA-xxx}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
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 (`
|
|
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 (`devflow/context/current-feature.md`)** for the fix run.
|
|
12
12
|
|
|
13
13
|
## Invocations & Aliases
|
|
14
14
|
|
|
@@ -26,24 +26,30 @@ Fast-Track entry point combining Bug Triage, Root Cause Isolation, Specification
|
|
|
26
26
|
|
|
27
27
|
When invoked:
|
|
28
28
|
|
|
29
|
-
### 1.
|
|
30
|
-
1. Inspect `devflow/context/current-stage.md` and `devflow/
|
|
31
|
-
2.
|
|
29
|
+
### 1. Single Active Run Guardrail (One Thing at a Time)
|
|
30
|
+
1. Inspect `devflow/context/current-stage.md` and `devflow/context/current-feature.md`.
|
|
31
|
+
2. If `Active Running ID` is not `None` and `Current Stage` is not `Idle`, or if `current-feature.md` contains an active uncompleted spec:
|
|
32
|
+
- **HALT and reject opening a new fix**.
|
|
33
|
+
- Explain to the user that an active run is currently in progress:
|
|
34
|
+
> ⚠️ *"มีงาน `{active_id}` กำลังดำเนินการอยู่ กรุณาปิดงานเดิมด้วย `/complete` หรือ `70-release` (หรือสั่ง `/rollback`) ก่อนเริ่มงานใหม่"*
|
|
35
|
+
|
|
36
|
+
### 2. Work Identity & Issue Intake
|
|
37
|
+
1. **Idea / Issue Inbox Intake**: If the argument is an identifier (e.g. `IDEA-001`):
|
|
32
38
|
- 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 ({
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
- `fix/{slug}
|
|
37
|
-
5. Create directory `devflow/runs/{RUNNING_ID}/`.
|
|
39
|
+
- In `devflow/ideas.md`, update status to `[x] Claimed ({ID})` and move under `## 📦 Archived / Shipped Ideas`.
|
|
40
|
+
2. Inspect `devflow/history/HISTORY.md` and determine the next sequential ID without prefix (e.g. `022-{slug}`).
|
|
41
|
+
3. Identify Git branch naming:
|
|
42
|
+
- `fix/{xxx-slug}`
|
|
38
43
|
|
|
39
|
-
###
|
|
40
|
-
Write `devflow/
|
|
44
|
+
### 3. Generate the Living Spec (`devflow/context/current-feature.md`)
|
|
45
|
+
Write `devflow/context/current-feature.md` using the structured template below in **Thai (`th`)**:
|
|
41
46
|
|
|
42
47
|
```markdown
|
|
43
|
-
# 📐 [{
|
|
48
|
+
# 📐 [{ID}] {Bug/Fix Title} (Living Spec)
|
|
44
49
|
|
|
45
50
|
> **Status**: In-Progress
|
|
46
51
|
> **Track**: Fast-Track (Blueprint Mode - Fix)
|
|
52
|
+
> **Category**: Fix
|
|
47
53
|
> **Branch**: `{branch_name}`
|
|
48
54
|
> **Created Date**: {YYYY-MM-DD}
|
|
49
55
|
> **Owner**: {Contributor or Team}
|
|
@@ -87,16 +93,16 @@ Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in
|
|
|
87
93
|
- *(จะถูกบันทึกเมื่อรัน /complete)*
|
|
88
94
|
```
|
|
89
95
|
|
|
90
|
-
###
|
|
96
|
+
### 4. Update Workspace Status
|
|
91
97
|
Update `devflow/context/current-stage.md`:
|
|
92
|
-
- `Active
|
|
98
|
+
- `Active Discovery ID`: `None`
|
|
99
|
+
- `Active Running ID`: `{ID}`
|
|
93
100
|
- `Current Stage`: `fix (Fast-Track -> Ready for /implement)`
|
|
94
|
-
- `Living Spec`: `devflow/
|
|
101
|
+
- `Living Spec`: `devflow/context/current-feature.md`
|
|
95
102
|
- `Last Updated`: `{YYYY-MM-DD}`
|
|
96
103
|
|
|
97
|
-
###
|
|
104
|
+
### 5. Output Summary & Next Step
|
|
98
105
|
Report to the user:
|
|
99
106
|
- Running ID and allocated branch
|
|
100
107
|
- Summary of Scope, Reproduction, and Acceptance Criteria
|
|
101
|
-
-
|
|
102
|
-
- **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
|
|
108
|
+
- Explicit next step: `/implement`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: implement
|
|
3
|
-
description: "[Devflow] Fast-Track Implement stage in DevFlow (Blueprint Mode) - execute checklist tasks incrementally with TDD and update
|
|
3
|
+
description: "[Devflow] Fast-Track Implement stage in DevFlow (Blueprint Mode) - execute checklist tasks incrementally with TDD and update current-feature.md in context."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`
|
|
11
|
+
Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`devflow/context/current-feature.md`), executes checklist tasks, implements tests (TDD), and updates the implementation record.
|
|
12
12
|
|
|
13
13
|
## Invocations & Aliases
|
|
14
14
|
|
|
15
15
|
- `/implement`: Run implementation on current active run
|
|
16
|
-
- `/implement {
|
|
16
|
+
- `/implement {id}`: Run implementation on specified ID
|
|
17
17
|
- `$implement`: Codex CLI invocation
|
|
18
18
|
|
|
19
19
|
## Fast-Track Mainline Workflow
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
/
|
|
22
|
+
/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## Behavior & Contract
|
|
@@ -27,8 +27,8 @@ Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`s
|
|
|
27
27
|
When invoked:
|
|
28
28
|
|
|
29
29
|
### 1. Load Active Context
|
|
30
|
-
1. Identify active Running ID from `devflow/context/current-stage.md` or
|
|
31
|
-
2. Read `devflow/
|
|
30
|
+
1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
|
|
31
|
+
2. Read `devflow/context/current-feature.md`.
|
|
32
32
|
3. Locate `## 2. Plan & Test Strategy` and `## 3. Implementation Checklist`.
|
|
33
33
|
|
|
34
34
|
### 2. Incremental Execution with TDD
|
|
@@ -37,10 +37,10 @@ When invoked:
|
|
|
37
37
|
- **TDD (Red-Green-Refactor)**: When `Test Decision: Required`, create or update unit tests first.
|
|
38
38
|
- Implement the minimal, clean code change satisfying the task.
|
|
39
39
|
- Run localized verification (e.g. `npm test`, linter).
|
|
40
|
-
- Mark the item as `- [x]` in `
|
|
40
|
+
- Mark the item as `- [x]` in `current-feature.md`.
|
|
41
41
|
|
|
42
|
-
### 3. Update Living Spec (`
|
|
43
|
-
Append or update `## 4. Implementation Record` in `
|
|
42
|
+
### 3. Update Living Spec (`current-feature.md`)
|
|
43
|
+
Append or update `## 4. Implementation Record` in `devflow/context/current-feature.md` with:
|
|
44
44
|
- Summary of completed tasks and modified files
|
|
45
45
|
- Key architectural observations or notes
|
|
46
46
|
- Status of checklist items
|
|
@@ -61,4 +61,4 @@ Update `devflow/context/current-stage.md`:
|
|
|
61
61
|
Report to the user:
|
|
62
62
|
- Completed checklist items and modified files
|
|
63
63
|
- Local verification results
|
|
64
|
-
- **Next Command**: `/check` (or `/check {
|
|
64
|
+
- **Next Command**: `/check` (or `/check {ID}`)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: insight
|
|
3
|
-
description: "[Devflow] Extract reusable lessons,
|
|
3
|
+
description: "[Devflow] Extract reusable lessons, patterns, file insights, and post-mortem learning from completed work."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Insight Extraction & Post-Mortem Learning
|
|
@@ -13,7 +13,7 @@ codebase + devflow/history/HISTORY.md -> [overview] -> devflow/context/proje
|
|
|
13
13
|
synthesize)
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
`overview` is the context synchronization and synthesis engine for Nexus-DevFlow. It inspects the actual codebase (manifest, dependencies, directory layout, models/schemas, entry points) along with the completed delivery history (`devflow/history/HISTORY.md` and `devflow/
|
|
16
|
+
`overview` is the context synchronization and synthesis engine for Nexus-DevFlow. It inspects the actual codebase (manifest, dependencies, directory layout, models/schemas, entry points) along with the completed delivery history (`devflow/history/HISTORY.md` and `devflow/history/`) to build or refresh `devflow/context/project-overview.md`.
|
|
17
17
|
|
|
18
18
|
It ensures that `project-overview.md` remains a **Living Source of Truth** that evolves alongside your software, rather than a stale artifact left behind after onboarding.
|
|
19
19
|
|
|
@@ -26,7 +26,7 @@ overview
|
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Use this when:
|
|
29
|
-
- Multiple delivery runs (`
|
|
29
|
+
- Multiple delivery runs (`xxx-slug`) have shipped and `project-overview.md` needs to reflect newly added capabilities.
|
|
30
30
|
- New database schemas, ORM models, or API boundaries were introduced.
|
|
31
31
|
- Major dependencies or architectural patterns were added or modified.
|
|
32
32
|
- After completing `70-release` to keep project context perfectly aligned.
|
|
@@ -59,7 +59,7 @@ Inspect the actual codebase to establish hard facts:
|
|
|
59
59
|
Inspect DevFlow history records:
|
|
60
60
|
|
|
61
61
|
1. Read `devflow/history/HISTORY.md` for completed and released milestones.
|
|
62
|
-
2. Scan completed delivery runs in `devflow/
|
|
62
|
+
2. Scan completed delivery runs in `devflow/history/features/`, `devflow/history/fixes/`, and `devflow/history/rollbacks/` to extract shipped user-visible capabilities and core system features.
|
|
63
63
|
|
|
64
64
|
---
|
|
65
65
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: report-html
|
|
3
|
-
description: "[Devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from
|
|
3
|
+
description: "[Devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or 60-report.md on demand."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ argument-hint: "{running-id or workspace path}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `
|
|
11
|
+
Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `current-feature.md` or a Deep-Track `60-report.md`.
|
|
12
12
|
|
|
13
13
|
> [!NOTE]
|
|
14
14
|
> HTML reports are **never automatically generated** during normal mainline stages (`/complete` or `60-report`). Use this command whenever you or stakeholders wish to view or share an interactive web report.
|
|
@@ -27,7 +27,7 @@ When invoked:
|
|
|
27
27
|
### 1. Identify Target Run
|
|
28
28
|
1. Locate target run directory in `devflow/runs/{running-id}` from argument or `devflow/context/current-stage.md`.
|
|
29
29
|
2. Check for either:
|
|
30
|
-
- Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/
|
|
30
|
+
- Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/current-feature.md` (or `spec.md` / `blueprint.md`)
|
|
31
31
|
- Deep-Track Report Digest: `devflow/runs/{RUNNING_ID}/60-report.md`
|
|
32
32
|
|
|
33
33
|
### 2. Render Interactive HTML Dashboard
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: security-review
|
|
3
|
-
description: "[Devflow]
|
|
3
|
+
description: "[Devflow] High-severity security code review and vulnerability audit for folders, projects, files, or diffs."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Security Review, Hardening & Vulnerability Audit
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: spec
|
|
3
|
-
description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the
|
|
3
|
+
description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the living current-feature.md contract in context."
|
|
4
4
|
argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
|
|
|
8
8
|
|
|
9
9
|
$ARGUMENTS
|
|
10
10
|
|
|
11
|
-
Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`
|
|
11
|
+
Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`devflow/context/current-feature.md`)**.
|
|
12
12
|
|
|
13
13
|
> [!TIP]
|
|
14
14
|
> **Preferred Commands**:
|
|
@@ -32,7 +32,8 @@ Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and
|
|
|
32
32
|
|
|
33
33
|
When invoked:
|
|
34
34
|
|
|
35
|
-
1.
|
|
36
|
-
2.
|
|
37
|
-
3.
|
|
38
|
-
4.
|
|
35
|
+
1. Checks Single Active Run Guardrail: rejects if an uncompleted active run already exists in `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
|
|
36
|
+
2. If the input describes a bug or hotfix, routes to `/fix` behavior.
|
|
37
|
+
3. Otherwise, routes to `/feature` behavior.
|
|
38
|
+
4. Allocates sequential ID without prefix (`xxx-slug`), generates `devflow/context/current-feature.md` in **Thai (`th`)**.
|
|
39
|
+
5. Updates `devflow/context/current-stage.md` and reports next step: `/implement`.
|
|
@@ -83,8 +83,8 @@ Don't silently fill in ambiguous requirements. The spec's entire purpose is to s
|
|
|
83
83
|
|
|
84
84
|
Every specification must stand on its own in markdown under `devflow/runs/{ID}-*/`:
|
|
85
85
|
|
|
86
|
-
1. **`
|
|
87
|
-
2. **`spec.md`**:
|
|
86
|
+
1. **`current-feature.md`**: Fast-Track Single Living Spec delivery contract.
|
|
87
|
+
2. **`20-spec.md`**: Deep-Track formal specification delivery contract.
|
|
88
88
|
|
|
89
89
|
**Spec template:**
|
|
90
90
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: test
|
|
3
|
-
description: "[Devflow] Test
|
|
3
|
+
description: "[Devflow] Test execution, missing test generation, and coverage analysis across unit, integration, and smoke test suites."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Test-Driven Development, Generation & Execution
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
---
|
|
2
|
-
|
|
1
|
+
---
|
|
2
|
+
name: 00-discover
|
|
3
3
|
description: "[Devflow] Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID."
|
|
4
4
|
argument-hint: "{title, request, or discovery-id}"
|
|
5
5
|
---
|