nexus-devflow 2.16.0 → 2.16.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 +121 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,31 +1,145 @@
|
|
|
1
1
|
# nexus-devflow
|
|
2
2
|
|
|
3
|
-
Official Unscoped CLI for **Nexus-DevFlow** — Enterprise-Grade Agentic Workflow Layer supporting **The 3-Pillars Model & Pure Task-Isolated Living Spec Model** for AI coding agents (Google Antigravity, OpenAI Codex, Claude Code, Cursor, Copilot).
|
|
3
|
+
Official Unscoped CLI for **Nexus-DevFlow** — Enterprise-Grade Agentic Workflow Layer supporting **The 3-Pillars Model & Pure Task-Isolated Living Spec Model** for AI coding agents (Google Antigravity, OpenAI Codex, Claude Code, Cursor, Copilot, OpenCode).
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/nexus-devflow)
|
|
6
|
+
[](https://github.com/Jakkrich/nexus-devflow/actions/workflows/validate.yml)
|
|
6
7
|
[](LICENSE)
|
|
7
8
|
|
|
9
|
+
[GitHub Repository](https://github.com/Jakkrich/nexus-devflow) |
|
|
10
|
+
[Documentation](https://github.com/Jakkrich/nexus-devflow#readme) |
|
|
11
|
+
[Changelog](https://github.com/Jakkrich/nexus-devflow/blob/main/CHANGELOG.md)
|
|
12
|
+
|
|
8
13
|
---
|
|
9
14
|
|
|
10
15
|
## 🚀 Quick Start
|
|
11
16
|
|
|
12
|
-
Run directly without installation
|
|
17
|
+
Run directly without prior installation using `npx`:
|
|
13
18
|
|
|
14
19
|
```bash
|
|
15
|
-
# Overlay Nexus-DevFlow into your project
|
|
20
|
+
# 1. Overlay Nexus-DevFlow into your project directory
|
|
16
21
|
npx nexus-devflow
|
|
17
22
|
|
|
18
|
-
# Launch
|
|
23
|
+
# 2. Launch local real-time Web Dashboard (http://127.0.0.1:4318)
|
|
19
24
|
npx nexus-devflow dashboard
|
|
20
25
|
|
|
21
|
-
# Install all recommended
|
|
26
|
+
# 3. Install all recommended companion skills (archify, diagram-design, bughunter, ponytail, 9arm)
|
|
22
27
|
npx nexus-devflow skill add --recommended
|
|
23
28
|
|
|
24
|
-
#
|
|
29
|
+
# 4. Check active workspace status, living specs, and findings
|
|
25
30
|
npx nexus-devflow status
|
|
26
31
|
```
|
|
27
32
|
|
|
28
|
-
For
|
|
33
|
+
> **For existing users:** Backward-compatible invocation via `npm create @jakkrichm/nexus-devflow` and `npx @jakkrichm/create-nexus-devflow` is fully supported.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 🏛️ The 3-Pillars Architecture & Task-Isolated Living Spec Model
|
|
38
|
+
|
|
39
|
+
Nexus-DevFlow structures your project into three clear temporal pillars:
|
|
40
|
+
|
|
41
|
+
1. **🔮 Future (Backlog)**:
|
|
42
|
+
- `devflow/ideas.md` — Idea inbox with instant AI feasibility scoring.
|
|
43
|
+
- `devflow/project-plan.md` & `devflow/build-plan.md` — Master build plan & chronological roadmap.
|
|
44
|
+
2. **⚡ Present (Active Context)**:
|
|
45
|
+
- `devflow/context/` — Global Shared Source of Truth (`project-overview.md`, `coding-standards.md`, `ai-interaction.md`, `glossary.md`).
|
|
46
|
+
- `devflow/context/{xxx-slug}/` — Pure Task-Isolated Living Spec workspace (`spec.md`, `stage.md`, `findings.md`).
|
|
47
|
+
3. **📦 Past (History Archive)**:
|
|
48
|
+
- `devflow/history/` — Categorized delivery archives (`features/`, `fixes/`, `rollbacks/`, and `HISTORY.md`).
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## ⚡ The Unified 4-Stage Living Spec Lifecycle
|
|
53
|
+
|
|
54
|
+
All development tasks execute systematically through a 4-step progressive lifecycle:
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
/feature (or /fix) ──▶ /implement ──▶ /check ──▶ /complete
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
| Stage | Command | Purpose |
|
|
61
|
+
|---|---|---|
|
|
62
|
+
| **1. Feature / Fix** | `/feature`, `/fix` | Combines Discover, Define, Spec, and Plan. Allocates sequential ID (`xxx-slug`) and initializes the Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`). |
|
|
63
|
+
| **2. Implement** | `/implement [id]` | Checks out branch `feature/{xxx-slug}`, executes checklist tasks incrementally with strict **TDD discipline (Red-Green-Refactor)**, and records diff evidence. |
|
|
64
|
+
| **3. Check** | `/check [id]` | Senior QA review, multi-lane verification matrix (Typecheck, Lint, Test suites, behavioral proof), and records empirical proof into `spec.md` and findings into `findings.md`. |
|
|
65
|
+
| **4. Complete** | `/complete [id]` | Final safety pass, records Release Digest, auto-archives to `devflow/history/`, cleans up active task folder, updates `HISTORY.md`, and manages git squash-merge. |
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 🛠️ CLI Command Reference
|
|
70
|
+
|
|
71
|
+
The `nexus-devflow` CLI bundles complete management commands for agents and developers:
|
|
72
|
+
|
|
73
|
+
### 📊 Dashboard & Status
|
|
74
|
+
```bash
|
|
75
|
+
# Launch interactive web dashboard with 0ms SSR First Paint
|
|
76
|
+
npx nexus-devflow dashboard [--port 4318] [--no-open]
|
|
77
|
+
|
|
78
|
+
# Show project overview, progress, findings, git status, and next action
|
|
79
|
+
npx nexus-devflow status [--json]
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### 🧠 Skills Management (Extensible Ecosystem)
|
|
83
|
+
```bash
|
|
84
|
+
# List all installed skills across adapters
|
|
85
|
+
npx nexus-devflow skill list
|
|
86
|
+
|
|
87
|
+
# Install all recommended community companion skills in one command
|
|
88
|
+
npx nexus-devflow skill add --recommended
|
|
89
|
+
|
|
90
|
+
# Or install individual skills by name or git URL:
|
|
91
|
+
npx nexus-devflow skill add archify # Architecture, sequence & data flow trace diagrams
|
|
92
|
+
npx nexus-devflow skill add diagram-design # 39 editorial charts & presentation diagram templates
|
|
93
|
+
npx nexus-devflow skill add bughunter # Offensive security audit & vulnerability testing
|
|
94
|
+
npx nexus-devflow skill add ponytail # Lazy senior dev mode - cuts code bloat & tokens (YAGNI)
|
|
95
|
+
npx nexus-devflow skill add 9arm # Engineering rituals & post-mortem practices
|
|
96
|
+
|
|
97
|
+
# Update installed skills to latest versions
|
|
98
|
+
npx nexus-devflow skill update --recommended
|
|
99
|
+
|
|
100
|
+
# Synchronize skill inventory between .agents and .claude adapters
|
|
101
|
+
npx nexus-devflow skill sync
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### 🛡️ Quality Gatekeeper & CI/CD Hooks
|
|
105
|
+
```bash
|
|
106
|
+
# Verify active branch gates before commit/merge (exit code 0 or 1)
|
|
107
|
+
npx nexus-devflow check-gate [--strict]
|
|
108
|
+
|
|
109
|
+
# Install automatic local Git pre-commit or pre-push hook
|
|
110
|
+
npx nexus-devflow hook install pre-commit
|
|
111
|
+
npx nexus-devflow hook install pre-push
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### ⚡ Context Optimization & Agent Tooling
|
|
115
|
+
```bash
|
|
116
|
+
# Model Context Protocol (MCP) JSON-RPC Stdio Server
|
|
117
|
+
npx nexus-devflow mcp
|
|
118
|
+
|
|
119
|
+
# Just-In-Time (JIT) Dynamic Context Slicing (reduces AI tokens by 60-70%)
|
|
120
|
+
npx nexus-devflow slice --stage implement [--max-tokens 4000]
|
|
121
|
+
|
|
122
|
+
# Detect drift between code changes and active living spec
|
|
123
|
+
npx nexus-devflow drift
|
|
124
|
+
npx nexus-devflow reconcile [--fix]
|
|
125
|
+
|
|
126
|
+
# Workspace health doctor and auto-healing
|
|
127
|
+
npx nexus-devflow doctor [--fix]
|
|
128
|
+
|
|
129
|
+
# Safe framework updater (preserves your custom rules & project context)
|
|
130
|
+
npx nexus-devflow update [--dry-run]
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 🤖 Multi-Agent Compatibility
|
|
136
|
+
|
|
137
|
+
Nexus-DevFlow installs cross-compatible adapters for every major AI coding environment:
|
|
138
|
+
|
|
139
|
+
- **Google Antigravity & OpenAI Codex**: `.agents/skills/` & `AGENTS.md`
|
|
140
|
+
- **Claude Code**: `.claude/skills/` & `CLAUDE.md`
|
|
141
|
+
- **Cursor & GitHub Copilot**: `AGENTS.md`
|
|
142
|
+
- **OpenCode & Aider**: Automatic workspace discovery
|
|
29
143
|
|
|
30
144
|
---
|
|
31
145
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nexus-devflow",
|
|
3
|
-
"version": "2.16.
|
|
3
|
+
"version": "2.16.2",
|
|
4
4
|
"description": "Enterprise-grade spec-driven development framework for multi-agent workflows",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Jakkrich",
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
"package.json"
|
|
38
38
|
],
|
|
39
39
|
"dependencies": {
|
|
40
|
-
"@jakkrichm/create-nexus-devflow": "2.16.
|
|
40
|
+
"@jakkrichm/create-nexus-devflow": "2.16.2"
|
|
41
41
|
},
|
|
42
42
|
"publishConfig": {
|
|
43
43
|
"access": "public"
|