@jakkrichm/create-nexus-devflow 2.2.2 → 2.6.0
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/bin/create-nexus-devflow.js +9 -1
- package/dist/bin/create-nexus-devflow.js.map +1 -1
- package/dist/lib/command-catalog.js +1 -1
- package/dist/lib/command-catalog.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/dashboard-page.d.ts +1 -1
- package/dist/lib/dashboard-page.js +42 -20
- package/dist/lib/dashboard-page.js.map +1 -1
- package/dist/lib/dashboard-snapshot.js +16 -12
- package/dist/lib/dashboard-snapshot.js.map +1 -1
- package/dist/lib/dashboard.js +10 -1
- package/dist/lib/dashboard.js.map +1 -1
- package/dist/lib/doctor.js +14 -11
- package/dist/lib/doctor.js.map +1 -1
- package/dist/lib/gatekeeper.d.ts +4 -0
- package/dist/lib/gatekeeper.js +2 -2
- package/dist/lib/gatekeeper.js.map +1 -1
- package/dist/lib/git-status.d.ts +10 -2
- package/dist/lib/git-status.js +57 -29
- package/dist/lib/git-status.js.map +1 -1
- package/dist/lib/swarm-orchestrator.d.ts +4 -1
- package/dist/lib/swarm-orchestrator.js +2 -2
- package/dist/lib/swarm-orchestrator.js.map +1 -1
- package/dist/lib/update.js +5 -8
- package/dist/lib/update.js.map +1 -1
- package/dist/lib/version-check.js +1 -1
- package/dist/lib/workflow-state.js +19 -32
- package/dist/lib/workflow-state.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/check/SKILL.md +78 -75
- package/template/.agents/skills/complete/SKILL.md +47 -36
- package/template/.agents/skills/debug/SKILL.md +76 -94
- package/template/.agents/skills/devflow/SKILL.md +51 -79
- package/template/.agents/skills/discovery/SKILL.md +7 -9
- package/template/.claude/skills/check/SKILL.md +78 -75
- package/template/.claude/skills/complete/SKILL.md +47 -36
- package/template/.claude/skills/debug/SKILL.md +76 -94
- package/template/.claude/skills/devflow/SKILL.md +51 -79
- package/template/.claude/skills/discovery/SKILL.md +7 -9
- package/template/AGENTS.md +21 -30
- package/template/devflow/build-plan.md +9 -0
- package/template/devflow/context/ai-interaction.md +43 -45
- package/template/devflow/context/coding-standards.md +31 -6
- package/template/devflow/context/current-stage.md +10 -7
- package/template/devflow/context/findings.md +8 -11
- package/template/devflow/context/glossary.md +31 -0
- package/template/devflow/history/HISTORY.md +1 -1
- package/template/devflow/project-plan.md +2 -2
- package/template/devflow/reference/build-plan-template.md +65 -0
- package/template/devflow/reference/feature-spec-template.md +110 -0
- package/template/devflow/reference/project-plan-template.md +128 -0
- package/template/devflow/reference/running-id-contract.md +12 -11
- package/template/.agents/skills/10-define/SKILL.md +0 -54
- package/template/.agents/skills/20-spec/SKILL.md +0 -155
- package/template/.agents/skills/30-plan/SKILL.md +0 -226
- package/template/.agents/skills/40-execute/SKILL.md +0 -158
- package/template/.agents/skills/50-verify/SKILL.md +0 -62
- package/template/.agents/skills/60-report/SKILL.md +0 -57
- package/template/.agents/skills/70-deliver/SKILL.md +0 -72
- package/template/.claude/skills/10-define/SKILL.md +0 -54
- package/template/.claude/skills/20-spec/SKILL.md +0 -155
- package/template/.claude/skills/30-plan/SKILL.md +0 -226
- package/template/.claude/skills/40-execute/SKILL.md +0 -158
- package/template/.claude/skills/50-verify/SKILL.md +0 -62
- package/template/.claude/skills/60-report/SKILL.md +0 -57
- package/template/.claude/skills/70-deliver/SKILL.md +0 -72
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 50-verify
|
|
3
|
-
description: "[devflow][D] Verify stage in DevFlow 2.0 - perform senior QA review, record evidence, and decide pass or return-to-implement."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Phase 50: Verify Quality
|
|
7
|
-
|
|
8
|
-
Review implementation quality, run multi-lane validation, produce a verification report, and route the task forward or back to implementation.
|
|
9
|
-
|
|
10
|
-
## Usage
|
|
11
|
-
|
|
12
|
-
```text
|
|
13
|
-
50-verify {ID}
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Markdown-First Contract
|
|
17
|
-
|
|
18
|
-
Use `50-verify.md` as the primary verification artifact.
|
|
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
|
-
|
|
21
|
-
## Process & Quality Gates (Two-Stage Review Pattern)
|
|
22
|
-
|
|
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.
|
|
29
|
-
|
|
30
|
-
### Stage 2: Code Quality, Security & Architecture Gate
|
|
31
|
-
Execute multi-lane technical verification across all essential quality dimensions:
|
|
32
|
-
|
|
33
|
-
1. **Lane 1: Typecheck & Static Code Quality**:
|
|
34
|
-
- Run typecheck and static analysis (`tsc --noEmit`, `npm run lint`).
|
|
35
|
-
2. **Lane 2: Automated Test Suites (Strict TDD Gate)**:
|
|
36
|
-
- Run automated unit and integration tests (`npm test`).
|
|
37
|
-
- Confirm 100% test pass rate with zero disabled or skipped tests.
|
|
38
|
-
3. **Lane 3: Scrutinize QA & Edge Cases Review**:
|
|
39
|
-
- **Boundary Conditions**: Check empty inputs, 0/1 counts, off-by-one errors.
|
|
40
|
-
- **Null / Undefined Safety**: Verify nullish handling and strict type invariants.
|
|
41
|
-
- **Error Handling & Propagation**: Verify errors provide actionable diagnostics without swallowing.
|
|
42
|
-
4. **Lane 4: Security & Hygiene Audit**:
|
|
43
|
-
- **Secrets Check**: Ensure no hardcoded credentials or API keys exist.
|
|
44
|
-
- **Input Sanitization**: Ensure parameterized queries and validated inputs.
|
|
45
|
-
5. **Lane 5: Findings Ledger State Machine (`findings.md`)**:
|
|
46
|
-
- Inspect `devflow/context/findings.md`.
|
|
47
|
-
- **P0/P1 HARD GATE**: Any Finding of severity `P0` or `P1` in `open` or `fixed` status unconditionally blocks pass.
|
|
48
|
-
6. **Lane 6: Manual Scenario Proof**:
|
|
49
|
-
- Provide clear manual verification instructions: "Where to go", "What to run/click", "What to expect".
|
|
50
|
-
|
|
51
|
-
### 2. Decision & Route
|
|
52
|
-
|
|
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.
|
|
55
|
-
|
|
56
|
-
## Output
|
|
57
|
-
|
|
58
|
-
Report:
|
|
59
|
-
- **Stage 1 Verdict**: Spec Fidelity & Acceptance Criteria status
|
|
60
|
-
- **Stage 2 Verdict**: Technical Multi-lane quality & security matrix
|
|
61
|
-
- Evidence commands and outputs
|
|
62
|
-
- Next command: `60-report {ID}` (if pass) or `40-execute {ID}` (if fail)
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 60-report
|
|
3
|
-
description: "[devflow][D] Report stage in DevFlow 2.0 - produce standardized markdown summary report with retrospective lessons learned."
|
|
4
|
-
argument-hint: "{running-id or workspace path}"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Phase 60: Report
|
|
8
|
-
|
|
9
|
-
$ARGUMENTS
|
|
10
|
-
|
|
11
|
-
Produce the final human-friendly summary of the full running flow in Markdown (`60-report.md`) with retrospective lessons learned, findings summary, and release digest.
|
|
12
|
-
|
|
13
|
-
## Usage
|
|
14
|
-
|
|
15
|
-
```text
|
|
16
|
-
60-report {running-id or workspace path}
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Markdown-First Contract
|
|
20
|
-
|
|
21
|
-
Write the primary stage artifact to:
|
|
22
|
-
|
|
23
|
-
```text
|
|
24
|
-
devflow/context/current-run/60-report.md
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
> [!IMPORTANT]
|
|
28
|
-
> **No Auto-Generated HTML**: ห้ามสร้างไฟล์ `60-report.html` แบบอัตโนมัติในขั้นตอนนี้! ระบบจะสร้างเฉพาะ `60-report.md` เท่านั้น หากต้องการดู HTML Report ให้เรียกคำสั่งแยก: `/report:html`
|
|
29
|
-
|
|
30
|
-
## Process
|
|
31
|
-
|
|
32
|
-
### 1. Gather Full Run Context & Verification Evidence
|
|
33
|
-
Read all relevant stage artifacts:
|
|
34
|
-
- `10-define.md`
|
|
35
|
-
- `20-spec.md`
|
|
36
|
-
- `30-plan.md`
|
|
37
|
-
- `40-execute.md`
|
|
38
|
-
- `50-verify.md`
|
|
39
|
-
|
|
40
|
-
### 2. Retrospective Lessons Learned & Gotchas (Insight Extraction)
|
|
41
|
-
Extract durable insights from the completed run:
|
|
42
|
-
- **Reusable Patterns**: Design choices or implementations that future runs should mirror.
|
|
43
|
-
- **Gotchas & Pitfalls**: Unforeseen issues or quirks encountered during execution.
|
|
44
|
-
- **Unresolved Follow-ups**: Route any residual out-of-scope ideas to `devflow/ideas.md`.
|
|
45
|
-
|
|
46
|
-
### 3. Produce Standardized Report (`60-report.md`)
|
|
47
|
-
Structure the report in **Thai (`th`)**:
|
|
48
|
-
1. **Executive Summary**: ปัญหาและแนวทางแก้ไข
|
|
49
|
-
2. **Delivery Scope**: รายการฟีเจอร์และคอมโพเนนต์ที่ส่งมอบ
|
|
50
|
-
3. **Verification Evidence Snapshot**: ผลการทดสอบทุก Lane
|
|
51
|
-
4. **Retrospective & Lessons Learned**: บทเรียนและข้อควรระวัง
|
|
52
|
-
5. **Manual Try Guide**: ขั้นตอนสำหรับมนุษย์ทดสอบระบบ
|
|
53
|
-
|
|
54
|
-
## Next Workflow Recommendation
|
|
55
|
-
|
|
56
|
-
- **Primary**: `70-deliver {ID}`
|
|
57
|
-
- **Optional Standalone HTML**: `/report:html`
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 70-deliver
|
|
3
|
-
description: "[devflow][D] Deliver stage in DevFlow 2.0 - package verified work for delivery, archive run to categorized history, git merge, PR, or deployment."
|
|
4
|
-
argument-hint: "{running-id or workspace path}"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Phase 70: Deliver
|
|
8
|
-
|
|
9
|
-
$ARGUMENTS
|
|
10
|
-
|
|
11
|
-
Package approved work for delivery after the report stage has captured the final verified story. Archives the active run from `devflow/context/current-run/` to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}/`, updates `HISTORY.md` and `CHANGELOG.md`, executes pre-flight smoke checks, performs conventional git commit & merge, and closes the run.
|
|
12
|
-
|
|
13
|
-
## Usage
|
|
14
|
-
|
|
15
|
-
```text
|
|
16
|
-
70-deliver {id or workspace path}
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Markdown-First Contract
|
|
20
|
-
|
|
21
|
-
Write the primary stage artifact to:
|
|
22
|
-
|
|
23
|
-
```text
|
|
24
|
-
devflow/context/current-run/70-deliver.md
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## Process & Quality Gates
|
|
28
|
-
|
|
29
|
-
### 0. Step 0 Safety Pass & Findings Ledger Gate
|
|
30
|
-
|
|
31
|
-
Before packaging, merging, or delivering:
|
|
32
|
-
|
|
33
|
-
1. **Findings Ledger Blockers**:
|
|
34
|
-
- Inspect `devflow/context/findings.md`.
|
|
35
|
-
- No Finding of severity `P0` or `P1` in `open` or `fixed` status is permitted.
|
|
36
|
-
- `fixed` still blocks release until reviewed and closed in `50-verify`.
|
|
37
|
-
2. **Pre-flight & Deployment Smoke Validation**:
|
|
38
|
-
- Verify environment variables and configuration parameters.
|
|
39
|
-
- Run production build or package smoke check (`npm run build` or `npm run test:package`).
|
|
40
|
-
- Validate that clean state exists with no untracked experimental files.
|
|
41
|
-
3. **2-Stage Approval Separation**:
|
|
42
|
-
- Consent to merge into `main` is strictly separate from consent to `git push` to remote or deploy.
|
|
43
|
-
|
|
44
|
-
### 1. Changelog & SemVer Version Bump
|
|
45
|
-
|
|
46
|
-
1. Calculate next version according to **Semantic Versioning (SemVer)**:
|
|
47
|
-
- `Major`: Breaking architectural changes, removed public APIs
|
|
48
|
-
- `Minor`: New backward-compatible features added
|
|
49
|
-
- `Patch`: Bug fixes, optimizations, documentation
|
|
50
|
-
2. Append new release entry to `CHANGELOG.md` in [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format (`Added`, `Changed`, `Fixed`, `Removed`, `Security`).
|
|
51
|
-
|
|
52
|
-
### 2. Conventional Commit & Git Merge
|
|
53
|
-
|
|
54
|
-
1. Stage all release and tracking files.
|
|
55
|
-
2. Commit with conventional format: `chore(release): release {version}` or `feat({scope}): {summary}`.
|
|
56
|
-
3. Squash-merge to base branch (`main`) with explicit user approval.
|
|
57
|
-
|
|
58
|
-
### 3. Archive Run Folder to Categorized History
|
|
59
|
-
|
|
60
|
-
1. Determine Category (`features`, `fixes`, `rollbacks`).
|
|
61
|
-
2. Move directory `devflow/context/current-run/` ➔ `devflow/history/{category}/{xxx-slug}/`.
|
|
62
|
-
3. Clean resolved findings (`closed`, `accepted`, `invalid`) from `devflow/context/findings.md` and append to the release notes.
|
|
63
|
-
4. Append entry to `devflow/history/HISTORY.md` linking to `history/{category}/{xxx-slug}/60-report.md`.
|
|
64
|
-
|
|
65
|
-
### 4. Update Workspace State
|
|
66
|
-
|
|
67
|
-
Set `devflow/context/current-stage.md` to:
|
|
68
|
-
- `Active Discovery ID`: `None`
|
|
69
|
-
- `Active Running ID`: `None (Idle)`
|
|
70
|
-
- `Current Stage`: `Idle (Ready for new run)`
|
|
71
|
-
- `Last Completed Run`: `{ID} ({YYYY-MM-DD})`
|
|
72
|
-
- `Last Updated`: `{YYYY-MM-DD}`
|