@jakkrichm/create-nexus-devflow 2.5.0 → 2.6.1
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 +58 -45
- package/dist/lib/branch-context.d.ts +61 -8
- package/dist/lib/branch-context.js +362 -125
- package/dist/lib/branch-context.js.map +1 -1
- package/dist/lib/core-skill-inventory.d.ts +16 -0
- package/dist/lib/core-skill-inventory.js +96 -0
- package/dist/lib/core-skill-inventory.js.map +1 -0
- package/dist/lib/doctor.js +13 -10
- package/dist/lib/doctor.js.map +1 -1
- package/dist/lib/status.d.ts +2 -0
- package/dist/lib/status.js +7 -2
- package/dist/lib/status.js.map +1 -1
- package/dist/lib/update.js +5 -8
- package/dist/lib/update.js.map +1 -1
- package/dist/scripts/prepare-template.js +19 -16
- package/dist/scripts/prepare-template.js.map +1 -1
- package/package.json +1 -1
- package/template/.agents/skills/adopt/SKILL.md +1 -1
- package/template/.agents/skills/audit/SKILL.md +1 -1
- package/template/.agents/skills/autopilot/SKILL.md +1 -1
- 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 +80 -75
- package/template/.agents/skills/ci/SKILL.md +1 -1
- package/template/.agents/skills/complete/SKILL.md +9 -3
- package/template/.agents/skills/convert-any-to-md/SKILL.md +1 -1
- package/template/.agents/skills/debug/SKILL.md +76 -94
- package/template/.agents/skills/devflow/SKILL.md +1 -1
- package/template/.agents/skills/discovery/SKILL.md +7 -9
- package/template/.agents/skills/doctor/SKILL.md +1 -1
- package/template/.agents/skills/feature/SKILL.md +10 -5
- package/template/.agents/skills/fix/SKILL.md +6 -8
- package/template/.agents/skills/grill/SKILL.md +1 -1
- package/template/.agents/skills/idea/SKILL.md +1 -1
- package/template/.agents/skills/implement/SKILL.md +10 -4
- package/template/.agents/skills/onboard/SKILL.md +1 -1
- package/template/.agents/skills/overview/SKILL.md +1 -1
- package/template/.agents/skills/prototype/SKILL.md +1 -1
- package/template/.agents/skills/release/SKILL.md +1 -1
- package/template/.agents/skills/report-html/SKILL.md +1 -1
- package/template/.agents/skills/rollback/SKILL.md +1 -1
- package/template/.agents/skills/status/SKILL.md +1 -1
- package/template/.agents/skills/test/SKILL.md +1 -1
- package/template/.agents/skills/tests/SKILL.md +1 -1
- package/template/.agents/skills/try/SKILL.md +1 -1
- package/template/.claude/skills/adopt/SKILL.md +1 -1
- package/template/.claude/skills/audit/SKILL.md +1 -1
- package/template/.claude/skills/autopilot/SKILL.md +1 -1
- 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 +80 -75
- package/template/.claude/skills/ci/SKILL.md +1 -1
- package/template/.claude/skills/complete/SKILL.md +9 -3
- package/template/.claude/skills/convert-any-to-md/SKILL.md +1 -1
- package/template/.claude/skills/debug/SKILL.md +76 -94
- package/template/.claude/skills/devflow/SKILL.md +1 -1
- package/template/.claude/skills/discovery/SKILL.md +7 -9
- package/template/.claude/skills/doctor/SKILL.md +1 -1
- package/template/.claude/skills/feature/SKILL.md +10 -5
- package/template/.claude/skills/fix/SKILL.md +6 -8
- package/template/.claude/skills/grill/SKILL.md +1 -1
- package/template/.claude/skills/idea/SKILL.md +1 -1
- package/template/.claude/skills/implement/SKILL.md +10 -4
- package/template/.claude/skills/onboard/SKILL.md +1 -1
- package/template/.claude/skills/overview/SKILL.md +1 -1
- package/template/.claude/skills/prototype/SKILL.md +1 -1
- package/template/.claude/skills/release/SKILL.md +1 -1
- package/template/.claude/skills/report-html/SKILL.md +1 -1
- package/template/.claude/skills/rollback/SKILL.md +1 -1
- package/template/.claude/skills/status/SKILL.md +1 -1
- package/template/.claude/skills/test/SKILL.md +1 -1
- package/template/.claude/skills/tests/SKILL.md +1 -1
- package/template/.claude/skills/try/SKILL.md +1 -1
- package/template/AGENTS.md +1 -1
- package/template/devflow/build-plan.md +10 -0
- package/template/devflow/context/ai-interaction.md +5 -6
- package/template/devflow/context/coding-standards.md +31 -6
- package/template/devflow/context/current-stage.md +10 -7
- package/template/devflow/history/HISTORY.md +1 -1
- package/template/devflow/project-plan.md +2 -2
- package/template/devflow/reference/running-id-contract.md +24 -20
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: debug
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Diagnose a failing test, broken build, crash, error, regression, or unexpected behavior without editing source or DevFlow state. Follows a strict 6-Phase Scientific Debugging Loop: builds a red-capable tight feedback loop, reproduces & minimises, tests 3-5 falsifiable hypotheses, localizes the failure to a root cause, and reports a repair handoff to /fix or /implement. Use when the user runs /debug, invokes $debug, asks why something is failing or broken, wants a root-cause investigation, or asks to diagnose before fixing."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# debug -
|
|
6
|
+
# debug - 6-Phase Scientific Debugging Protocol
|
|
7
7
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
@@ -12,130 +12,112 @@ Where this sits in the workflow:
|
|
|
12
12
|
crash, behavior) isolate, repair active work)
|
|
13
13
|
explain)
|
|
14
14
|
|
|
15
|
-
`/debug` separates diagnosis from repair. It gathers evidence, narrows the
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
`/debug` separates diagnosis from repair. It gathers empirical evidence, narrows the failure to a specific root cause using scientific method, and stops with an actionable repair handoff. It does not guess, assume, or perform ad-hoc "vibe debugging".
|
|
16
|
+
|
|
17
|
+
---
|
|
18
18
|
|
|
19
19
|
## Input
|
|
20
20
|
|
|
21
21
|
Accept a symptom, failing command, error message, or unexpected behavior. Examples:
|
|
22
22
|
|
|
23
|
-
/debug npm test fails in cart-total.test.
|
|
23
|
+
/debug npm test fails in cart-total.test.ts
|
|
24
24
|
/debug the upload route returns 500 for PNG files
|
|
25
|
-
/debug why does the
|
|
25
|
+
/debug why does the build fail on Windows?
|
|
26
26
|
|
|
27
|
-
With no useful symptom, ask for
|
|
28
|
-
smallest known reproduction. Do not guess which problem the user means.
|
|
27
|
+
With no useful symptom, ask for expected behavior, actual behavior, and smallest known reproduction. Do not guess.
|
|
29
28
|
|
|
30
|
-
|
|
29
|
+
---
|
|
31
30
|
|
|
32
|
-
|
|
31
|
+
## 🔬 The 6-Phase Scientific Debugging Loop
|
|
33
32
|
|
|
34
|
-
-
|
|
35
|
-
- `devflow/context/project-overview.md`
|
|
36
|
-
- `devflow/context/coding-standards.md`
|
|
37
|
-
- `devflow/context/current-feature.md`
|
|
38
|
-
- the reported error, failing output, and affected files
|
|
39
|
-
- git status, diff, and recent log when a regression is possible
|
|
33
|
+
### Phase 1: Build a Red-Capable Feedback Loop (Golden Rule)
|
|
40
34
|
|
|
41
|
-
|
|
42
|
-
failure belongs to an active feature or is an unplanned bug.
|
|
35
|
+
**This is the core discipline.** If you have a **tight** pass/fail command that actively goes RED on this bug, you will find the root cause. If you do not have one, staring at code will not save you.
|
|
43
36
|
|
|
44
|
-
|
|
45
|
-
|
|
37
|
+
**Spend disproportionate effort here. Ways to construct one (in order):**
|
|
38
|
+
1. **Failing Unit / Integration Test** at the responsible module seam.
|
|
39
|
+
2. **Curl / HTTP script** against the running local dev server.
|
|
40
|
+
3. **CLI invocation** diffing stdout/stderr against expected output.
|
|
41
|
+
4. **Headless browser script** (Playwright) asserting on DOM/network/console.
|
|
42
|
+
5. **Replay captured trace**: Replay isolated payload/event log through the code path.
|
|
46
43
|
|
|
47
|
-
|
|
44
|
+
**Completion Criterion for Phase 1**:
|
|
45
|
+
You must name **one single command** (a test invocation, a script, or curl) that you have **already run at least once** and proven:
|
|
46
|
+
- [ ] **Red-capable**: It exercises the actual code path and catches the user's exact symptom (fails red now, will pass green once fixed).
|
|
47
|
+
- [ ] **Deterministic**: Returns the same verdict every run.
|
|
48
|
+
- [ ] **Fast & Agent-runnable**: Completes in seconds, executable without manual intervention.
|
|
48
49
|
|
|
49
|
-
|
|
50
|
+
> [!CAUTION]
|
|
51
|
+
> **No Red-Capable Command = No Phase 2.** If you catch yourself reading code to form theories before this command exists, **STOP**. Jumping straight to a hypothesis is the exact failure this protocol prevents.
|
|
50
52
|
|
|
51
|
-
|
|
52
|
-
- Capture the exact exit code, error, stack trace, output, response, console
|
|
53
|
-
error, or failed request.
|
|
54
|
-
- Reuse an already-running local app when available. If reproduction requires a
|
|
55
|
-
long-running server that is not running, ask the user to start it and provide
|
|
56
|
-
the documented command.
|
|
57
|
-
- Do not install dependencies, change configuration, run migrations, mutate
|
|
58
|
-
production data, contact external users, or use destructive commands to force
|
|
59
|
-
a reproduction.
|
|
60
|
-
- Do not edit code to add logs or probes. Use existing logs, debuggers,
|
|
61
|
-
read-only inspection, or one-off commands that do not change project files.
|
|
62
|
-
- Compare git status after diagnostic commands. If one changes tracked or
|
|
63
|
-
untracked project files, stop and report those paths. Do not clean, restore,
|
|
64
|
-
or hide the changes.
|
|
53
|
+
---
|
|
65
54
|
|
|
66
|
-
|
|
67
|
-
missing. Continue with static investigation only when it can produce a clearly
|
|
68
|
-
labeled hypothesis, not a claimed root cause.
|
|
55
|
+
### Phase 2: Reproduce & Minimise
|
|
69
56
|
|
|
70
|
-
|
|
57
|
+
Run the feedback loop and watch it go RED.
|
|
71
58
|
|
|
72
|
-
|
|
59
|
+
1. **Confirm Symptom**: Ensure the failure mode matches what the user reported (not a nearby unrelated error).
|
|
60
|
+
2. **Minimise the Repro**: Cut inputs, configs, dependencies, and steps **one at a time**, re-running the command after each cut. Keep only what is load-bearing for the failure.
|
|
61
|
+
3. **Done when**: Every remaining parameter is load-bearing (removing any one makes the loop go green).
|
|
73
62
|
|
|
74
|
-
|
|
63
|
+
---
|
|
75
64
|
|
|
76
|
-
|
|
77
|
-
- the smallest failing test and its inputs
|
|
78
|
-
- request and response data at the failing boundary
|
|
79
|
-
- console and network errors
|
|
80
|
-
- callers, imports, data flow, and configuration reads
|
|
81
|
-
- `git diff`, `git log`, and `git blame` for a suspected regression
|
|
82
|
-
- comparison with a nearby working path or input
|
|
65
|
+
### Phase 3: Form 3–5 Ranked Falsifiable Hypotheses
|
|
83
66
|
|
|
84
|
-
|
|
85
|
-
first. Do not stop at the first plausible line, blame a dependency without
|
|
86
|
-
evidence, or confuse the place an error surfaced with the place it originated.
|
|
67
|
+
Generate **3 to 5 ranked hypotheses** before testing or inspecting deeply. Never anchor on the first plausible idea.
|
|
87
68
|
|
|
88
|
-
|
|
69
|
+
Every hypothesis MUST be **falsifiable** using this exact format:
|
|
70
|
+
> *"If `<X>` is the cause, then `<changing Y>` will make the bug disappear / `<changing Z>` will make it worse."*
|
|
89
71
|
|
|
90
|
-
|
|
72
|
+
If you cannot state the prediction, it is a vibe: sharpen or discard it.
|
|
91
73
|
|
|
92
|
-
|
|
93
|
-
2. the responsible code, configuration, or contract
|
|
94
|
-
3. the observed failure
|
|
74
|
+
---
|
|
95
75
|
|
|
96
|
-
|
|
97
|
-
confirm the connection. Do not change implementation or tests to prove the fix.
|
|
76
|
+
### Phase 4: Targeted Instrumentation & Isolation
|
|
98
77
|
|
|
99
|
-
|
|
78
|
+
Test hypotheses by changing **one variable at a time**:
|
|
79
|
+
1. **Tool preference**: Read-only inspection > REPL/debugger > Targeted probe logs.
|
|
80
|
+
2. **Debug Tag Rule**: If temporary diagnostic logs are necessary, tag every log line with a unique prefix, e.g. `[DEBUG-a4f2]`. This guarantees a single `grep` can find and remove all probes.
|
|
81
|
+
3. **Redaction**: Redact all secrets, tokens, and credentials in terminal outputs (`<REDACTED>`).
|
|
100
82
|
|
|
101
|
-
|
|
102
|
-
- **Likely** - evidence narrows the cause, but one specific proof is unavailable.
|
|
103
|
-
- **Blocked** - the failure cannot be reproduced or required evidence is
|
|
104
|
-
inaccessible.
|
|
83
|
+
---
|
|
105
84
|
|
|
106
|
-
|
|
85
|
+
### Phase 5: Confirm Root Cause at Real Seam
|
|
107
86
|
|
|
108
|
-
|
|
87
|
+
A root cause is **Confirmed** only when empirical evidence connects all three:
|
|
88
|
+
1. The triggering input or state
|
|
89
|
+
2. The responsible code / configuration boundary
|
|
90
|
+
3. The observed failure
|
|
109
91
|
|
|
110
|
-
-
|
|
111
|
-
- verdict
|
|
112
|
-
- root cause or leading hypothesis
|
|
113
|
-
- evidence, including commands and relevant paths
|
|
114
|
-
- affected behavior and likely repair boundary
|
|
115
|
-
- what was not verified
|
|
116
|
-
- exact next action
|
|
92
|
+
**Seam Identification**: Identify the exact architectural seam (per `devflow/context/coding-standards.md` Deep Modules) where the regression test must live. If no clean seam exists, note that as an architectural finding.
|
|
117
93
|
|
|
118
|
-
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
### Phase 6: Report & Hand-off
|
|
97
|
+
|
|
98
|
+
Give a structured, concise debug report:
|
|
119
99
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
-
|
|
100
|
+
```markdown
|
|
101
|
+
### 🐞 Debug Report: <Concise Title>
|
|
102
|
+
|
|
103
|
+
- **Symptom**: <Exact user symptom observed>
|
|
104
|
+
- **Reproduction Command**: `<Single red-capable command>`
|
|
105
|
+
- **Verdict**: Confirmed | Likely | Blocked
|
|
106
|
+
- **Root Cause**: <Precise technical explanation of why it failed>
|
|
107
|
+
- **Responsible Seam**: `<path/to/file.ts#line>`
|
|
108
|
+
- **Evidence**:
|
|
109
|
+
- Test/Curl output confirming the red signal
|
|
110
|
+
- Trace connecting triggering state to failure
|
|
111
|
+
- **Next Action**:
|
|
112
|
+
- For active feature -> Hand back to `/implement` with instructions to write failing test first.
|
|
113
|
+
- For standalone bug -> Recommend `/fix "<concise description>"` to create spec and implement regression test.
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
---
|
|
124
117
|
|
|
125
118
|
## Rules
|
|
126
119
|
|
|
127
|
-
- Diagnose, do not repair
|
|
128
|
-
|
|
129
|
-
- Never
|
|
130
|
-
-
|
|
131
|
-
findings; `/debug` reports one investigated failure in chat.
|
|
132
|
-
- Evidence outranks confidence. Label uncertainty and failed reproduction
|
|
133
|
-
honestly.
|
|
134
|
-
- Preserve the user's working tree and running processes.
|
|
135
|
-
- Do not broaden one failure into a general audit or refactor.
|
|
136
|
-
|
|
137
|
-
## Formatting
|
|
138
|
-
|
|
139
|
-
Format the output to match the project's conventions in
|
|
140
|
-
`devflow/context/ai-interaction.md`: concise, scannable markdown with a short
|
|
141
|
-
evidence list and a clear next action.
|
|
120
|
+
- **Diagnose, do not repair**: Never edit production source, package lockfiles, or DevFlow state inside `/debug`.
|
|
121
|
+
- **Evidence outranks confidence**: Label uncertainty honestly (`Likely` vs `Confirmed`).
|
|
122
|
+
- **Preserve git state**: Never switch branches, commit, reset, or clean the working tree.
|
|
123
|
+
- **Clean up probes**: Ensure any temporary test scripts in scratch/ are cleanly referenced.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: devflow
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Flagship interactive guide, state inspector, and intent router for DevFlow workflows."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# devflow - Interactive Workflow Guide & Intent Router for Nexus-DevFlow
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: discovery
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Unified discovery and exploration stage in DevFlow 2.5.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level pre-delivery exploration before the Single Living Spec lifecycle."
|
|
4
4
|
argument-hint: "[{title, request, IDEA-xxx, or discovery-id}]"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -10,7 +10,7 @@ $ARGUMENTS
|
|
|
10
10
|
|
|
11
11
|
`/discovery` is the central discovery entry point in Nexus-DevFlow. It operates in two adaptive modes based on input scope:
|
|
12
12
|
1. **🗺️ Macro Project Discovery**: Develops high-level product and build roadmap plans (`devflow/project-plan.md` & `devflow/build-plan.md`) through an adaptive conversation before `/overview`.
|
|
13
|
-
2. **🔍 Micro Feature Exploration (
|
|
13
|
+
2. **🔍 Micro Feature Exploration (Pre-Flight)**: Explores a specific feature, request, or idea before committing to delivery, routes through supporting lenses, and finishes with a visible `Proceed`, `Defer`, or `Reject` decision before `/feature` or `/fix`.
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -21,7 +21,7 @@ $ARGUMENTS
|
|
|
21
21
|
/discovery
|
|
22
22
|
/discovery --project
|
|
23
23
|
|
|
24
|
-
# 2. Micro Feature Exploration Mode (
|
|
24
|
+
# 2. Micro Feature Exploration Mode (Pre-Flight)
|
|
25
25
|
/discovery {title or request}
|
|
26
26
|
/discovery IDEA-xxx
|
|
27
27
|
/discovery {discovery-id}
|
|
@@ -44,7 +44,7 @@ Use when:
|
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
47
|
-
## Mode 2: Micro Feature Exploration (
|
|
47
|
+
## Mode 2: Micro Feature Exploration (Pre-Flight)
|
|
48
48
|
|
|
49
49
|
Use when:
|
|
50
50
|
- Exploring a specific feature, complex architectural change, or pending idea (`/discovery IDEA-xxx`).
|
|
@@ -76,8 +76,7 @@ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
|
|
|
76
76
|
### Decision & Approval Gate:
|
|
77
77
|
Set one visible decision:
|
|
78
78
|
- `Proceed`: Enough value and evidence exist to define delivery work:
|
|
79
|
-
-
|
|
80
|
-
- **🏗️ Deep-Track (For large architectural epics/migrations)**: Handoff to `10-define {discovery_id}` (writes `devflow/context/current-run/10-define.md`).
|
|
79
|
+
- Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` to create the Single Living Spec in `devflow/context/current-feature.md`.
|
|
81
80
|
- `Defer`: The idea remains relevant but timing or evidence is not ready.
|
|
82
81
|
- `Reject`: The idea should not proceed under current framing.
|
|
83
82
|
|
|
@@ -86,6 +85,5 @@ Set one visible decision:
|
|
|
86
85
|
## Next Workflow Recommendations
|
|
87
86
|
|
|
88
87
|
- **From Macro Project Mode**: Run `/overview` to compile context into `devflow/context/project-overview.md`.
|
|
89
|
-
- **From Micro
|
|
90
|
-
- **From Micro
|
|
91
|
-
- **From Micro Stage 00 (Defer / Reject)**: No next command needed.
|
|
88
|
+
- **From Micro Pre-Flight (Approved Proceed)**: Run `/feature {discovery_id}` or `/fix {discovery_id}` to start the Single Living Spec lifecycle.
|
|
89
|
+
- **From Micro Pre-Flight (Defer / Reject)**: No next command needed.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: doctor
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, optional verification and CI, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly, wants a health check, setup check, doctor pass, or says something feels off before starting or resuming work."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# doctor - Blueprint health check
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: feature
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Turn a feature from build-plan.md into a buildable living spec. Supports Multi-Run Spec Queue: drafts dedicated context in devflow/context/{xxx-slug}/ without blocking additional specs. With no argument, specs the next unchecked item; given a number or name, specs that one. Sizes and splits large items (4a, 4b), generates TDD checklist steps, red-teams the draft, and stops at review gate. Use when running /feature, naming a feature, or drafting the next living spec."
|
|
4
|
+
argument-hint: "[{number, name, DISC-id, or IDEA-id}]"
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# feature - turn a build-plan feature into a buildable spec
|
|
@@ -8,18 +9,22 @@ description: "[devflow][F] Turn a feature from build-plan.md into a buildable sp
|
|
|
8
9
|
Where this sits in the workflow:
|
|
9
10
|
|
|
10
11
|
project-overview.md + build-plan.md -> [this skill] -> build
|
|
11
|
-
(source of truth, (which feature (the spec
|
|
12
|
-
from /overview) to build)
|
|
12
|
+
(source of truth, (which feature (the spec in (code,
|
|
13
|
+
from /overview) to build) contexts/xxx/) reviewed)
|
|
13
14
|
|
|
14
15
|
`build-plan.md` is intentionally high-level - one line per feature, no detail,
|
|
15
16
|
no ordering ceremony. All of that is this skill's job: take one listed feature,
|
|
16
17
|
read the full context from `project-overview.md`, and turn it into something
|
|
17
|
-
buildable.
|
|
18
|
+
buildable in `devflow/context/{xxx-slug}/spec.md`.
|
|
19
|
+
|
|
20
|
+
## Multi-Run Spec-Ahead Support
|
|
21
|
+
|
|
22
|
+
`/feature` supports drafting multiple specs ahead of time. Creating a spec creates a dedicated workspace directory at `devflow/context/{xxx-slug}/` and does **not block** drafting subsequent features.
|
|
18
23
|
|
|
19
24
|
## Input
|
|
20
25
|
|
|
21
26
|
A feature from `build-plan.md`, by number or name - e.g. `/feature 3` or
|
|
22
|
-
`/feature "typing engine"`.
|
|
27
|
+
`/feature "typing engine"` or `/feature DISC-20260826-001`.
|
|
23
28
|
|
|
24
29
|
The request may also describe a genuinely new feature that is not in the build
|
|
25
30
|
plan yet. That goes through the new-feature intake in Step 1. Never silently add
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: fix
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Document an ad-hoc bug fix or small change (one not in the build plan) into devflow/context/{xxx-slug}/spec.md so it runs through the same build loop. Supports Multi-Run: drafts dedicated fix context and allows selective /implement [id]. Writes a short fix spec and stops; then /implement builds it and /complete logs it to devflow/history/fixes/ and merges. Use when running /fix, reporting a bug, or fixing an ad-hoc issue."
|
|
4
|
+
argument-hint: "[{title or issue-description}]"
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# fix - document an ad-hoc fix, then build it like anything else
|
|
@@ -13,7 +14,7 @@ Where this sits in the workflow:
|
|
|
13
14
|
|
|
14
15
|
A fix is a bug or small change that isn't a planned build-plan feature. It runs
|
|
15
16
|
through the same loop as a feature (build with review gates, iterate, then merge);
|
|
16
|
-
it
|
|
17
|
+
it creates a dedicated run folder at `devflow/context/{xxx-slug}/` (e.g. `059-fix-login-error`).
|
|
17
18
|
|
|
18
19
|
## Input
|
|
19
20
|
|
|
@@ -21,16 +22,13 @@ A description of the bug or change, for example `/fix "password reset email neve
|
|
|
21
22
|
sends"`. If the user just reported the problem in chat, use that.
|
|
22
23
|
|
|
23
24
|
The input may also be a finding ID from `devflow/context/findings.md`, alone
|
|
24
|
-
or with a description, for example `/fix F-03`.
|
|
25
|
-
that ledger entry. Use this form only between work items, when
|
|
26
|
-
`current-feature.md` is the reset stub: this skill overwrites that file, so
|
|
27
|
-
while a spec is active, repair its findings through `/implement` instead.
|
|
25
|
+
or with a description, for example `/fix F-03`.
|
|
28
26
|
|
|
29
27
|
## Step 1 - write the fix spec
|
|
30
28
|
|
|
31
29
|
Pull context from `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`,
|
|
32
|
-
|
|
33
|
-
|
|
30
|
+
calculate the next sequential running ID (e.g. `059-fix-slug`),
|
|
31
|
+
then write a short spec to `devflow/context/{xxx-slug}/spec.md` (and update `devflow/context/current-feature.md`). Keep it lighter than a feature spec:
|
|
34
32
|
|
|
35
33
|
- **Title** - the bug or change in a few words.
|
|
36
34
|
- **Type:** Fix (so `/complete` logs it to `devflow/history/fixes/`, not `devflow/history/features/`).
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: grill
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Interactive Socratic alignment & domain modeling - stress-test plans, extract domain glossary, and record architecture decision records (ADRs) before delivery."
|
|
4
4
|
argument-hint: "{topic, plan, or question}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: idea
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Quick idea capture and AI enrichment - analyze feasibility, value, key points, and record into devflow/ideas.md inbox."
|
|
4
4
|
argument-hint: "\"<idea text or description>\""
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: implement
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Build the feature, fix, or rollback spec, one small reviewable step at a time with Strict TDD. Supports Multi-Run: given an optional ID or name (/implement 12, /implement 012), targets that spec from devflow/context/{xxx-slug}/. Checks out matching branch, runs pre-flight drift revalidation, executes TDD steps with diffs, and offers commit checkpoints. Use when running /implement, or starting work on a spec."
|
|
4
|
+
argument-hint: "[{run-id, number, or name}]"
|
|
4
5
|
---
|
|
5
6
|
|
|
6
|
-
# implement - build the
|
|
7
|
+
# implement - build the target spec, one reviewed step at a time
|
|
7
8
|
|
|
8
9
|
Where this sits in the workflow:
|
|
9
10
|
|
|
@@ -12,7 +13,7 @@ Where this sits in the workflow:
|
|
|
12
13
|
reviewed) merge + log)
|
|
13
14
|
|
|
14
15
|
`/feature`, `/fix`, or `/rollback` wrote the spec to
|
|
15
|
-
`devflow/context/current-feature.md` and stopped.
|
|
16
|
+
`devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`) and stopped.
|
|
16
17
|
This skill turns that spec into code, following the build loop in
|
|
17
18
|
`devflow/context/ai-interaction.md`, without vibe coding: small steps, a visible diff plus
|
|
18
19
|
a plain-English explanation for each, testing, and iteration until it works, all
|
|
@@ -20,9 +21,14 @@ behind your approval. It builds on a branch and offers an optional commit
|
|
|
20
21
|
checkpoint after each step; the work-level commit, merging, and logging are
|
|
21
22
|
`/complete`'s job.
|
|
22
23
|
|
|
24
|
+
## Multi-Run Target Resolution
|
|
25
|
+
|
|
26
|
+
- **Given an ID or name** (e.g. `/implement 12`, `/implement 012`, `/implement kanban`) -> locates the matching run folder `devflow/context/{xxx-slug}/`, checks out `feature/{xxx-slug}`, and loads only that run's `spec.md`.
|
|
27
|
+
- **With no argument** (`/implement`) -> checks current git branch, or auto-picks if only 1 spec is active, or prompts the user if multiple specs are queued.
|
|
28
|
+
|
|
23
29
|
## Before you start
|
|
24
30
|
|
|
25
|
-
Read `devflow/context/current-feature.md
|
|
31
|
+
Read the target spec from `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`). If it has no real spec (still the stub, or its
|
|
26
32
|
status is already complete), stop and tell the user to run `/feature` (for a
|
|
27
33
|
planned feature), `/fix` (for an ad-hoc bug or change), or `/rollback` (for a
|
|
28
34
|
completed feature reversal) first. Pull the
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: onboard
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Set up the Blueprint after overlaying it onto a freshly scaffolded or early project. Detects the stack, tunes project files and adapters, documents real commands and existing checks, points to the optional standalone CI setup, and tells the user what to fill in before /overview or $overview. Use when the user runs /onboard, invokes $onboard, just copied the Blueprint into a new project, or asks what to do after overlaying the Blueprint. For an existing app with meaningful shipped features, use adopt instead."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# onboard - finish the Blueprint overlay setup
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: overview
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Distill user-owned planning docs into `devflow/context/project-overview.md` using a deterministic compiler. The overview is the living source of truth that agents read every session."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# overview - dynamic project overview compiler
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prototype
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Interactively prototype the look of a project. Asks about the desired look and feel and which pages to draft, proposes a plan, and only then writes throwaway static HTML/CSS mockups to prototypes/ that share one theme (a set of CSS theme variables). A plan-first, pre-build helper that sits outside the spec-driven feature loop, like scaffolding. Use when the user runs /prototype, names screens to mock up, or asks to prototype the layout, theme, or look and feel."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# prototype - lock the look before you build
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: release
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Prepare a Blueprint project for deployment to Render or Vercel. Reads the plans, project commands, app config, and current repo state; verifies build, start, output, env, health checks, and provider config; can create or update render.yaml or vercel.json when requested; and stops before any external deploy, service creation, remote env change, push, publish, or destructive action unless the user explicitly approves. Use when the user runs /release, invokes $release, asks for Render setup, Vercel setup, deploy readiness, deployment config, render.yaml, or vercel.json."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# release - deployment readiness for Render and Vercel
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: report-html
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or 60-report.md on demand."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: rollback
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Plan a safe reversal of a completed Blueprint feature using its archived spec and squashed git commit. Finds the exact feature commit, reviews later commits for dependency risk, writes a Type: Rollback spec to devflow/context/current-feature.md, and stops for review before /implement applies any code change. Use when the user runs /rollback, asks to remove or undo a completed feature, or wants to return the app to its pre-feature behavior without erasing Blueprint history."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# rollback - safely reverse a completed feature
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: status
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Show where the project stands: build-plan progress, the current feature's checked and unchecked steps, git state, drift warnings, and the exact next action. Read-only. Use when the user runs /status, asks where things stand, what's next, what's in progress, or is picking work back up after a break or a context clear."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# status - where the project stands right now
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: test
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Test execution, missing test generation, and coverage analysis across unit, integration, and smoke test suites."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Test-Driven Development, Generation & Execution
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tests
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Add or normalize unit testing for a Blueprint project. Detects the stack, reuses an existing test runner when present, or installs the stack-native unit test runner when missing, then adds one small example test, updates AGENTS.md commands, runs build and tests, and reports the diff. Use when the user runs /tests, invokes $tests, asks to add unit tests, set up unit testing, configure tests, or make tests part of the Blueprint workflow."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# tests - add unit testing to the project
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: try
|
|
3
|
-
description: "[devflow]
|
|
3
|
+
description: "[devflow] Generate a human manual try guide for the current or most recently completed Blueprint feature, fix, or rollback. Reads the spec, project commands, and available app context, then tells the user exactly what to start, where to go, what to click or run, what to expect, and what would count as wrong. Read-only. Use when the user runs /try, invokes $try, asks how to test manually, asks where to click, asks how to see the change, or wants a manual review path after /implement, /autopilot, /check, or /complete."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# try - manual review guide
|
package/template/AGENTS.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Nexus-DevFlow 2.
|
|
1
|
+
# Nexus-DevFlow 2.6.1 (The 3-Pillars & Single Living Spec Model)
|
|
2
2
|
|
|
3
3
|
Instructions for AI coding agents working in this project. This is the cross-tool entry point: Codex, Google Antigravity, Cursor, GitHub Copilot, Gemini CLI, Aider, Zed, Windsurf, and others read `AGENTS.md`. Claude Code reads `CLAUDE.md`, which imports this file (`@AGENTS.md`), so there is a single source of truth.
|
|
4
4
|
|
|
@@ -84,6 +84,16 @@
|
|
|
84
84
|
- *Dependencies*: ADR-001
|
|
85
85
|
- *Scope*: รวมความสามารถเชิงสถาปัตยกรรมระดับลึกของ Deep-Track เข้าสู่ 4 ขั้นตอนหลักของ Fast-Track บนเอกสาร Single Living Spec (`current-feature.md`) จัดเก็บประวัติแบบ Single Archive (`.md`), ปลดระวาง stage skills 10-70 ที่ซ้ำซ้อน, และปรับปรุงเอกสาร & Schemas ทั้งหมด
|
|
86
86
|
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 🚀 Phase 11: Multi-Run Context Architecture & Spec Queue Engine
|
|
90
|
+
|
|
91
|
+
- [x] **11. Multi-Run Context Architecture & Spec Queue Engine (`IDEA-026`, `DISC-20260826-001`)** `[Size: M]`
|
|
92
|
+
- *Dependencies*: Feature 10, Feature 3
|
|
93
|
+
- *Scope*: แยกจัดเก็บ Task-Specific Context เป็นโฟลเดอร์ย่อยใน `devflow/context/{xxx-slug}/`, พัฒนา Context Resolver สำหรับสลับและเรียกใช้งาน `/implement <id>`, `/check <id>`, `/complete <id>` แบบระบุ Running ID หรือ Fuzzy Match, และอัปเกรด CLI/Dashboard/Skills ให้รองรับ Spec Queue หลายรันพร้อมกัน
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
|
|
87
97
|
|
|
88
98
|
|
|
89
99
|
|
|
@@ -81,14 +81,14 @@ devflow/
|
|
|
81
81
|
## 4. Strict TDD & Two-Stage Review Interaction Rules
|
|
82
82
|
|
|
83
83
|
### 🔴🟢 Strict TDD Execution Discipline
|
|
84
|
-
During implementation in `/implement
|
|
84
|
+
During implementation in `/implement`:
|
|
85
85
|
- **Show Red Phase**: First execute tests to demonstrate expected failure *before* adding production code.
|
|
86
86
|
- **Show Green Phase**: Add minimal production code, re-run tests, and report pass rate.
|
|
87
87
|
- **Show Refactor Phase**: Polish and clean up with zero test regression.
|
|
88
88
|
- **Forbidden**: Never present functional code changes without matching test execution evidence.
|
|
89
89
|
|
|
90
90
|
### 🛡️ Two-Stage Verification Reporting
|
|
91
|
-
During `/check
|
|
91
|
+
During `/check`:
|
|
92
92
|
- **Stage 1 (Spec Fidelity Gate)**: Report each Acceptance Criterion and "Done When" status.
|
|
93
93
|
- **Stage 2 (Code Quality & Security Gate)**: Report Typecheck, Lint, Test Suites, Security checks, and Findings Ledger (0 blockers).
|
|
94
94
|
|
|
@@ -97,7 +97,7 @@ During `/check` and `50-verify`:
|
|
|
97
97
|
## 5. Standalone HTML Reporting Policy
|
|
98
98
|
|
|
99
99
|
> [!IMPORTANT]
|
|
100
|
-
> **No Auto-Generated HTML**:
|
|
100
|
+
> **No Auto-Generated HTML**: The mainline `/complete` stage strictly outputs Markdown only.
|
|
101
101
|
> When an interactive web dashboard is desired for presentation or sharing, invoke the standalone companion command:
|
|
102
102
|
> `/report:html` (or `npm run report:html -- {ID}`).
|
|
103
103
|
|
|
@@ -108,7 +108,6 @@ During `/check` and `50-verify`:
|
|
|
108
108
|
Progress lives in persistent files, not in transient chat history:
|
|
109
109
|
|
|
110
110
|
- In Fast-Track: `devflow/context/current-feature.md` maintains ticked checklist boxes `- [x]`.
|
|
111
|
-
- In Deep-Track: `devflow/context/current-run/` maintains stage markdown files.
|
|
112
111
|
- In Git: Commits, branches, and working tree maintain the code history.
|
|
113
112
|
- When starting a fresh session after a context clear, run `devflow` or inspect `current-stage.md` to pick up immediately from the next pending step.
|
|
114
113
|
|
|
@@ -116,8 +115,8 @@ Progress lives in persistent files, not in transient chat history:
|
|
|
116
115
|
|
|
117
116
|
## 6. Single Active Run Guardrail (One Thing at a Time)
|
|
118
117
|
|
|
119
|
-
- Only one active run is allowed at a time
|
|
120
|
-
- The AI will actively block opening a new feature or fix until the current one is completed with `/complete`
|
|
118
|
+
- Only one active Single Living Spec run is allowed at a time.
|
|
119
|
+
- The AI will actively block opening a new feature or fix until the current one is completed with `/complete` (or explicitly rolled back/cancelled).
|
|
121
120
|
|
|
122
121
|
---
|
|
123
122
|
|