nexus-dev-toolkit 3.0.0__tar.gz → 3.1.0__tar.gz

{nexus_dev_toolkit-3.0.0/nexus_dev_toolkit.egg-info → nexus_dev_toolkit-3.1.0}/PKG-INFO

@@ -1,16 +1,17 @@
 Metadata-Version: 2.4
 Name: nexus-dev-toolkit
-Version: 3.0.0
-Summary: LLM-agnostic developer workflow toolkit — Day 0 scaffold + Day 1 EPAV
+Version: 3.1.0
+Summary: Developer workflow toolkit for Claude Code — Day 0 scaffold + Day 1 EPAV
 Author-email: Ronald dela Cruz <rcdelacruz@users.noreply.github.com>
 License-Expression: MIT
 Project-URL: Homepage, https://nexus.coderstudio.co
+Project-URL: Documentation, https://nexus.coderstudio.co/docs
 Project-URL: Repository, https://github.com/rcdelacruz/nexus-dev-toolkit
 Project-URL: Issues, https://github.com/rcdelacruz/nexus-dev-toolkit/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: mcp[cli]>=1.27.1
 Requires-Dist: typer>=0.12.0
 Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
@@ -20,11 +21,10 @@ Dynamic: license-file
 
 # nexus-dev-toolkit
 
-[![PyPI version](https://img.shields.io/pypi/v/nexus-dev-toolkit)](https://pypi.org/project/nexus-dev-toolkit/)
-[![Python](https://img.shields.io/pypi/pyversions/nexus-dev-toolkit)](https://pypi.org/project/nexus-dev-toolkit/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Developer workflow toolkit for AI-assisted development. Gives any team a structured Day 0 scaffold and repeatable Day 1 feature cycle via the EPAV methodology.
+Developer workflow toolkit for Claude Code. Gives any team a structured Day 0 scaffold and repeatable Day 1 feature cycle via the EPAV methodology.
+
+**[Documentation](https://nexus.coderstudio.co/docs)**
 
 ---
 
@@ -32,7 +32,7 @@ Developer workflow toolkit for AI-assisted development. Gives any team a structu
 
 Ad-hoc AI prompting doesn't scale. Every dev prompts differently, context drifts, and nobody knows what the AI was told last sprint.
 
-`nexus-dev-toolkit` gives your team a single workflow:
+nexus-dev-toolkit gives your team a single workflow:
 
 - **Day 0** — scaffold the project once, production-grade, zero credentials needed
 - **Day 1** — every feature follows the same four steps: evaluate → plan → apply → validate
@@ -41,68 +41,98 @@ Every skill, every rule, every pattern lives in the project repo — versioned,
 
 ---
 
-## The Workflow
+## Setup
 
-### Day 0 — `/scaffold` (once per project)
+### 1. Install prerequisites
 
+**uv** (recommended package manager):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
-nexus init <project-dir>
+
+**Claude Code:**
+```bash
+npm install -g @anthropic-ai/claude-code
+claude login
 ```
 
-Sets up `.claude/commands/`, `.claude/settings.json`, and `knowledge/`. Then in Claude Code:
+**graphify** _(strongly recommended)_ — builds a queryable knowledge graph of your codebase. EPAV skills query this graph to understand blast radius and cross-file dependencies before touching any code.
 
+| | With graphify | Without graphify |
+|---|---|---|
+| Context loading | Scoped subgraph — fast, low token cost | Full file reads — slow, high token cost |
+| Blast radius | Accurate, graph-backed | Best-effort, grep-based |
+| Auto-update | PostToolUse hook keeps graph current | N/A |
+| EPAV skills | Full capability | Degraded but functional |
+
+```bash
+uv tool install graphifyy   # PyPI package name has double y; command is "graphify"
+graphify install             # registers /graphify skill into Claude Code
 ```
-/scaffold
+
+### 2. Install nexus-dev-toolkit
+
+```bash
+uv tool install nexus-dev-toolkit
 ```
 
-EVALUATE → PLAN → APPLY → VALIDATE. Produces a production-grade project: correct stack from your arch doc, mock auth, mock data, design system, AGENTS.md — all from your architecture document. Runs with `npm install && npm run dev` (or equivalent) from commit one.
+### 3. Initialize your project
 
-### Day 1 — EPAV (every feature, every sprint)
+```bash
+cd my-project
+nexus init .
+```
+
+### 4. Place your reference docs
+
+Before running `/scaffold`, put everything Claude needs in `docs/`:
 
 ```
-/evaluate   →   /plan   →   /apply   →   /validate
+docs/
+├── arch-docs/   ← architecture doc, ADRs
+├── figma/       ← Figma export ZIP
+├── brd/         ← Business Requirements Document
+└── prd/         ← Product Requirements Document
 ```
 
-Each step is a built-in skill in `.claude/commands/`. Every task starts with a row from the dev tasks CSV. Every task ends with acceptance criteria verified.
+### 5. Start Day 0
 
----
+Open the project in Claude Code and run:
+```
+/scaffold
+```
 
-## Install
+`/scaffold` runs EVALUATE first then stops. You drive each phase by typing the next command:
 
-**Requirements:** Python 3.10+, `uv` (recommended) or `pip`
+```
+/scaffold → (review) → /plan → (review) → /apply → (review) → /validate
+```
 
-```bash
-# Recommended
-uv tool install nexus-dev-toolkit
+### 6. Build the knowledge graph
 
-# Or via pip
-pip install nexus-dev-toolkit
+After `/scaffold` completes, run in Claude Code:
+```
+/graphify .
 ```
 
----
+This generates `graphify-out/graph.json` — required by all EPAV skills before starting Day 1.
 
-## Quick Start
+---
 
-```bash
-cd my-project
-nexus init .
-```
+## The Workflow
 
-Then open the project in Claude Code and type `/scaffold`.
+### Day 0 — `/scaffold` (once per project)
 
----
+Produces a production-grade project from your architecture document and Figma design: correct stack, mock auth, mock data, design system, AGENTS.md — zero external dependencies. Runs `npm install && npm run dev` (or equivalent) from commit one.
 
-## Commands
+### Day 1 — EPAV (every feature, every sprint)
 
-```bash
-nexus init .                 # set up .claude/commands/ + knowledge/ + .mcp.json
-nexus skill add code-review  # create a custom skill in .claude/commands/
-nexus skill list             # list all skills
-nexus rule add api-standards # create a rule in knowledge/rules/
-nexus rule list              # list all rules
-nexus update                 # update to latest version
+```
+/evaluate <task>  →  /plan  →  /apply  →  /validate
 ```
 
+Each step is a built-in skill in `.claude/commands/`. Every task starts from the dev tasks CSV. Every task ends with acceptance criteria verified.
+
 ---
 
 ## What `nexus init` Creates
@@ -116,7 +146,7 @@ nexus update                 # update to latest version
 │   ├── apply.md       ← /apply     — implement the plan
 │   ├── validate.md    ← /validate  — verify acceptance criteria
 │   └── epav.md        ← /epav      — full cycle guide
-└── settings.json      ← PostToolUse hook: graphify auto-updates after every file edit
+└── settings.json      ← PostToolUse: graphify auto-updates after every file edit
 knowledge/
 ├── rules/             ← coding standards, arch decisions
 ├── patterns/          ← reusable implementation patterns
@@ -127,8 +157,23 @@ knowledge/
 
 ---
 
+## Commands
+
+```bash
+nexus init .                 # set up .claude/commands/ + knowledge/ + .mcp.json
+nexus skill add code-review  # create a custom skill in .claude/commands/
+nexus skill list             # list all skills
+nexus rule add api-standards # create a rule in knowledge/rules/
+nexus rule list              # list all rules
+nexus update                 # update to latest version
+```
+
+---
+
 ## MCP Server
 
+`nexus init` writes `.mcp.json` automatically. For Claude Desktop, add manually:
+
 ```json
 {
   "mcpServers": {
@@ -140,8 +185,6 @@ knowledge/
 }
 ```
 
-`nexus init` writes `.mcp.json` automatically.
-
 ### MCP Tools
 
 | Tool | Purpose |

{nexus_dev_toolkit-3.0.0 → nexus_dev_toolkit-3.1.0}/README.md

@@ -1,10 +1,9 @@
 # nexus-dev-toolkit
 
-[![PyPI version](https://img.shields.io/pypi/v/nexus-dev-toolkit)](https://pypi.org/project/nexus-dev-toolkit/)
-[![Python](https://img.shields.io/pypi/pyversions/nexus-dev-toolkit)](https://pypi.org/project/nexus-dev-toolkit/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Developer workflow toolkit for AI-assisted development. Gives any team a structured Day 0 scaffold and repeatable Day 1 feature cycle via the EPAV methodology.
+Developer workflow toolkit for Claude Code. Gives any team a structured Day 0 scaffold and repeatable Day 1 feature cycle via the EPAV methodology.
+
+**[Documentation](https://nexus.coderstudio.co/docs)**
 
 ---
 
@@ -12,7 +11,7 @@ Developer workflow toolkit for AI-assisted development. Gives any team a structu
 
 Ad-hoc AI prompting doesn't scale. Every dev prompts differently, context drifts, and nobody knows what the AI was told last sprint.
 
-`nexus-dev-toolkit` gives your team a single workflow:
+nexus-dev-toolkit gives your team a single workflow:
 
 - **Day 0** — scaffold the project once, production-grade, zero credentials needed
 - **Day 1** — every feature follows the same four steps: evaluate → plan → apply → validate
@@ -21,68 +20,98 @@ Every skill, every rule, every pattern lives in the project repo — versioned,
 
 ---
 
-## The Workflow
+## Setup
 
-### Day 0 — `/scaffold` (once per project)
+### 1. Install prerequisites
 
+**uv** (recommended package manager):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
-nexus init <project-dir>
+
+**Claude Code:**
+```bash
+npm install -g @anthropic-ai/claude-code
+claude login
 ```
 
-Sets up `.claude/commands/`, `.claude/settings.json`, and `knowledge/`. Then in Claude Code:
+**graphify** _(strongly recommended)_ — builds a queryable knowledge graph of your codebase. EPAV skills query this graph to understand blast radius and cross-file dependencies before touching any code.
 
+| | With graphify | Without graphify |
+|---|---|---|
+| Context loading | Scoped subgraph — fast, low token cost | Full file reads — slow, high token cost |
+| Blast radius | Accurate, graph-backed | Best-effort, grep-based |
+| Auto-update | PostToolUse hook keeps graph current | N/A |
+| EPAV skills | Full capability | Degraded but functional |
+
+```bash
+uv tool install graphifyy   # PyPI package name has double y; command is "graphify"
+graphify install             # registers /graphify skill into Claude Code
 ```
-/scaffold
+
+### 2. Install nexus-dev-toolkit
+
+```bash
+uv tool install nexus-dev-toolkit
 ```
 
-EVALUATE → PLAN → APPLY → VALIDATE. Produces a production-grade project: correct stack from your arch doc, mock auth, mock data, design system, AGENTS.md — all from your architecture document. Runs with `npm install && npm run dev` (or equivalent) from commit one.
+### 3. Initialize your project
 
-### Day 1 — EPAV (every feature, every sprint)
+```bash
+cd my-project
+nexus init .
+```
+
+### 4. Place your reference docs
+
+Before running `/scaffold`, put everything Claude needs in `docs/`:
 
 ```
-/evaluate   →   /plan   →   /apply   →   /validate
+docs/
+├── arch-docs/   ← architecture doc, ADRs
+├── figma/       ← Figma export ZIP
+├── brd/         ← Business Requirements Document
+└── prd/         ← Product Requirements Document
 ```
 
-Each step is a built-in skill in `.claude/commands/`. Every task starts with a row from the dev tasks CSV. Every task ends with acceptance criteria verified.
+### 5. Start Day 0
 
----
+Open the project in Claude Code and run:
+```
+/scaffold
+```
 
-## Install
+`/scaffold` runs EVALUATE first then stops. You drive each phase by typing the next command:
 
-**Requirements:** Python 3.10+, `uv` (recommended) or `pip`
+```
+/scaffold → (review) → /plan → (review) → /apply → (review) → /validate
+```
 
-```bash
-# Recommended
-uv tool install nexus-dev-toolkit
+### 6. Build the knowledge graph
 
-# Or via pip
-pip install nexus-dev-toolkit
+After `/scaffold` completes, run in Claude Code:
+```
+/graphify .
 ```
 
----
+This generates `graphify-out/graph.json` — required by all EPAV skills before starting Day 1.
 
-## Quick Start
+---
 
-```bash
-cd my-project
-nexus init .
-```
+## The Workflow
 
-Then open the project in Claude Code and type `/scaffold`.
+### Day 0 — `/scaffold` (once per project)
 
----
+Produces a production-grade project from your architecture document and Figma design: correct stack, mock auth, mock data, design system, AGENTS.md — zero external dependencies. Runs `npm install && npm run dev` (or equivalent) from commit one.
 
-## Commands
+### Day 1 — EPAV (every feature, every sprint)
 
-```bash
-nexus init .                 # set up .claude/commands/ + knowledge/ + .mcp.json
-nexus skill add code-review  # create a custom skill in .claude/commands/
-nexus skill list             # list all skills
-nexus rule add api-standards # create a rule in knowledge/rules/
-nexus rule list              # list all rules
-nexus update                 # update to latest version
+```
+/evaluate <task>  →  /plan  →  /apply  →  /validate
 ```
 
+Each step is a built-in skill in `.claude/commands/`. Every task starts from the dev tasks CSV. Every task ends with acceptance criteria verified.
+
 ---
 
 ## What `nexus init` Creates
@@ -96,7 +125,7 @@ nexus update                 # update to latest version
 │   ├── apply.md       ← /apply     — implement the plan
 │   ├── validate.md    ← /validate  — verify acceptance criteria
 │   └── epav.md        ← /epav      — full cycle guide
-└── settings.json      ← PostToolUse hook: graphify auto-updates after every file edit
+└── settings.json      ← PostToolUse: graphify auto-updates after every file edit
 knowledge/
 ├── rules/             ← coding standards, arch decisions
 ├── patterns/          ← reusable implementation patterns
@@ -107,8 +136,23 @@ knowledge/
 
 ---
 
+## Commands
+
+```bash
+nexus init .                 # set up .claude/commands/ + knowledge/ + .mcp.json
+nexus skill add code-review  # create a custom skill in .claude/commands/
+nexus skill list             # list all skills
+nexus rule add api-standards # create a rule in knowledge/rules/
+nexus rule list              # list all rules
+nexus update                 # update to latest version
+```
+
+---
+
 ## MCP Server
 
+`nexus init` writes `.mcp.json` automatically. For Claude Desktop, add manually:
+
 ```json
 {
   "mcpServers": {
@@ -120,8 +164,6 @@ knowledge/
 }
 ```
 
-`nexus init` writes `.mcp.json` automatically.
-
 ### MCP Tools
 
 | Tool | Purpose |

{nexus_dev_toolkit-3.0.0 → nexus_dev_toolkit-3.1.0}/nexus_cli.py

@@ -8,7 +8,7 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-app = typer.Typer(name="nexus", no_args_is_help=True, help="nexus-dev-toolkit — LLM-agnostic developer workflow toolkit")
+app = typer.Typer(name="nexus", no_args_is_help=False, help="nexus-dev-toolkit — Day 0 scaffold + Day 1 EPAV workflow for Claude Code")
 skill_app = typer.Typer(name="skill", no_args_is_help=True, help="Manage skills in .claude/commands/")
 rule_app = typer.Typer(name="rule", no_args_is_help=True, help="Manage rules in knowledge/rules/")
 app.add_typer(skill_app, name="skill")
@@ -16,6 +16,31 @@ app.add_typer(rule_app, name="rule")
 
 console = Console()
 
+_VERSION = "3.1.0"
+
+_LOGO = """\
+[cyan]███╗   ██╗███████╗██╗  ██╗██╗   ██╗███████╗[/cyan]
+[cyan]████╗  ██║██╔════╝╚██╗██╔╝██║   ██║██╔════╝[/cyan]
+[cyan]██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║███████╗[/cyan]
+[cyan]██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║╚════██║[/cyan]
+[cyan]██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝███████║[/cyan]
+[cyan]╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝[/cyan]
+[dim white]dev toolkit[/dim white]  [dim cyan]v{version}[/dim cyan]"""
+
+
+def _print_logo() -> None:
+    from rich.padding import Padding
+    console.print()
+    console.print(Padding(_LOGO.format(version=_VERSION), (0, 2)))
+    console.print()
+
+
+@app.callback(invoke_without_command=True)
+def _callback(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        _print_logo()
+        console.print(ctx.get_help())
+
 # ── Built-in skills shipped with the package ──────────────────────────────────
 
 _SKILLS_SRC = Path(__file__).parent / "tools" / "epav" / "skills"
@@ -27,8 +52,24 @@ _BUILTIN_SKILLS = [
     "apply.md",
     "validate.md",
     "epav.md",
+    "code-review.md",
+    "database-review.md",
+    "deployment-review.md",
+    "performance-review.md",
+    "monitoring-review.md",
+]
+
+_AGENTS_SRC = Path(__file__).parent / "tools" / "agents"
+
+_BUILTIN_AGENTS = [
+    "deployment-reviewer.md",
+    "code-reviewer.md",
+    "performance-reviewer.md",
+    "monitoring-reviewer.md",
+    "database-reviewer.md",
 ]
 
+
 # ── .claude/settings.json ────────────────────────────────────────────────────
 
 _CLAUDE_SETTINGS = {
@@ -70,6 +111,7 @@ def _init_project(project_dir: Path) -> list[str]:
     """
     nexus init — sets up:
       .claude/commands/     ← built-in skills
+      .claude/agents/       ← built-in subagents
       .claude/settings.json ← PostToolUse graphify hook
       knowledge/            ← empty scaffold
     """
@@ -86,6 +128,17 @@ def _init_project(project_dir: Path) -> list[str]:
             shutil.copy2(src, dest)
             created.append(f".claude/commands/{skill_name}")
 
+    # .claude/agents/ — copy built-in subagents
+    agents_dir = project_dir / ".claude" / "agents"
+    agents_dir.mkdir(parents=True, exist_ok=True)
+
+    for agent_name in _BUILTIN_AGENTS:
+        src = _AGENTS_SRC / agent_name
+        dest = agents_dir / agent_name
+        if src.exists() and not dest.exists():
+            shutil.copy2(src, dest)
+            created.append(f".claude/agents/{agent_name}")
+
     # .claude/settings.json — PostToolUse graphify hook
     settings_path = project_dir / ".claude" / "settings.json"
     if not settings_path.exists():
@@ -121,7 +174,7 @@ def init(
 ) -> None:
     """Initialize .claude/commands/, .claude/settings.json, and knowledge/ in a project."""
     root = Path(project_dir).resolve()
-    console.print(f"\n  [cyan]▶[/cyan]  Initializing nexus in [bold]{root}[/bold]\n")
+    console.print(f"  [cyan]▶[/cyan]  Initializing nexus in [bold]{root}[/bold]\n")
 
     created = _init_project(root)
     for f in created: