@jakkrichm/create-nexus-devflow 2.2.0 → 2.2.2
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 +1 -1
- package/dist/bin/create-nexus-devflow.js +1 -1
- package/dist/bin/create-nexus-devflow.js.map +1 -1
- package/dist/lib/command-catalog.js +5 -2
- package/dist/lib/command-catalog.js.map +1 -1
- package/dist/lib/dashboard.js +1 -1
- package/dist/lib/discoveries.js +18 -6
- package/dist/lib/discoveries.js.map +1 -1
- package/dist/lib/gatekeeper.d.ts +4 -0
- package/dist/lib/gatekeeper.js +13 -1
- package/dist/lib/gatekeeper.js.map +1 -1
- package/dist/lib/ideas.js +2 -2
- package/dist/lib/ideas.js.map +1 -1
- package/dist/lib/update.js +6 -2
- package/dist/lib/update.js.map +1 -1
- package/dist/lib/workflow-state.js +9 -6
- package/dist/lib/workflow-state.js.map +1 -1
- package/dist/scripts/prepare-template.js +10 -2
- package/dist/scripts/prepare-template.js.map +1 -1
- package/package.json +1 -1
- package/template/.agents/skills/10-define/SKILL.md +1 -1
- package/template/.agents/skills/30-plan/SKILL.md +13 -7
- package/template/.agents/skills/40-execute/SKILL.md +8 -11
- package/template/.agents/skills/50-verify/SKILL.md +14 -7
- package/template/.agents/skills/brainstorm/SKILL.md +1 -1
- package/template/.agents/skills/check/SKILL.md +19 -11
- package/template/.agents/skills/debug/SKILL.md +4 -8
- package/template/.agents/skills/devflow/SKILL.md +9 -7
- package/template/.agents/skills/discovery/SKILL.md +75 -150
- package/template/.agents/skills/feature/SKILL.md +9 -4
- package/template/.agents/skills/grill/SKILL.md +93 -0
- package/template/.agents/skills/implement/SKILL.md +12 -8
- package/template/.claude/skills/10-define/SKILL.md +1 -1
- package/template/.claude/skills/30-plan/SKILL.md +13 -7
- package/template/.claude/skills/40-execute/SKILL.md +8 -11
- package/template/.claude/skills/50-verify/SKILL.md +14 -7
- package/template/.claude/skills/brainstorm/SKILL.md +1 -1
- package/template/.claude/skills/check/SKILL.md +19 -11
- package/template/.claude/skills/debug/SKILL.md +4 -8
- package/template/.claude/skills/devflow/SKILL.md +9 -7
- package/template/.claude/skills/discovery/SKILL.md +75 -150
- package/template/.claude/skills/feature/SKILL.md +9 -4
- package/template/.claude/skills/grill/SKILL.md +93 -0
- package/template/.claude/skills/implement/SKILL.md +12 -8
- package/template/AGENTS.md +6 -6
- package/template/devflow/build-plan.md +10 -0
- package/template/devflow/context/ai-interaction.md +34 -7
- package/template/devflow/context/coding-standards.md +32 -7
- package/template/devflow/context/current-stage.md +1 -1
- package/template/devflow/decisions/.gitkeep +0 -0
- package/template/devflow/decisions/README.md +24 -0
- package/template/devflow/history/HISTORY.md +1 -1
- package/template/.agents/skills/00-explore/SKILL.md +0 -84
- package/template/.claude/skills/00-explore/SKILL.md +0 -84
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../lib/workflow-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAyB7B,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAC/E,MAAM,WAAW,GAAG;IAClB,
|
|
1
|
+
{"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../lib/workflow-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -43,6 +43,11 @@ async function copyEntry(entry) {
|
|
|
43
43
|
!normalized.endsWith("README.md")) {
|
|
44
44
|
return false;
|
|
45
45
|
}
|
|
46
|
+
if (normalized.startsWith("devflow/decisions/") &&
|
|
47
|
+
!normalized.endsWith(".gitkeep") &&
|
|
48
|
+
!normalized.endsWith("README.md")) {
|
|
49
|
+
return false;
|
|
50
|
+
}
|
|
46
51
|
if (normalized.startsWith("devflow/research/")) {
|
|
47
52
|
return false;
|
|
48
53
|
}
|
|
@@ -62,14 +67,17 @@ async function copyEntry(entry) {
|
|
|
62
67
|
}
|
|
63
68
|
async function ensureEmptyDirectories() {
|
|
64
69
|
const discDir = path.join(templateRoot, "devflow", "discoveries");
|
|
70
|
+
const decDir = path.join(templateRoot, "devflow", "decisions");
|
|
65
71
|
const featDir = path.join(templateRoot, "devflow", "history", "features");
|
|
66
72
|
const fixDir = path.join(templateRoot, "devflow", "history", "fixes");
|
|
67
73
|
const rollDir = path.join(templateRoot, "devflow", "history", "rollbacks");
|
|
68
74
|
await fs.mkdir(discDir, { recursive: true });
|
|
75
|
+
await fs.mkdir(decDir, { recursive: true });
|
|
69
76
|
await fs.mkdir(featDir, { recursive: true });
|
|
70
77
|
await fs.mkdir(fixDir, { recursive: true });
|
|
71
78
|
await fs.mkdir(rollDir, { recursive: true });
|
|
72
79
|
await fs.writeFile(path.join(discDir, ".gitkeep"), "", "utf8");
|
|
80
|
+
await fs.writeFile(path.join(decDir, ".gitkeep"), "", "utf8");
|
|
73
81
|
}
|
|
74
82
|
async function sanitizeStarterFiles() {
|
|
75
83
|
// 1. Sanitize AGENTS.md
|
|
@@ -102,7 +110,7 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
|
|
|
102
110
|
|
|
103
111
|
| Completed Date | Run ID | Category | Title | Git Commit | Status | Archive Link |
|
|
104
112
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
105
|
-
| _No shipped runs yet_ | - | - | Run \`/feature\` or \`/
|
|
113
|
+
| _No shipped runs yet_ | - | - | Run \`/feature\` or \`/discovery\` to start your first delivery run | - | - | - |
|
|
106
114
|
|
|
107
115
|
---
|
|
108
116
|
|
|
@@ -170,7 +178,7 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
|
|
|
170
178
|
|
|
171
179
|
- **Active Discovery ID**: \`None\`
|
|
172
180
|
- **Active Running ID**: \`None\`
|
|
173
|
-
- **Current Stage**: \`Idle (Ready for new /feature, /fix, /
|
|
181
|
+
- **Current Stage**: \`Idle (Ready for new /feature, /fix, /discovery, or /10-define)\`
|
|
174
182
|
- **Living Spec**: \`None\`
|
|
175
183
|
- **Last Completed Run**: \`None\`
|
|
176
184
|
- **Last Updated**: \`None\`
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -43,7 +43,7 @@ using:
|
|
|
43
43
|
Require:
|
|
44
44
|
- `Decision: Proceed`
|
|
45
45
|
- `Approval Status: Approved`
|
|
46
|
-
- A resolvable Discovery ID and `00-explore.md`
|
|
46
|
+
- A resolvable Discovery ID and `discovery.md` (or legacy `00-explore.md`)
|
|
47
47
|
|
|
48
48
|
### 3. Allocate Sequential ID
|
|
49
49
|
- Inspect `devflow/history/HISTORY.md` and allocate sequential ID without prefix (e.g. `022-{slug}`).
|
|
@@ -83,12 +83,12 @@ Record important findings in `30-plan.md`. Use legacy context updates only when
|
|
|
83
83
|
|
|
84
84
|
### 4. Build The Plan
|
|
85
85
|
|
|
86
|
-
Use
|
|
86
|
+
Use strict planning discipline, keeping `30-plan.md` as the main contract:
|
|
87
87
|
|
|
88
|
+
- **Atomic Micro-Task Sizing (2–5 Minutes)**: Every subtask must be a small, verifiable unit that can be implemented and reviewed cleanly without context sprawl.
|
|
88
89
|
- record the planning loop evidence: context read, observations, adjustments made, stop condition, and handoff notes
|
|
89
90
|
- add phases in dependency order
|
|
90
|
-
-
|
|
91
|
-
- include explicit files to modify or create
|
|
91
|
+
- include explicit files to modify or create (exact file paths)
|
|
92
92
|
- include patterns to follow
|
|
93
93
|
- include verification command or manual check
|
|
94
94
|
- include a test decision for every subtask
|
|
@@ -97,18 +97,24 @@ Use the old planner discipline, but keep `30-plan.md` as the main contract:
|
|
|
97
97
|
Each subtask should answer:
|
|
98
98
|
|
|
99
99
|
- what to change
|
|
100
|
-
- where to change it
|
|
100
|
+
- where to change it (exact path)
|
|
101
101
|
- which pattern to follow
|
|
102
102
|
- how to verify it
|
|
103
103
|
- whether automated tests are required, manual, or not required
|
|
104
104
|
|
|
105
|
-
### 4.1 Test Decision Gate
|
|
105
|
+
### 4.1 Strict TDD Task Breakdown & Test Decision Gate
|
|
106
106
|
|
|
107
|
-
**STRICT MANDATE (กฎเหล็ก Unit Test)**: สำหรับทุก subtask ที่มีการเพิ่ม แก้ไข หรือเปลี่ยนแปลงการทำงานของโค้ด (Behavior Change) **ต้องระบุเป็น `Required` เสมอ**
|
|
107
|
+
**STRICT MANDATE (กฎเหล็ก Unit Test & TDD)**: สำหรับทุก subtask ที่มีการเพิ่ม แก้ไข หรือเปลี่ยนแปลงการทำงานของโค้ด (Behavior Change) **ต้องระบุเป็น `Required` เสมอ** และต้องย่อยงานเป็น **TDD Triplet Sub-tasks** ดังนี้:
|
|
108
|
+
|
|
109
|
+
```markdown
|
|
110
|
+
- [ ] Task 1.1 [TDD-Red]: Write failing test for {feature/behavior} in {test_file} and verify failure
|
|
111
|
+
- [ ] Task 1.2 [TDD-Green]: Implement minimal code in {src_file} to satisfy Task 1.1 test
|
|
112
|
+
- [ ] Task 1.3 [TDD-Refactor]: Refactor logic, eliminate duplication, and verify zero regression
|
|
113
|
+
```
|
|
108
114
|
|
|
109
115
|
For every subtask, decide one of:
|
|
110
116
|
|
|
111
|
-
- `Required`: automated tests must be created or updated (Mandatory for all behavior changes)
|
|
117
|
+
- `Required`: automated tests must be created or updated (Mandatory for all behavior changes, formatted as TDD Triplet)
|
|
112
118
|
- `Manual/Command Only`: verification is non-test but still explicit (Only for configuration/infrastructure tasks)
|
|
113
119
|
- `Not Required`: no new automated test is needed because there is no meaningful behavior surface (Only for documentation/comments)
|
|
114
120
|
|
|
@@ -59,27 +59,24 @@ Confirm the current Git branch with `git branch --show-current` and use that bra
|
|
|
59
59
|
|
|
60
60
|
Select one scoped unit of work at a time. Do not implement the whole plan as one blob.
|
|
61
61
|
|
|
62
|
-
### 2. Execute One Scoped Unit
|
|
62
|
+
### 2. Execute One Scoped Unit (Strict TDD Red-Green-Refactor)
|
|
63
63
|
|
|
64
|
-
Use the
|
|
64
|
+
Use the strict coder discipline:
|
|
65
65
|
|
|
66
|
-
- **STRICT MANDATE (กฎเหล็ก Unit Test)**:
|
|
66
|
+
- **STRICT MANDATE (กฎเหล็ก Unit Test & TDD)**: สำหรับทุกงานที่มีการแก้ไข logic การทำงาน ต้องสร้างหรือแก้ไข Unit Test ควบคู่กับการแก้ไขโค้ดเสมอ โดยห้ามเขียนเฉพาะ Production Code โดยไม่มีเทสต์
|
|
67
|
+
- **🔴 RED (Test First)**: ออกแบบและเขียน Test Case ในไฟล์เทสต์ก่อนเสมอ แล้วรันคำสั่งเทสต์เพื่อพิสูจน์ว่า **Test ล้มเหลว (FAIL)** ตามที่คาดหวัง
|
|
68
|
+
- **🟢 GREEN (Minimal Implementation)**: เขียน Production Code เท่าที่จำเป็นเพื่อให้เทสต์ผ่าน แล้วรันคำสั่งเทสต์เพื่อพิสูจน์ว่า **Test ผ่าน 100% (PASS)**
|
|
69
|
+
- **🔵 REFACTOR (Clean Code)**: ปรับปรุงโครงสร้างโค้ดให้อ่านง่าย กำจัดความซ้ำซ้อน (DRY) โดยที่เทสต์ยังคงเขียว 100%
|
|
70
|
+
- **Code Deletion / Reversion Rule**: หากเผลอเขียน Production Code ก่อนมีเทสต์ ให้ Revert หรือลบโค้ดส่วนนั้น แล้วเริ่มวงจร RED ก่อนเสมอ
|
|
67
71
|
- start each scoped unit by naming its intent, context, expected observation, adjustment route, and stop condition
|
|
68
72
|
- read referenced pattern files before editing
|
|
69
73
|
- read the test decision from `30-plan.md`
|
|
70
74
|
- confirm assumptions, target files, and success criteria before editing
|
|
71
|
-
- make the smallest useful code change
|
|
72
75
|
- preserve project style
|
|
73
|
-
- run the planned verification
|
|
76
|
+
- run the planned verification and capture concrete terminal outputs
|
|
74
77
|
- record observation, adjustment, stop condition status, and the result in `40-execute.md`
|
|
75
78
|
- update checklist item status, timestamps, and evidence links as work progresses
|
|
76
79
|
|
|
77
|
-
If tests are `Required`:
|
|
78
|
-
|
|
79
|
-
1. **TDD Cycle (RED)**: ออกแบบและเขียนตัวเทสต์ให้พังก่อน (หรือเขียนโครงสร้างเทสต์ที่คาดหวังผลลัพธ์ที่ถูกต้อง) ตามแนวทางใน [coding-standards.md](file:///devflow/context/coding-standards.md)
|
|
80
|
-
2. **GREEN**: เขียนโค้ดระบบจริงให้สอดคล้องเพื่อให้เทสต์ผ่าน
|
|
81
|
-
3. **REFACTOR**: ปรับปรุงโครงสร้างโค้ดโดยยังคงรันเทสต์ผ่านอย่างต่อเนื่อง
|
|
82
|
-
|
|
83
80
|
### 3. Recovery
|
|
84
81
|
|
|
85
82
|
Use the old recovery discipline when blocked:
|
|
@@ -18,15 +18,21 @@ Review implementation quality, run multi-lane validation, produce a verification
|
|
|
18
18
|
Use `50-verify.md` as the primary verification artifact.
|
|
19
19
|
Use `50-verify-impact.md` as an optional companion artifact when the run changes behavior, touches core logic, crosses integration boundaries, or needs explicit rollback and client impact analysis.
|
|
20
20
|
|
|
21
|
-
## Process & Quality Gates
|
|
21
|
+
## Process & Quality Gates (Two-Stage Review Pattern)
|
|
22
22
|
|
|
23
|
-
### 1
|
|
23
|
+
### Stage 1: Spec Fidelity & Acceptance Criteria Gate
|
|
24
|
+
Before evaluating technical code metrics, verify that the implementation faithfully delivers what was specified:
|
|
25
|
+
1. **Acceptance Criteria Validation**: Cross-check each Acceptance Criterion (AC-1, AC-2, ...) in `20-spec.md` or `current-feature.md` and verify concrete evidence of completion.
|
|
26
|
+
2. **Done-When Observable Verification**: Check that all observable conditions ("Done when...") are satisfied in the running application or test suite.
|
|
27
|
+
3. **Scope Discipline**: Ensure zero scope creep (no unrequested features added) and no unfulfilled functional requirements.
|
|
28
|
+
4. **Boundary & Negative Scenarios**: Verify unhappy paths, empty inputs, and error states defined in the specification.
|
|
24
29
|
|
|
25
|
-
|
|
30
|
+
### Stage 2: Code Quality, Security & Architecture Gate
|
|
31
|
+
Execute multi-lane technical verification across all essential quality dimensions:
|
|
26
32
|
|
|
27
33
|
1. **Lane 1: Typecheck & Static Code Quality**:
|
|
28
34
|
- Run typecheck and static analysis (`tsc --noEmit`, `npm run lint`).
|
|
29
|
-
2. **Lane 2: Automated Test Suites (TDD Gate)**:
|
|
35
|
+
2. **Lane 2: Automated Test Suites (Strict TDD Gate)**:
|
|
30
36
|
- Run automated unit and integration tests (`npm test`).
|
|
31
37
|
- Confirm 100% test pass rate with zero disabled or skipped tests.
|
|
32
38
|
3. **Lane 3: Scrutinize QA & Edge Cases Review**:
|
|
@@ -44,12 +50,13 @@ Execute verification across all essential quality dimensions:
|
|
|
44
50
|
|
|
45
51
|
### 2. Decision & Route
|
|
46
52
|
|
|
47
|
-
- **Pass**: Route to `60-report {ID}`.
|
|
48
|
-
- **Fail**: Route back to `40-execute {ID}` with exact failure evidence and remediation steps.
|
|
53
|
+
- **Pass**: Both Stage 1 and Stage 2 pass with 0 blockers -> Route to `60-report {ID}`.
|
|
54
|
+
- **Fail**: Either Stage 1 or Stage 2 fails -> Route back to `40-execute {ID}` with exact failure evidence and remediation steps.
|
|
49
55
|
|
|
50
56
|
## Output
|
|
51
57
|
|
|
52
58
|
Report:
|
|
53
|
-
-
|
|
59
|
+
- **Stage 1 Verdict**: Spec Fidelity & Acceptance Criteria status
|
|
60
|
+
- **Stage 2 Verdict**: Technical Multi-lane quality & security matrix
|
|
54
61
|
- Evidence commands and outputs
|
|
55
62
|
- Next command: `60-report {ID}` (if pass) or `40-execute {ID}` (if fail)
|
|
@@ -58,5 +58,5 @@ Construct a structured evaluation table:
|
|
|
58
58
|
|
|
59
59
|
## Next Workflow Recommendation
|
|
60
60
|
|
|
61
|
-
- **Primary**: `
|
|
61
|
+
- **Primary**: `discovery {discovery_id}` (if resuming discovery) or `10-define` / `feature` (if ready to specify)
|
|
62
62
|
- **Inbox**: `idea` to record into `devflow/ideas.md`
|
|
@@ -66,21 +66,29 @@ Drive the app to each checklist item and capture evidence as you go:
|
|
|
66
66
|
- Watch for **console errors and failed network requests**; a clean-looking screen
|
|
67
67
|
with errors in the console is not a pass.
|
|
68
68
|
|
|
69
|
-
## Step 4 - report
|
|
69
|
+
## Step 4 - report (Two-Stage Review Pattern)
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
Format the verification report into two explicit review stages:
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
[fail] PDF border missing - printBackground not set; screenshot: pdf-no-border.png
|
|
76
|
-
[skip] Vercel render - can't verify locally (feature 9)
|
|
73
|
+
### Stage 1: Spec Fidelity & Acceptance Gate
|
|
74
|
+
Give a line-by-line verdict for each Acceptance Criterion and "done when" item:
|
|
77
75
|
|
|
78
|
-
|
|
76
|
+
[pass] AC-1: Download PDF saves certificate-<slug>.pdf - file downloaded, opened to cert
|
|
77
|
+
[pass] AC-2: Both buttons show a loading state - screenshot: loading-state.png
|
|
78
|
+
[fail] AC-3: PDF border missing - printBackground not set; screenshot: pdf-no-border.png
|
|
79
|
+
[skip] AC-4: Vercel deploy smoke test - can't verify locally (pending staging)
|
|
79
80
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
-
|
|
81
|
+
### Stage 2: Code Quality, Security & Architecture Gate
|
|
82
|
+
Report the multi-lane technical verification results:
|
|
83
|
+
- **Type & Syntax**: `tsc --noEmit` (0 errors)
|
|
84
|
+
- **Automated Tests**: Unit & integration tests (100% pass)
|
|
85
|
+
- **Security & Hygiene**: Zero secrets, sanitized inputs
|
|
86
|
+
- **Findings Ledger**: 0 blockers (P0/P1) in `devflow/context/findings.md`
|
|
87
|
+
|
|
88
|
+
### Final Verdict & Route
|
|
89
|
+
- **All Passed**: State that the feature is verified and ready for `/complete`.
|
|
90
|
+
- **Any Failure**: Hand back to `/implement` with exact failure evidence and reproduction steps. Never fix issues inside `/check`.
|
|
91
|
+
- **Unverifiable**: Clearly state reasons and residual risk. Never fabricate a pass.
|
|
84
92
|
|
|
85
93
|
## Rules
|
|
86
94
|
|
|
@@ -117,14 +117,10 @@ Give a concise debug report:
|
|
|
117
117
|
|
|
118
118
|
Choose the next action without writing files:
|
|
119
119
|
|
|
120
|
-
- Active feature or fix caused the failure -> return the diagnosis to
|
|
121
|
-
|
|
122
|
-
-
|
|
123
|
-
|
|
124
|
-
- Cause is only likely or blocked -> recommend the next diagnostic evidence, not
|
|
125
|
-
a speculative repair.
|
|
126
|
-
- The issue is planned product work rather than a defect -> point to
|
|
127
|
-
`/feature`.
|
|
120
|
+
- Active feature or fix caused the failure -> return the diagnosis to `/implement` with instructions to write a failing reproduction test ([TDD-Red]) first.
|
|
121
|
+
- No active work item and the bug is confirmed -> recommend `/fix "<concise bug and confirmed cause>"` (which will write a failing test first before fixing).
|
|
122
|
+
- Cause is only likely or blocked -> recommend the next diagnostic evidence, not a speculative repair.
|
|
123
|
+
- The issue is planned product work rather than a defect -> point to `/feature`.
|
|
128
124
|
|
|
129
125
|
## Rules
|
|
130
126
|
|
|
@@ -23,7 +23,7 @@ Use this skill to guide the user on what to do next, inspect current workspace s
|
|
|
23
23
|
Nexus-DevFlow supports two seamless workflow tracks:
|
|
24
24
|
1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: `/spec` ➔ `/implement` ➔ `/check` ➔ `/complete`
|
|
25
25
|
*Driven by a **Single Living Spec (`current-feature.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
|
|
26
|
-
2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `
|
|
26
|
+
2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `discovery` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-deliver`
|
|
27
27
|
*Driven by modular separate stage files for large, high-stakes architectural epics and multi-agent coordination.*
|
|
28
28
|
|
|
29
29
|
---
|
|
@@ -45,14 +45,14 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
45
45
|
- If at `40-execute.md` with all tasks done -> Recommend `50-verify {RUNNING_ID}`.
|
|
46
46
|
- If passed `50-verify.md` -> Recommend `60-report {RUNNING_ID}` then `70-deliver {RUNNING_ID}`.
|
|
47
47
|
3. **Active Discovery**: Check `devflow/discoveries/` for open discovery notes.
|
|
48
|
-
4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx`.
|
|
48
|
+
4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
|
|
49
49
|
5. **Audit Findings Ledger**: Check `devflow/context/findings.md` for open high-severity findings.
|
|
50
50
|
|
|
51
51
|
### Default State Recommendations
|
|
52
52
|
- if no run is active and user wants to start a feature -> Recommend `/feature <name>`.
|
|
53
53
|
- If no run is active and user wants to fix a bug -> Recommend `/fix <bug>`.
|
|
54
|
-
- If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx`.
|
|
55
|
-
- If no run is active and user wants deep architectural exploration -> Recommend `
|
|
54
|
+
- If no run is active and user has pending ideas in `devflow/ideas.md` -> Highlight `/spec IDEA-xxx` or `/discovery IDEA-xxx`.
|
|
55
|
+
- If no run is active and user wants deep architectural exploration -> Recommend `discovery`.
|
|
56
56
|
- If user asks to check system health -> Recommend `doctor`.
|
|
57
57
|
|
|
58
58
|
---
|
|
@@ -71,7 +71,7 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
71
71
|
| "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/spec` or `10-define` |
|
|
72
72
|
| "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/spec` or `10-define` |
|
|
73
73
|
| "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
|
|
74
|
-
| "Explore a new request / deep idea" | `
|
|
74
|
+
| "Explore a new request / deep idea" | `discovery` | `discovery` / `/discovery` | **Deep-Track**: `discovery` -> `10` -> `20` -> ... |
|
|
75
75
|
| "Define delivery boundaries and ID" | `10-define` | `define` | **Deep-Track**: `10` -> `20` -> `30` |
|
|
76
76
|
| "Break down spec into plan (Deep)" | `30-plan` | `plan` | **Deep-Track**: `30` -> `40` -> `50` |
|
|
77
77
|
| "Deep code implementation" | `40-execute` | `implement` | **Deep-Track**: `40` -> `50` |
|
|
@@ -84,6 +84,7 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
84
84
|
| "Pre-check scope & risks before spec" | `brief` | `brief` | Companion |
|
|
85
85
|
| "Run autonomous bounded delivery loop"| `autopilot` | `autopilot` | Companion |
|
|
86
86
|
| "Brainstorm ideas without ID" | `brainstorm` | `brainstorm` | Companion |
|
|
87
|
+
| "Socratic alignment / ADR / glossary" | `grill` | `/grill` / `align` | Companion (pre-spec / domain modeling) |
|
|
87
88
|
| "Investigate failure or root cause" | `debug` | `debug` | Companion |
|
|
88
89
|
|
|
89
90
|
---
|
|
@@ -97,7 +98,7 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
97
98
|
- `complete` (`/complete`, `$complete`) - Safety pass, release digest, git merge, close run
|
|
98
99
|
|
|
99
100
|
### 2. Deep-Track (Architect Mode - 8 Steps)
|
|
100
|
-
- `
|
|
101
|
+
- `discovery` - Project roadmap planning or feature exploration before delivery commitment
|
|
101
102
|
- `10-define` - Lock delivery boundaries and allocate Running ID
|
|
102
103
|
- `20-spec` - Formalize markdown delivery contract
|
|
103
104
|
- `30-plan` - Breakdown spec into phased tasks with test decisions
|
|
@@ -109,6 +110,8 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
109
110
|
### 3. Public Companion Commands
|
|
110
111
|
- `devflow` (`status`, `/devflow`) - Interactive guide, state inspector, and router
|
|
111
112
|
- `idea` (`/idea`) - Quick idea capture and AI feasibility enrichment into `devflow/ideas.md`
|
|
113
|
+
- `grill` (`/grill`, `align`) - Codebase-grounded Socratic alignment, domain glossary, and ADR recorder
|
|
114
|
+
- `brainstorm` - Ideate and compare trade-off options without allocating running IDs
|
|
112
115
|
- `report-html` (`/report:html`) - Standalone interactive HTML report dashboard generator
|
|
113
116
|
- `onboard` - Baseline stack setup for freshly scaffolded projects
|
|
114
117
|
- `adopt` - Bootstrap DevFlow into existing brownfield projects
|
|
@@ -118,6 +121,5 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
118
121
|
- `ci` - Automatic GitHub Actions workflow setup
|
|
119
122
|
- `brief` - Read-only scope and risk pre-briefing
|
|
120
123
|
- `autopilot` - Autonomous bounded delivery loop
|
|
121
|
-
- `brainstorm` - Ideate without allocating running IDs
|
|
122
124
|
- `debug` - Root cause investigation before or during implementation
|
|
123
125
|
- `overview` - Living context synchronization into project-overview.md
|