Commands Reference

---

How Commands Work

Commands are slash-invoked actions you type directly in Claude Code. Each one is a markdown file with structured instructions — Claude reads the command definition and executes it step by step.

Commands work at L1 (plugin only) unless noted otherwise. Some commands pull additional data from the forge-orchestrator at L2, and one command requires forge-ui at L3.

  Daily Workflow                          Release                          Safety Net
  ──────────────                          ───────                          ──────────
  [/nxtg-forge:status]                         [/nxtg-forge:test]                    [/nxtg-forge:checkpoint]
       │                                       │                               │
       ▼                                       ▼                               ▼
  [/nxtg-forge:feature 'X']                    [/nxtg-forge:compliance]              [risky work...]
       │                                       │                               │
       ▼                                       ▼                               ▼
  [/nxtg-forge:test]                           [/nxtg-forge:docs-audit]              [/nxtg-forge:restore]
       │                                       │
       ▼                                       ▼
  [/nxtg-forge:gap-analysis]                   [/nxtg-forge:deploy]

---

Command Selection Guide

First time using Forge? → /nxtg-forge:init — 60-second setup, then /nxtg-forge:status to see your project

Want to build something? → /nxtg-forge:feature orchestrates the full cycle, or /nxtg-forge:spec for just the design

Shipping code? → /nxtg-forge:test → /nxtg-forge:deploy — test then deploy with safety checks

Worried about quality? → /nxtg-forge:gap-analysis for a full audit, /nxtg-forge:compliance for licenses and regulations

Managing state? → /nxtg-forge:checkpoint before risky changes, /nxtg-forge:restore if things go wrong

---

All 23 Commands by Category

Governance

Project health, quality metrics, and compliance — the bird's-eye view.

Command	What It Does
/nxtg-forge:init	60-second setup wizard — detects your stack, captures your vision, creates governance config
/nxtg-forge:status	Project health at a glance — git, tests, security, governance, orchestrator state
/nxtg-forge:status-enhanced	Deep status with dependency analysis, code quality trends, workstream breakdown
/nxtg-forge:gap-analysis	Analyze gaps across 5 dimensions: testing, docs, security, architecture, performance
/nxtg-forge:compliance	License compatibility, OWASP checks, SBOM generation, regulatory scanning
/nxtg-forge:command-center	Activate the 4-option command center with orchestrator integration (L2)

Feature Development

From idea to implementation with agent orchestration.

Command	What It Does
/nxtg-forge:feature	Full agent pipeline: Planner → Builder → Tester → Security — from description to working code
/nxtg-forge:spec	Generate technical specifications — architecture, data flow, API contracts, test strategy
/nxtg-forge:agent-assign	Route tasks to specialized agents by type — security, testing, performance, etc.
/nxtg-forge:integrate	Set up third-party integrations — API keys, SDKs, connection validation

Quality & Testing

Test, optimize, deploy — with safety nets.

Command	What It Does
/nxtg-forge:test	Auto-detect test runner, execute tests, report failures, coverage, and trends
/nxtg-forge:deploy	Pre-flight validation + deployment — quality gates, branch state, environment checks
/nxtg-forge:optimize	Performance and maintainability analysis — bundle size, dependencies, complexity

State Management

Checkpoints and recovery — because risky changes need safety nets.

Command	What It Does
/nxtg-forge:checkpoint	Save a restorable governance state snapshot — use before risky changes
/nxtg-forge:restore	Roll back governance state from a saved checkpoint
/nxtg-forge:report	Session activity report — what changed, what's pending, what shipped

Documentation

Keep docs alive and accurate as code evolves.

Command	What It Does
/nxtg-forge:docs-status	Documentation health and coverage — what exists, what's missing, what's stale
/nxtg-forge:docs-update	Update stale docs based on code changes — finds outdated references and suggests fixes
/nxtg-forge:docs-audit	Full documentation quality audit — completeness, accuracy, consistency

Setup & Maintenance

Install, configure, and keep Forge current.

Command	What It Does
/nxtg-forge:dashboard	Open the governance dashboard in your browser (L3 — requires forge-ui on port 5050)
/nxtg-forge:update	Update Forge plugin to latest version (works around Claude Code git sync issues)

CEO Decision Loop

Autonomous strategic governance — the executive brain.

Command	What It Does
/nxtg-forge:ceo-loop	Start ORBIT governance cycle — OBSERVE → REASON → BUILD → INSPECT → TURN
/nxtg-forge:ceo-loop-cancel	Gracefully stop the CEO loop — preserves all decisions in the journal

---

Command Cheat Sheet

The Daily Workflow

/nxtg-forge:status              # Start of session — what's the state?
/nxtg-forge:feature "add X"     # Build something
/nxtg-forge:test                # Verify it works
/nxtg-forge:gap-analysis        # Catch what you missed

Before Risky Changes

/nxtg-forge:checkpoint          # Save state
# ... do risky work ...
/nxtg-forge:restore             # Roll back if needed

Before a Release

Run these in order. Each builds confidence for the next.

Step	Command	What It Checks	If It Fails
1	/nxtg-forge:test	All tests pass, coverage meets threshold	Fix failing tests before proceeding
2	/nxtg-forge:gap-analysis --scope security	No critical security gaps	Address CRITICAL/HIGH findings
3	/nxtg-forge:compliance	License compatibility, SBOM clean	Replace incompatible deps
4	/nxtg-forge:docs-audit	Docs accurate and complete	Update stale sections
5	/nxtg-forge:deploy	Pre-flight checks + deployment	Fix blockers, re-run from step 1

Which agents run? Step 1 uses Testing. Step 2 uses Security. Step 3 uses Compliance. Step 4 uses Docs. Step 5 runs Guardian pre-flight (which re-runs tests + types + security).

# Quick version (for when you trust your pipeline):
/nxtg-forge:test && /nxtg-forge:compliance && /nxtg-forge:deploy

Deep Analysis

/nxtg-forge:gap-analysis --scope security    # Just security gaps
/nxtg-forge:gap-analysis --fix               # Gaps + remediation plan
/nxtg-forge:status-enhanced                  # Full diagnostic

---

Level Requirements

Level	Commands Available
L1 Vibe Coder	All commands except /nxtg-forge:command-center and /nxtg-forge:dashboard
L2 Pro Builder	+ /nxtg-forge:command-center (orchestrator integration)
L3 Ship Lord	+ /nxtg-forge:dashboard (visual governance UI)

Commands that work at L1 but gain features at L2: /nxtg-forge:status (adds orchestrator state), /nxtg-forge:feature (adds task tracking), /nxtg-forge:gap-analysis (adds knowledge queries).