name: nazgul:help
description: Show Nazgul quick reference — all commands, modes, and getting started guide. Use when user says "nazgul help", "what commands", or needs orientation.
disable-model-invocation: true
allowed-tools: []
metadata:
author: Jose Mejia
version: 1.2.2
Nazgul Framework — Quick Reference
Getting Started
| Command | Description |
|---|
/nazgul:init | Set up Nazgul for this project |
/nazgul:init --local | Set up without tracking files in git |
/nazgul:init --force | Reinitialize (archives current state) |
Running
| Command | Description |
|---|
/nazgul:start | Auto-detect state and continue work |
/nazgul:start "objective" | Start a specific objective |
Flags for /nazgul:start: --afk (autonomous), --yolo (no reviews), --hitl (human-in-the-loop, default), --max N (iteration limit)
Monitoring
| Command | Description |
|---|
/nazgul:status | Loop progress, task counts, review board |
/nazgul:log | Iteration history, commits, reviews |
/nazgul:task list | List all tasks with status |
Task Management
| Command | Description |
|---|
/nazgul:task add "desc" | Add a new task |
/nazgul:task skip <id> | Skip a blocked task |
/nazgul:task unblock <id> | Unblock a task |
/nazgul:task info <id> | Show task details |
/nazgul:task prioritize <id> | Move task to top of queue |
Control
| Command | Description |
|---|
/nazgul:pause | Pause loop at next iteration boundary |
/nazgul:reset | Archive state and start fresh |
/nazgul:review | Manually trigger review for a task |
/nazgul:clean | Fully remove Nazgul from this project |
Advanced
| Command | Description |
|---|
/nazgul:discover | Re-run codebase discovery |
/nazgul:context | Collect context for an objective type |
/nazgul:simplify | Post-loop cleanup pass |
/nazgul:docs | View or regenerate project documents |
/nazgul:board | Connect to GitHub Projects / Azure DevOps |
/nazgul:config | View and change settings (models, formatter, notifications) |
/nazgul:gen-spec | Interactively build a project specification |
Modes
| Mode | Description |
|---|
hitl | Human-in-the-loop (default) — confirms before major actions |
afk | Autonomous — runs unattended, commits per iteration |
yolo | Full auto — no reviews, no confirmations, maximum speed |
The 10 Rules
- Always read
plan.md first — the Recovery Pointer tells you where you are
- Files are truth, context is ephemeral — write state to disk immediately
- Follow existing patterns exactly — read before implementing
- Tests are mandatory — run after every change
- Never skip the review gate — ALL reviewers must approve
- Address ALL blocking feedback — fix every REJECT item
- One task at a time — unless using parallel Agent Teams
- Update Recovery Pointer on every state change
- Commit in AFK mode — every state transition gets a
nazgul: commit
- NAZGUL_COMPLETE means ALL tasks DONE and post-loop finished