@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.
- package/README.md +4 -4
- package/dist/bin/create-nexus-devflow.d.ts +2 -0
- package/dist/bin/create-nexus-devflow.js +233 -0
- package/dist/bin/create-nexus-devflow.js.map +1 -0
- package/dist/lib/starter-templates.d.ts +6 -0
- package/dist/lib/starter-templates.js +8 -0
- package/dist/lib/starter-templates.js.map +1 -0
- package/dist/lib/update.d.ts +68 -0
- package/dist/lib/update.js +325 -0
- package/dist/lib/update.js.map +1 -0
- package/dist/scripts/clean-template.d.ts +1 -0
- package/dist/scripts/clean-template.js +14 -0
- package/dist/scripts/clean-template.js.map +1 -0
- package/dist/scripts/prepare-template.d.ts +1 -0
- package/dist/scripts/prepare-template.js +89 -0
- package/dist/scripts/prepare-template.js.map +1 -0
- package/package.json +11 -9
- package/template/.agents/skills/00-discover/SKILL.md +2 -0
- package/template/.agents/skills/30-plan/SKILL.md +6 -6
- package/template/{.claude/skills/40-implement → .agents/skills/40-execute}/SKILL.md +21 -26
- package/template/.agents/skills/50-verify/SKILL.md +10 -10
- package/template/.agents/skills/60-report/SKILL.md +22 -76
- package/template/.agents/skills/70-release/SKILL.md +11 -10
- 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/check/SKILL.md +68 -0
- package/template/.agents/skills/codebase-design/SKILL.md +2 -2
- package/template/.agents/skills/commit/SKILL.md +1 -1
- package/template/.agents/skills/complete/SKILL.md +73 -0
- package/template/.agents/skills/debug/SKILL.md +2 -2
- package/template/.agents/skills/devflow/SKILL.md +89 -80
- 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/idea/SKILL.md +57 -0
- package/template/.agents/skills/implement/SKILL.md +64 -0
- package/template/.agents/skills/insight/SKILL.md +1 -1
- package/template/.agents/skills/overview/SKILL.md +114 -0
- package/template/.agents/skills/pr/SKILL.md +1 -1
- package/template/.agents/skills/preview/SKILL.md +1 -1
- package/template/.agents/skills/report-html/SKILL.md +45 -0
- 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 +38 -0
- package/template/.agents/skills/test/SKILL.md +2 -2
- package/template/.agents/skills/try/SKILL.md +2 -2
- package/template/.claude/skills/00-discover/SKILL.md +2 -0
- package/template/.claude/skills/30-plan/SKILL.md +6 -6
- package/template/{.agents/skills/40-implement → .claude/skills/40-execute}/SKILL.md +21 -26
- package/template/.claude/skills/50-verify/SKILL.md +10 -10
- package/template/.claude/skills/60-report/SKILL.md +22 -76
- package/template/.claude/skills/70-release/SKILL.md +11 -10
- 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/check/SKILL.md +68 -0
- package/template/.claude/skills/codebase-design/SKILL.md +2 -2
- package/template/.claude/skills/commit/SKILL.md +1 -1
- package/template/.claude/skills/complete/SKILL.md +73 -0
- package/template/.claude/skills/debug/SKILL.md +2 -2
- package/template/.claude/skills/devflow/SKILL.md +89 -80
- 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/idea/SKILL.md +57 -0
- package/template/.claude/skills/implement/SKILL.md +64 -0
- package/template/.claude/skills/insight/SKILL.md +1 -1
- package/template/.claude/skills/overview/SKILL.md +114 -0
- package/template/.claude/skills/pr/SKILL.md +1 -1
- package/template/.claude/skills/preview/SKILL.md +1 -1
- package/template/.claude/skills/report-html/SKILL.md +45 -0
- 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 +38 -0
- package/template/.claude/skills/test/SKILL.md +2 -2
- package/template/.claude/skills/try/SKILL.md +2 -2
- package/template/AGENTS.md +72 -74
- package/template/devflow/context/ai-interaction.md +3 -2
- package/template/devflow/context/coding-standards.md +31 -18
- package/template/devflow/context/current-stage.md +4 -3
- package/template/devflow/context/findings.md +10 -6
- package/template/devflow/context/project-overview.md +33 -11
- package/template/devflow/discoveries/.gitkeep +0 -0
- package/template/devflow/history/HISTORY.md +6 -0
- package/template/devflow/ideas.md +15 -0
- package/template/devflow/reference/running-id-contract.md +2 -2
- package/template/devflow/runs/.gitkeep +0 -0
- package/bin/create-nexus-devflow.js +0 -287
- package/lib/starter-templates.js +0 -111
- package/lib/update.js +0 -393
- 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-
|
|
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-
|
|
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`
|
|
@@ -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-
|
|
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).
|
|
@@ -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-
|
|
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.
|
|
@@ -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-
|
|
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.
|
|
@@ -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
|
-
|
|
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-
|
|
12
|
+
40-execute {ID}
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Markdown-First Contract
|
|
16
16
|
|
|
17
|
-
Use `40-
|
|
18
|
-
Before writing `40-
|
|
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
|
-
|
|
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
|
|
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-
|
|
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.
|
|
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-
|
|
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
|
|
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-
|
|
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
|
|
112
|
-
When finishing `40-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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.
|