@jakkrichm/create-nexus-devflow 2.0.13 → 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.
Files changed (102) hide show
  1. package/README.md +4 -4
  2. package/dist/bin/create-nexus-devflow.d.ts +2 -0
  3. package/dist/bin/create-nexus-devflow.js +233 -0
  4. package/dist/bin/create-nexus-devflow.js.map +1 -0
  5. package/dist/lib/starter-templates.d.ts +6 -0
  6. package/dist/lib/starter-templates.js +8 -0
  7. package/dist/lib/starter-templates.js.map +1 -0
  8. package/dist/lib/update.d.ts +68 -0
  9. package/dist/lib/update.js +325 -0
  10. package/dist/lib/update.js.map +1 -0
  11. package/dist/scripts/clean-template.d.ts +1 -0
  12. package/dist/scripts/clean-template.js +14 -0
  13. package/dist/scripts/clean-template.js.map +1 -0
  14. package/dist/scripts/prepare-template.d.ts +1 -0
  15. package/dist/scripts/prepare-template.js +89 -0
  16. package/dist/scripts/prepare-template.js.map +1 -0
  17. package/package.json +11 -9
  18. package/template/.agents/skills/00-discover/SKILL.md +2 -0
  19. package/template/.agents/skills/30-plan/SKILL.md +6 -6
  20. package/template/{.claude/skills/40-implement → .agents/skills/40-execute}/SKILL.md +21 -26
  21. package/template/.agents/skills/50-verify/SKILL.md +10 -10
  22. package/template/.agents/skills/60-report/SKILL.md +22 -76
  23. package/template/.agents/skills/70-release/SKILL.md +11 -10
  24. package/template/.agents/skills/agent/SKILL.md +3 -3
  25. package/template/.agents/skills/autopilot/SKILL.md +6 -6
  26. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  27. package/template/.agents/skills/brief/SKILL.md +1 -1
  28. package/template/.agents/skills/check/SKILL.md +68 -0
  29. package/template/.agents/skills/codebase-design/SKILL.md +2 -2
  30. package/template/.agents/skills/commit/SKILL.md +1 -1
  31. package/template/.agents/skills/complete/SKILL.md +73 -0
  32. package/template/.agents/skills/debug/SKILL.md +2 -2
  33. package/template/.agents/skills/devflow/SKILL.md +89 -80
  34. package/template/.agents/skills/doctor/SKILL.md +1 -1
  35. package/template/.agents/skills/feature/SKILL.md +103 -0
  36. package/template/.agents/skills/fix/SKILL.md +102 -0
  37. package/template/.agents/skills/followup/SKILL.md +5 -5
  38. package/template/.agents/skills/help/SKILL.md +4 -4
  39. package/template/.agents/skills/idea/SKILL.md +57 -0
  40. package/template/.agents/skills/implement/SKILL.md +64 -0
  41. package/template/.agents/skills/insight/SKILL.md +1 -1
  42. package/template/.agents/skills/overview/SKILL.md +114 -0
  43. package/template/.agents/skills/pr/SKILL.md +1 -1
  44. package/template/.agents/skills/preview/SKILL.md +1 -1
  45. package/template/.agents/skills/report-html/SKILL.md +45 -0
  46. package/template/.agents/skills/review/SKILL.md +1 -1
  47. package/template/.agents/skills/rollback/SKILL.md +3 -3
  48. package/template/.agents/skills/security-review/SKILL.md +2 -2
  49. package/template/.agents/skills/simplify/SKILL.md +1 -1
  50. package/template/.agents/skills/spec/SKILL.md +38 -0
  51. package/template/.agents/skills/test/SKILL.md +2 -2
  52. package/template/.agents/skills/try/SKILL.md +2 -2
  53. package/template/.claude/skills/00-discover/SKILL.md +2 -0
  54. package/template/.claude/skills/30-plan/SKILL.md +6 -6
  55. package/template/{.agents/skills/40-implement → .claude/skills/40-execute}/SKILL.md +21 -26
  56. package/template/.claude/skills/50-verify/SKILL.md +10 -10
  57. package/template/.claude/skills/60-report/SKILL.md +22 -76
  58. package/template/.claude/skills/70-release/SKILL.md +11 -10
  59. package/template/.claude/skills/agent/SKILL.md +3 -3
  60. package/template/.claude/skills/autopilot/SKILL.md +6 -6
  61. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  62. package/template/.claude/skills/brief/SKILL.md +1 -1
  63. package/template/.claude/skills/check/SKILL.md +68 -0
  64. package/template/.claude/skills/codebase-design/SKILL.md +2 -2
  65. package/template/.claude/skills/commit/SKILL.md +1 -1
  66. package/template/.claude/skills/complete/SKILL.md +73 -0
  67. package/template/.claude/skills/debug/SKILL.md +2 -2
  68. package/template/.claude/skills/devflow/SKILL.md +89 -80
  69. package/template/.claude/skills/doctor/SKILL.md +1 -1
  70. package/template/.claude/skills/feature/SKILL.md +103 -0
  71. package/template/.claude/skills/fix/SKILL.md +102 -0
  72. package/template/.claude/skills/followup/SKILL.md +5 -5
  73. package/template/.claude/skills/help/SKILL.md +4 -4
  74. package/template/.claude/skills/idea/SKILL.md +57 -0
  75. package/template/.claude/skills/implement/SKILL.md +64 -0
  76. package/template/.claude/skills/insight/SKILL.md +1 -1
  77. package/template/.claude/skills/overview/SKILL.md +114 -0
  78. package/template/.claude/skills/pr/SKILL.md +1 -1
  79. package/template/.claude/skills/preview/SKILL.md +1 -1
  80. package/template/.claude/skills/report-html/SKILL.md +45 -0
  81. package/template/.claude/skills/review/SKILL.md +1 -1
  82. package/template/.claude/skills/rollback/SKILL.md +3 -3
  83. package/template/.claude/skills/security-review/SKILL.md +2 -2
  84. package/template/.claude/skills/simplify/SKILL.md +1 -1
  85. package/template/.claude/skills/spec/SKILL.md +38 -0
  86. package/template/.claude/skills/test/SKILL.md +2 -2
  87. package/template/.claude/skills/try/SKILL.md +2 -2
  88. package/template/AGENTS.md +72 -74
  89. package/template/devflow/context/ai-interaction.md +3 -2
  90. package/template/devflow/context/coding-standards.md +31 -18
  91. package/template/devflow/context/current-stage.md +4 -3
  92. package/template/devflow/context/findings.md +10 -6
  93. package/template/devflow/context/project-overview.md +33 -11
  94. package/template/devflow/discoveries/.gitkeep +0 -0
  95. package/template/devflow/history/HISTORY.md +6 -0
  96. package/template/devflow/ideas.md +15 -0
  97. package/template/devflow/reference/running-id-contract.md +2 -2
  98. package/template/devflow/runs/.gitkeep +0 -0
  99. package/bin/create-nexus-devflow.js +0 -287
  100. package/lib/starter-templates.js +0 -111
  101. package/lib/update.js +0 -393
  102. package/template/.nexus/nexus-devflow.json +0 -44
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: implement
3
+ description: "[Devflow] Fast-Track Implement stage in DevFlow (Blueprint Mode) - execute checklist tasks incrementally with TDD and update spec.md."
4
+ argument-hint: "{running-id or workspace path}"
5
+ ---
6
+
7
+ # Fast-Track: Implement (Blueprint Mode)
8
+
9
+ $ARGUMENTS
10
+
11
+ Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`spec.md`), executes checklist tasks, implements tests (TDD), and updates the implementation record.
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/implement`: Run implementation on current active run
16
+ - `/implement {running-id}`: Run implementation on specified running ID
17
+ - `$implement`: Codex CLI invocation
18
+
19
+ ## Fast-Track Mainline Workflow
20
+
21
+ ```text
22
+ /spec ──▶ /implement ──▶ /check ──▶ /complete
23
+ ```
24
+
25
+ ## Behavior & Contract
26
+
27
+ When invoked:
28
+
29
+ ### 1. Load Active Context
30
+ 1. Identify active Running ID from `devflow/context/current-stage.md` or argument.
31
+ 2. Read `devflow/runs/{RUNNING_ID}/spec.md`.
32
+ 3. Locate `## 2. Plan & Test Strategy` and `## 3. Implementation Checklist`.
33
+
34
+ ### 2. Incremental Execution with TDD
35
+ 1. Select unchecked items `- [ ]` from the checklist in order.
36
+ 2. For each task:
37
+ - **TDD (Red-Green-Refactor)**: When `Test Decision: Required`, create or update unit tests first.
38
+ - Implement the minimal, clean code change satisfying the task.
39
+ - Run localized verification (e.g. `npm test`, linter).
40
+ - Mark the item as `- [x]` in `spec.md`.
41
+
42
+ ### 3. Update Living Spec (`spec.md`)
43
+ Append or update `## 4. Implementation Record` in `spec.md` with:
44
+ - Summary of completed tasks and modified files
45
+ - Key architectural observations or notes
46
+ - Status of checklist items
47
+
48
+ Example:
49
+ ```markdown
50
+ ## 4. Implementation Record
51
+ - **[Task 1.1]**: Implemented JWT auth middleware in `src/middleware/auth.ts`
52
+ - **[Task 1.2]**: Added unit tests in `test/auth.test.ts` (All 6 tests passing)
53
+ - **[Task 1.3]**: Registered auth route in `src/server.ts`
54
+ ```
55
+
56
+ ### 4. Update Workspace Status
57
+ Update `devflow/context/current-stage.md`:
58
+ - `Current Stage`: `implement (Fast-Track -> Checklist Completed -> Ready for /check)`
59
+
60
+ ### 5. Output Summary & Next Step
61
+ Report to the user:
62
+ - Completed checklist items and modified files
63
+ - Local verification results
64
+ - **Next Command**: `/check` (or `/check {RUNNING_ID}`)
@@ -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-implement.md`, `50-verify.md`, or test logs.
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`).
@@ -0,0 +1,114 @@
1
+ ---
2
+ name: overview
3
+ description: "[Devflow] Scan codebase architecture, data models, and shipped history to synthesize or refresh devflow/context/project-overview.md as the living source of truth."
4
+ ---
5
+
6
+ # overview - Living Context Synthesis & Sync
7
+
8
+ Where this sits in the workflow:
9
+
10
+ ```text
11
+ codebase + devflow/history/HISTORY.md -> [overview] -> devflow/context/project-overview.md -> 00-discover / 10-define / 20-spec
12
+ (reality & shipped runs) (sync & (living source of truth) (informed planning)
13
+ synthesize)
14
+ ```
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/runs/`) to build or refresh `devflow/context/project-overview.md`.
17
+
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
+
20
+ ## Usage
21
+
22
+ ```text
23
+ /overview
24
+ $overview
25
+ overview
26
+ ```
27
+
28
+ Use this when:
29
+ - Multiple delivery runs (`RUN-xxx`) have shipped and `project-overview.md` needs to reflect newly added capabilities.
30
+ - New database schemas, ORM models, or API boundaries were introduced.
31
+ - Major dependencies or architectural patterns were added or modified.
32
+ - After completing `70-release` to keep project context perfectly aligned.
33
+ - Preparing for a new initiative or discovery pass.
34
+
35
+ ---
36
+
37
+ ## Process
38
+
39
+ ### Step 1 - Scan Reality (Codebase Survey)
40
+
41
+ Inspect the actual codebase to establish hard facts:
42
+
43
+ 1. **Manifest & Tooling**:
44
+ - Read `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `pom.xml`, or `Gemfile`.
45
+ - Identify language versions, primary framework, state management, and build tools.
46
+ 2. **Directory Architecture**:
47
+ - Map high-level directory layout (`src/`, `app/`, `api/`, `lib/`, `components/`, etc.).
48
+ - Identify major modules, entry points, and routing conventions.
49
+ 3. **Concrete Data Models & Schemas**:
50
+ - Search for ORM schemas (`schema.prisma`, Drizzle schemas, TypeORM entities, SQLAlchemy models, Zod schemas, or core TypeScript types).
51
+ - Extract entity names, core fields, relationships, and invariants.
52
+ 4. **Verified Commands**:
53
+ - Inspect package scripts (`dev`, `build`, `test`, `lint`, `check`, `verify`).
54
+
55
+ ---
56
+
57
+ ### Step 2 - Scan History (Delivered Capabilities)
58
+
59
+ Inspect DevFlow history records:
60
+
61
+ 1. Read `devflow/history/HISTORY.md` for completed and released milestones.
62
+ 2. Scan completed delivery runs in `devflow/runs/` to extract shipped user-visible capabilities and core system features.
63
+
64
+ ---
65
+
66
+ ### Step 3 - Synthesize `project-overview.md`
67
+
68
+ Write or update `devflow/context/project-overview.md` following standard structure:
69
+
70
+ ```markdown
71
+ # Project Overview & Source of Truth
72
+
73
+ > Living context artifact automatically synchronized with codebase reality and DevFlow delivery history.
74
+
75
+ ## 1. Project Purpose & Target Users
76
+ - High-level summary of what the system does, who it serves, and the core problem it solves.
77
+
78
+ ## 2. Architecture & Directory Layout
79
+ - Visual directory layout tree with short descriptions for major modules and boundaries.
80
+
81
+ ## 3. Technology Stack & Key Tooling
82
+ - Frontend, Backend, Database, ORM, Testing frameworks, CI/CD, and Package Manager.
83
+
84
+ ## 4. Concrete Data Models & Entities
85
+ - Field-level definitions of major entities, types, and relationships.
86
+
87
+ ## 5. Shipped Capabilities & Key Modules
88
+ - Consolidated list of active features and subsystems verified in the codebase.
89
+
90
+ ## 6. Verified Commands & Developer Workflow
91
+ - Exact commands for Dev, Build, Test, Lint, and Verify.
92
+
93
+ ## 7. Known Architectural Focus Areas
94
+ - Known technical debt, active migrations, or upcoming architectural focus points.
95
+ ```
96
+
97
+ ---
98
+
99
+ ### Step 4 - Review & Report
100
+
101
+ Present a concise summary of the sync:
102
+ - Models or entities detected and added
103
+ - Shipped capabilities refreshed from history
104
+ - Stack and tooling updates
105
+ - Any inconsistencies or gaps found between code and documentation
106
+
107
+ ---
108
+
109
+ ## Rules & Guardrails
110
+
111
+ 1. **Grounded in Reality**: Never invent non-existent packages, fictional data models, or unverified endpoints. Everything in `project-overview.md` must be traceable to real code or recorded history.
112
+ 2. **Preserve User Intent**: Do not erase custom business rules or user-written notes. Integrate new facts smoothly around existing intent.
113
+ 3. **Concrete Over Vague**: Provide actual model names, field types, and route paths rather than vague one-line summaries.
114
+ 4. **Non-Destructive**: `overview` only writes to `devflow/context/project-overview.md`. It never modifies source code, runs migrations, or touches git history.
@@ -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-implement.md`
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-implement` (interactive visual check), `50-verify` (smoke test check)
41
+ - **Mainline stages**: `40-execute` (interactive visual check), `50-verify` (smoke test check)
42
42
  - **Handoff**: `50-verify`
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: report-html
3
+ description: "[Devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from spec.md or 60-report.md on demand."
4
+ argument-hint: "{running-id or workspace path}"
5
+ ---
6
+
7
+ # Standalone: Report HTML
8
+
9
+ $ARGUMENTS
10
+
11
+ Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `spec.md` or a Deep-Track `60-report.md`.
12
+
13
+ > [!NOTE]
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.
15
+
16
+ ## Invocations & Aliases
17
+
18
+ - `/report:html`: Generate HTML report for the active or most recent run
19
+ - `/report:html {running-id}`: Generate HTML report for the specified running ID
20
+ - `npm run report:html -- {running-id}`: CLI npm script invocation
21
+ - `$report:html`: Codex CLI invocation
22
+
23
+ ## Behavior & Contract
24
+
25
+ When invoked:
26
+
27
+ ### 1. Identify Target Run
28
+ 1. Locate target run directory in `devflow/runs/{running-id}` from argument or `devflow/context/current-stage.md`.
29
+ 2. Check for either:
30
+ - Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/spec.md` (or `blueprint.md`)
31
+ - Deep-Track Report Digest: `devflow/runs/{RUNNING_ID}/60-report.md`
32
+
33
+ ### 2. Render Interactive HTML Dashboard
34
+ Execute the HTML generation engine:
35
+ ```bash
36
+ npm run report:html -- {RUNNING_ID}
37
+ ```
38
+ Or execute the renderer to transform Markdown into a styled, standalone HTML document:
39
+ - Path: `devflow/runs/{RUNNING_ID}/report.html`
40
+
41
+ ### 3. Output
42
+ Provide:
43
+ - Generated HTML file path: `file:///devflow/runs/{RUNNING_ID}/report.html`
44
+ - Summary of sections rendered (Spec, Plan, Progress, QA Evidence, Release Notes)
45
+ - Instructions to open the file in any browser
@@ -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-implement` (for fixes), `50-verify`, `70-release`
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-implement (or fix run) -> 50-verify -> 70-release
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-implement.md`, `70-release.md`).
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-implement` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
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-implement` or `50-verify` before `70-release`.
63
- - **Handoff**: P0/P1 security findings block release and return to `40-implement` for immediate remediation.
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-implement` (Refactor step of TDD) or `50-verify`.
69
+ - **Mainline integration**: Used during `40-execute` (Refactor step of TDD) or `50-verify`.
70
70
  - **Handoff**: `50-verify` (proves zero regressions).
@@ -0,0 +1,38 @@
1
+ ---
2
+ name: 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
+ argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
5
+ ---
6
+
7
+ # Fast-Track: Spec Router (Blueprint Mode)
8
+
9
+ $ARGUMENTS
10
+
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
17
+
18
+ ## Invocations & Aliases
19
+
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
24
+
25
+ ## Fast-Track Mainline Workflow
26
+
27
+ ```text
28
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
29
+ ```
30
+
31
+ ## Behavior & Contract
32
+
33
+ When invoked:
34
+
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-implement` or `50-verify`:
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-implement` (TDD execution), `50-verify` (QA gate)
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-implement or 50-verify or 60-report -> [try] -> human review & verification
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-implement.md`, `50-verify.md` (or archived run artifacts)
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.
@@ -14,12 +14,14 @@ Explore a request before delivery commitment. Create or resume a Discovery ID, c
14
14
 
15
15
  ```text
16
16
  00-discover {title or request}
17
+ 00-discover IDEA-xxx
17
18
  00-discover {discovery-id}
18
19
  ```
19
20
 
20
21
  Use this when:
21
22
 
22
23
  - a new request needs discussion before the team commits to delivery
24
+ - exploring a pending idea from `devflow/ideas.md` (`00-discover IDEA-xxx`)
23
25
  - the best route may be `Brainstorm`, `PRD`, `Research`, or `Debug`
24
26
  - supporting findings need to be synthesized into a go/no-go decision
25
27
 
@@ -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-implement` enough context to select one scoped unit and execute it without inventing intent.
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-implement`, check whether the plan still shows pending review.
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-implement` as a soft recommendation only
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-implement` when execution steps and verification are clear
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-implement`
195
+ - Related commands: `20-spec`, `Research`, `Agent`, `40-execute`
196
196
 
197
197
  ## Next Workflow Recommendation
198
198
 
199
- - **Primary**: `40-implement {ID}`
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.
@@ -1,25 +1,23 @@
1
- ---name: 40-implement
2
-
3
- description: "[Devflow] Implement stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
4
1
  ---
5
- # Phase 40: Implement Code
2
+ name: 40-execute
3
+ description: "[Devflow] Execute stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
4
+ ---
5
+ # Phase 40: Execute Code
6
6
 
7
- Implement the approved plan incrementally. Source code edits are allowed in this phase.
7
+ Implement and execute the approved plan incrementally. Source code edits are allowed in this phase.
8
8
 
9
9
  ## Usage
10
10
 
11
11
  ```text
12
- 40-implement {ID}
12
+ 40-execute {ID}
13
13
  ```
14
14
 
15
15
  ## Markdown-First Contract
16
16
 
17
- Use `40-implement.md` as the primary implementation artifact.
18
- Before writing `40-implement.md`, read `artifact_language` from `.agent/resources/schemas/implement.template.md` and produce the artifact in that language.
17
+ Use `40-execute.md` as the primary execution artifact.
18
+ Before writing `40-execute.md`, produce the artifact in Thai (`th`).
19
19
 
20
- Use controlled task-engine commands when progress state must be synchronized:
21
-
22
- Before implementation, confirm the plan is approved in the stage artifacts. Track subtask progress, implementation notes, and completion evidence directly in `40-implement.md` and related stage markdown files.
20
+ Before execution, confirm the plan is approved in the stage artifacts. Track subtask progress, execution notes, and completion evidence directly in `40-execute.md` and related stage markdown files.
23
21
 
24
22
  ## Required Section Content
25
23
 
@@ -37,7 +35,7 @@ Before completing any generated artifact:
37
35
 
38
36
  ### Loop Contract
39
37
 
40
- Run implementation as scoped execution loops, one unit at a time.
38
+ Run execution as scoped execution loops, one unit at a time.
41
39
 
42
40
  - **Intent**: complete the selected planned unit while preserving the spec, plan, and repository conventions.
43
41
  - **Context**: read `30-plan.md`, `20-spec.md`, relevant checklist items, target files, pattern files, and test decisions before editing.
@@ -45,7 +43,7 @@ Run implementation as scoped execution loops, one unit at a time.
45
43
  - **Observation**: inspect concrete evidence from diffs, command output, tests, manual checks, and checklist status before claiming progress.
46
44
  - **Adjustment**: if evidence does not match intent, fix within the current unit, capture the blocker, use `Debug`, or return to `30-plan` or `20-spec` when the work no longer matches the contract.
47
45
  - **Stop Condition**: stop the unit when the planned change is complete, verification evidence is recorded, deviations are explained, and the next unit or handoff is clear.
48
- - **Handoff**: `40-implement.md` must tell `50-verify` what changed, why it changed, which checks ran, what failed or was skipped, and what residual risk remains.
46
+ - **Handoff**: `40-execute.md` must tell `50-verify` what changed, why it changed, which checks ran, what failed or was skipped, and what residual risk remains.
49
47
 
50
48
  ### 1. Get Bearings
51
49
 
@@ -61,7 +59,7 @@ Confirm the current Git branch with `git branch --show-current` and use that bra
61
59
 
62
60
  Select one scoped unit of work at a time. Do not implement the whole plan as one blob.
63
61
 
64
- ### 2. Implement One Scoped Unit
62
+ ### 2. Execute One Scoped Unit
65
63
 
66
64
  Use the original coder discipline, adapted to 2.0:
67
65
 
@@ -73,7 +71,7 @@ Use the original coder discipline, adapted to 2.0:
73
71
  - make the smallest useful code change
74
72
  - preserve project style
75
73
  - run the planned verification
76
- - record observation, adjustment, stop condition status, and the result in `40-implement.md`
74
+ - record observation, adjustment, stop condition status, and the result in `40-execute.md`
77
75
  - update checklist item status, timestamps, and evidence links as work progresses
78
76
 
79
77
  If tests are `Required`:
@@ -93,7 +91,7 @@ Use the old recovery discipline when blocked:
93
91
 
94
92
  Use `tdd` for behavior-change implementation loops, `diagnosing-bugs` when a tight repro is needed before a fix, and `codebase-design` when implementation exposes an awkward seam or shallow module.
95
93
 
96
- ### 4. Finalize Implementation
94
+ ### 4. Finalize Execution
97
95
 
98
96
  When the scoped work is complete:
99
97
 
@@ -102,14 +100,13 @@ When the scoped work is complete:
102
100
  - record verification performed
103
101
  - record loop evidence for each completed unit: intent, observation, adjustment, and stop condition
104
102
  - record deviations, blockers, and manual checks
105
- - follow the `artifact_language` configured in `implement.template.md`
106
103
  - make sure checklist statuses match the actual state of the code and tests
107
- - make sure `40-implement.md` is ready for Verify
104
+ - make sure `40-execute.md` is ready for Verify
108
105
 
109
106
  ### 5. Manual Review Soft Gate
110
107
 
111
- If the plan was not clearly approved, warn that implementation proceeded under review risk.
112
- When finishing `40-implement.md`:
108
+ If the plan was not clearly approved, warn that execution proceeded under review risk.
109
+ When finishing `40-execute.md`:
113
110
 
114
111
  - record any deviation from the approved plan explicitly
115
112
  - set reviewer expectations before `50-verify`
@@ -131,14 +128,13 @@ Report:
131
128
 
132
129
  - Classification: Mainline workflow
133
130
  - Previous state: `30-plan`
134
- - Next state: `50-verify` when scoped implementation is complete
131
+ - Next state: `50-verify` when scoped execution is complete
135
132
  - Common companion commands: `Debug` for blockers, `Preview` for local checks; support skills: `tdd`, `diagnosing-bugs`, and `codebase-design` for behavior changes, root-cause loops, and implementation-time design pressure
136
133
 
137
134
  ## Sources
138
135
 
139
136
  - `AGENTS.md`
140
137
  - `docs/workspace-artifacts.md`
141
- - `.agent/resources/schemas/implement.template.md`
142
138
  - Related commands: `30-plan`, `Debug`, `Preview`, `50-verify`
143
139
 
144
140
  ## Next Workflow Recommendation
@@ -146,7 +142,7 @@ Report:
146
142
  - **Primary**: `50-verify {ID}` when the planned work is complete.
147
143
  - **Why**: Implementation needs independent verification before release or human acceptance.
148
144
  - **Alternatives**:
149
- - `Debug "{blocker}"` - choose this when implementation is blocked by an unexplained failure.
145
+ - `Debug "{blocker}"` - choose this when execution is blocked by an unexplained failure.
150
146
  - `30-plan {ID}` - choose this when the plan is incomplete or no longer matches the work.
151
147
  - `Preview` - choose this when a local runtime or visual check is useful before formal verification.
152
148
  - `codebase-design` - choose this when the implementation cannot be tested cleanly because the module shape is wrong.
@@ -155,12 +151,11 @@ Report:
155
151
 
156
152
  - Use `Debug` when the conversation reveals an unexplained blocker, flaky behavior, or root-cause gap.
157
153
  - Use `Preview` when a runtime, UI, or local interaction check would reduce verification risk.
158
- - Return to `30-plan` when implementation drift shows the plan no longer matches reality.
154
+ - Return to `30-plan` when execution drift shows the plan no longer matches reality.
159
155
 
160
156
  ## Wiki Update Recommendation
161
157
 
162
158
  - **Needed**: `yes` when coding discovers a reusable implementation pattern, gotcha, or context optimization.
163
159
  - **Scope**: `project` unless the discovery is about DevFlow itself.
164
160
  - **Reason**: Coding findings are useful only when they are stable enough to help future tasks.
165
- - **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-implement.md`
166
-
161
+ - **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-execute.md`
@@ -43,12 +43,12 @@ Before completing any generated artifact:
43
43
  Run verification as an evidence review loop, not as a single pass/fail guess.
44
44
 
45
45
  - **Intent**: decide whether the implementation satisfies the spec and plan without introducing unacceptable regression risk.
46
- - **Context**: read `20-spec.md`, `30-plan.md`, `40-implement.md`, checklist state, changed files, test decisions, and available command/manual evidence.
46
+ - **Context**: read `20-spec.md`, `30-plan.md`, `40-execute.md`, checklist state, changed files, test decisions, and available command/manual evidence.
47
47
  - **Action**: run or inspect validation, compare implementation evidence against the contract, review risk areas, and record findings by severity.
48
48
  - **Observation**: use concrete evidence from test output, validation output, diff review, manual checks, skipped checks, and impact notes.
49
- - **Adjustment**: if evidence is missing or failing, request targeted implementation follow-up, route to `Debug`, or return to `40-implement` with the exact evidence gap.
49
+ - **Adjustment**: if evidence is missing or failing, request targeted implementation follow-up, route to `Debug`, or return to `40-execute` with the exact evidence gap.
50
50
  - **Stop Condition**: stop only with a clear verdict: pass, fail, or blocked; include the evidence, residual risks, and next route.
51
- - **Handoff**: `50-verify.md` must tell `60-report` why the work is ready, or tell `40-implement` exactly what must change before verification resumes.
51
+ - **Handoff**: `50-verify.md` must tell `60-report` why the work is ready, or tell `40-execute` exactly what must change before verification resumes.
52
52
 
53
53
  ### 1. Context Gathering
54
54
 
@@ -56,7 +56,7 @@ Read:
56
56
 
57
57
  - `20-spec.md`
58
58
  - `30-plan.md`
59
- - `40-implement.md`
59
+ - `40-execute.md`
60
60
  - `checklists/verification-checklist.md` when present
61
61
  - changed files
62
62
  - test output, command output, screenshots, or manual-check evidence
@@ -124,7 +124,7 @@ If pass:
124
124
 
125
125
  If fail:
126
126
 
127
- - route back to `40-implement` with exact failed evidence, missing checks, or required changes
127
+ - route back to `40-execute` with exact failed evidence, missing checks, or required changes
128
128
 
129
129
  Use `Debug` when investigation is needed before implementation can resume.
130
130
 
@@ -134,7 +134,7 @@ Verification is the main human review checkpoint for implemented work.
134
134
  If the evidence is incomplete or `Approval Status` remains pending:
135
135
 
136
136
  - warn that release is not yet ready for confident handoff
137
- - recommend additional review or a return to `40-implement`
137
+ - recommend additional review or a return to `40-execute`
138
138
  - keep `60-report` as a soft recommendation only
139
139
 
140
140
  ## Output
@@ -146,12 +146,12 @@ Report:
146
146
  - commands run
147
147
  - validation status
148
148
  - impact and rollback analysis when `50-verify-impact.md` is present
149
- - next command: `60-report {ID}` if pass, or `40-implement {ID}` if fail
149
+ - next command: `60-report {ID}` if pass, or `40-execute {ID}` if fail
150
150
 
151
151
  ## Relationship To DevFlow 2.0
152
152
 
153
153
  - Classification: Mainline workflow
154
- - Previous state: `40-implement`
154
+ - Previous state: `40-execute`
155
155
  - Next state: `60-report` when evidence is sufficient
156
156
  - Common companion commands: `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `Wiki`
157
157
  - Support skills: `review`, `diagnosing-bugs`, `tdd`, and `silent-failure-audit` for focused verification lanes
@@ -162,11 +162,11 @@ Report:
162
162
  - `docs/workspace-artifacts.md`
163
163
  - `.agent/resources/schemas/verify.template.md`
164
164
  - `.agent/resources/schemas/verify-impact.template.md`
165
- - Related commands: `40-implement`, `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `60-report`
165
+ - Related commands: `40-execute`, `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `60-report`
166
166
 
167
167
  ## Next Workflow Recommendation
168
168
 
169
- - **Primary**: `60-report {ID}` when verification passes, or `40-implement {ID}` when verification fails.
169
+ - **Primary**: `60-report {ID}` when verification passes, or `40-execute {ID}` when verification fails.
170
170
  - **Why**: Verification decides whether work moves forward to the final report stage or loops back for fixes.
171
171
  - **Alternatives**:
172
172
  - `Debug` - choose this when the failure needs root cause analysis before more implementation.