skills/pause/SKILL.md
Gracefully pause the Nazgul autonomous loop at the next iteration boundary. Use when user says "pause nazgul", "stop the loop", "halt nazgul", or wants to pause work without losing progress.
npx skillsauth add OrodruinLabs/nazgul nazgul:pauseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
/nazgul:pause — Pause the loop at the next iteration boundarycat nazgul/config.json 2>/dev/null || echo "NOT_INITIALIZED"jq -r '.paused // false' nazgul/config.json 2>/dev/null || echo "unknown"Gracefully pause the Nazgul autonomous loop so it stops at the next iteration boundary.
If the config shows "NOT_INITIALIZED":
/nazgul:init first."Read nazgul/config.json and check the paused field.
If already paused ("paused": true):
/nazgul:start to resume."Use jq to set "paused": true in nazgul/config.json:
jq '.paused = true' nazgul/config.json > nazgul/config.json.tmp && mv nazgul/config.json.tmp nazgul/config.json
After setting paused: true, generate nazgul/HANDOFF.md for human consumption:
nazgul/config.json for: iteration count, max iterations, mode, objectivenazgul/tasks/TASK-*.md files to gather status counts and detailsnazgul/docs/ for decisions madeWrite nazgul/HANDOFF.md:
# Nazgul Handoff — [date]
## Status
Iteration [current]/[max] | Mode: [hitl/afk] | Paused at: [timestamp]
## Objective
[current objective from config]
## What's Done
[List each DONE task with ✦ symbol]
- ✦ TASK-001: [title]
- ✦ TASK-002: [title]
## What's In Flight
[List IN_PROGRESS and IN_REVIEW tasks with ◆ symbol and context]
- ◆ TASK-007: [title] — [brief status from implementation log]
- ◆ TASK-008: [title] — in review, awaiting [reviewer name]
## Decisions Made
[List ADRs or key decisions from task manifests]
- ADR-001: [title]
- ADR-002: [title]
## Blockers & Gotchas
[List BLOCKED tasks with ✗ symbol and reasons]
- ✗ TASK-009: [title] — [blocked reason]
## To Resume
Run `/nazgul:start` — loop picks up from the current task.
Or `/nazgul:status` to review state before continuing.
If no tasks exist yet, write a minimal handoff:
# Nazgul Handoff — [date]
## Status
Iteration [current]/[max] | Mode: [mode] | Paused at: [timestamp]
No tasks generated yet.
## To Resume
Run `/nazgul:start` to begin.
Use symbols: ✦ for done, ◆ for in-progress, ✗ for blocked.
Output:
─── ◈ NAZGUL ▸ PAUSED ────────────────────────────────────
Handoff saved to nazgul/HANDOFF.md
Iteration [N]/[max] | [done] tasks done, [active] in flight
─── ◈ NEXT ─────────────────────────────────────────────
/nazgul:start to resume
────────────────────────────────────────────────────────
testing
Human acceptance testing — structured verification that work actually works. Run standalone or integrated in HITL review cycle.
devops
Task lifecycle management — skip, unblock, add, prioritize, info, and list tasks. Use when you need to manage individual tasks in the Nazgul pipeline.
development
Check the current state of a Nazgul autonomous loop. Use when asked about loop progress, task status, iteration count, review board status, or how the Nazgul loop is going.
development
Start or resume a Nazgul autonomous development loop. Use when user says "start nazgul", "run nazgul", "begin development", "resume the loop", or passes an objective for new work. Auto-detects project state — no arguments needed.