Quick Start (L1 Vibe Coder)
Get AI-powered governance inside Claude Code in 30 seconds. No dependencies. No config. No runtime. Today, health scoring needs Node.js 20+ (build B3, target 2026-10-20).
The Forge plugin and orchestrator are in alpha. On 2026-10-15 (UTC) a separate NXTG.ai team (product-oracle) ran the pre-registered core-job test on a clean install of the plugin (v3.14.0) and the orchestrator (forge 1.7.0). The test passed; each repeated check passed 3 of 3 (run 7). The evidence is attached to the forge-plugin v3.14.0 release. No SLA; interfaces may change without notice. The plugin is open source (MIT) and the orchestrator is source-available (FSL-1.1).
Get AI-powered governance inside Claude Code in 30 seconds. No dependencies. No config. No runtime (today, health scoring needs Node.js 20+; build B3, target 2026-10-20).
Install
claude plugin marketplace add nxtg-ai/forge-plugin
claude plugin install nxtg-forgeThat's it. The plugin loads 33 agents, 24 slash commands, 27 knowledge skills, and its governance hooks. Everything is pure markdown, with no build step and no compilation.
Your First Command
Open Claude Code in any project and run:
/nxtg-forge:statusYou'll see:
- Project health score — A through F grade based on 8 quality dimensions
- Git status — branch, uncommitted changes, recent commits
- Test results — test count, pass rate, coverage (if available)
- Security scan — patterns for secrets, unsafe code, dependency vulnerabilities
Find What's Missing
/nxtg-forge:gap-analysisThis scans your project across 5 dimensions and tells you exactly what's missing:
| Dimension | What It Checks |
|---|---|
| Testing | File ratio, coverage reports, missing test files |
| Documentation | README presence, inline docs, API documentation |
| Security | Hardcoded secrets, eval/exec usage, npm audit |
| Architecture | File organization, large files, circular patterns |
| Performance | Bundle size, dependency count, build configuration |
Each gap comes with an actionable recommendation and priority level.
Build a Feature
/nxtg-forge:feature "add user authentication"This spawns a multi-agent team inside Claude Code:
- Planner designs the architecture and breaks work into steps
- Builder implements the feature with tests
- Guardian runs quality checks on the output
- Security reviews for vulnerabilities
You watch. They coordinate. The output is production-ready code with tests.
What's Running Behind the Scenes
The plugin installs an MCP governance server that provides 8 tools:
| Tool | What It Does |
|---|---|
forge_get_governance_health | Composite health score (0-100, A-F grade) |
forge_get_git_status | Branch, commits, clean status |
forge_get_code_metrics | Lines, files, dependencies, test ratio |
forge_run_tests | Auto-detects runner (vitest/jest/pytest) |
forge_security_scan | Pattern-based secret and vulnerability detection |
forge_list_checkpoints | Saved governance snapshots |
forge_get_governance_state | Full governance state object |
forge_open_dashboard | Generate and launch HTML health dashboard |
These tools run automatically — agents and hooks call them as needed. You don't invoke them directly.
Key Commands
| Command | What It Does |
|---|---|
/nxtg-forge:status | Project health at a glance |
/nxtg-forge:gap-analysis | Find missing tests, docs, security gaps |
/nxtg-forge:feature "desc" | Multi-agent feature development |
/nxtg-forge:test | Run tests with analysis |
/nxtg-forge:checkpoint | Save restorable project state |
/nxtg-forge:deploy | Deploy with pre-flight checks |
/nxtg-forge:docs-audit | Check documentation coverage |
When to Upgrade
L1 works standalone. You never need to install anything else.
But if you start running multiple AI tools on the same codebase (Claude Code + Codex + Antigravity CLI), you'll hit file conflicts and lost context. That's when L2 Pro Builder earns its keep.
Signs you need L2:
- Two AI tools edited the same file and one overwrote the other
- You're manually copy-pasting context between tools
- You want a task board that tracks what each tool is working on
- You need decisions and patterns to persist across sessions
Next Steps
- Upgrade to Pro Builder (L2) — Multi-tool orchestration
- Slash Commands Reference: all 24 commands in detail
- Agents Reference — When to use each of the 33 agents
What is Forge?
Forge is the coordination layer for AI coding tools — shared state, exclusive access, and a plan.
Upgrade to Pro Builder (L2)
Add multi-tool orchestration: file locking, task planning, knowledge capture, and a TUI dashboard that coordinates Claude and Codex as a team. Antigravity CLI (agy) support is in development (build B1, target 2026-10-27).