@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.
Files changed (71) hide show
  1. package/README.md +58 -45
  2. package/dist/bin/create-nexus-devflow.js +9 -1
  3. package/dist/bin/create-nexus-devflow.js.map +1 -1
  4. package/dist/lib/command-catalog.js +1 -1
  5. package/dist/lib/command-catalog.js.map +1 -1
  6. package/dist/lib/core-skill-inventory.d.ts +16 -0
  7. package/dist/lib/core-skill-inventory.js +96 -0
  8. package/dist/lib/core-skill-inventory.js.map +1 -0
  9. package/dist/lib/dashboard-page.d.ts +1 -1
  10. package/dist/lib/dashboard-page.js +42 -20
  11. package/dist/lib/dashboard-page.js.map +1 -1
  12. package/dist/lib/dashboard-snapshot.js +16 -12
  13. package/dist/lib/dashboard-snapshot.js.map +1 -1
  14. package/dist/lib/dashboard.js +10 -1
  15. package/dist/lib/dashboard.js.map +1 -1
  16. package/dist/lib/doctor.js +14 -11
  17. package/dist/lib/doctor.js.map +1 -1
  18. package/dist/lib/gatekeeper.d.ts +4 -0
  19. package/dist/lib/gatekeeper.js +2 -2
  20. package/dist/lib/gatekeeper.js.map +1 -1
  21. package/dist/lib/git-status.d.ts +10 -2
  22. package/dist/lib/git-status.js +57 -29
  23. package/dist/lib/git-status.js.map +1 -1
  24. package/dist/lib/swarm-orchestrator.d.ts +4 -1
  25. package/dist/lib/swarm-orchestrator.js +2 -2
  26. package/dist/lib/swarm-orchestrator.js.map +1 -1
  27. package/dist/lib/update.js +5 -8
  28. package/dist/lib/update.js.map +1 -1
  29. package/dist/lib/version-check.js +1 -1
  30. package/dist/lib/workflow-state.js +19 -32
  31. package/dist/lib/workflow-state.js.map +1 -1
  32. package/dist/scripts/prepare-template.js +19 -16
  33. package/dist/scripts/prepare-template.js.map +1 -1
  34. package/package.json +1 -1
  35. package/template/.agents/skills/check/SKILL.md +78 -75
  36. package/template/.agents/skills/complete/SKILL.md +47 -36
  37. package/template/.agents/skills/debug/SKILL.md +76 -94
  38. package/template/.agents/skills/devflow/SKILL.md +51 -79
  39. package/template/.agents/skills/discovery/SKILL.md +7 -9
  40. package/template/.claude/skills/check/SKILL.md +78 -75
  41. package/template/.claude/skills/complete/SKILL.md +47 -36
  42. package/template/.claude/skills/debug/SKILL.md +76 -94
  43. package/template/.claude/skills/devflow/SKILL.md +51 -79
  44. package/template/.claude/skills/discovery/SKILL.md +7 -9
  45. package/template/AGENTS.md +21 -30
  46. package/template/devflow/build-plan.md +9 -0
  47. package/template/devflow/context/ai-interaction.md +43 -45
  48. package/template/devflow/context/coding-standards.md +31 -6
  49. package/template/devflow/context/current-stage.md +10 -7
  50. package/template/devflow/context/findings.md +8 -11
  51. package/template/devflow/context/glossary.md +31 -0
  52. package/template/devflow/history/HISTORY.md +1 -1
  53. package/template/devflow/project-plan.md +2 -2
  54. package/template/devflow/reference/build-plan-template.md +65 -0
  55. package/template/devflow/reference/feature-spec-template.md +110 -0
  56. package/template/devflow/reference/project-plan-template.md +128 -0
  57. package/template/devflow/reference/running-id-contract.md +12 -11
  58. package/template/.agents/skills/10-define/SKILL.md +0 -54
  59. package/template/.agents/skills/20-spec/SKILL.md +0 -155
  60. package/template/.agents/skills/30-plan/SKILL.md +0 -226
  61. package/template/.agents/skills/40-execute/SKILL.md +0 -158
  62. package/template/.agents/skills/50-verify/SKILL.md +0 -62
  63. package/template/.agents/skills/60-report/SKILL.md +0 -57
  64. package/template/.agents/skills/70-deliver/SKILL.md +0 -72
  65. package/template/.claude/skills/10-define/SKILL.md +0 -54
  66. package/template/.claude/skills/20-spec/SKILL.md +0 -155
  67. package/template/.claude/skills/30-plan/SKILL.md +0 -226
  68. package/template/.claude/skills/40-execute/SKILL.md +0 -158
  69. package/template/.claude/skills/50-verify/SKILL.md +0 -62
  70. package/template/.claude/skills/60-report/SKILL.md +0 -57
  71. 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}`