nav-loop

Executes tasks iteratively until completion with structured status signals and stagnation detection.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-loop-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-loop
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-loop
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-loop-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI coding sessions often stall mid-task, requiring repeated manual "keep going" prompts and offering no clear signal of when work is actually done. This Skill runs tasks autonomously through structured iterations with explicit completion criteria, so multi-step work finishes without constant supervision. ## Core Features & Use Cases - Dual-Condition Exit Gate: Loops exit only when at least two completion indicators (commits, passing tests, docs, markers) are met AND an explicit EXIT_SIGNAL is emitted, preventing premature or runaway termination. - Stagnation Detection with Auto-Diversification: State hashing detects repeated no-progress iterations; in autonomous mode it applies combine, radical, or reread recovery strategies instead of pausing for user input. - Phase Tracking and Status Blocks: Auto-detects INIT, RESEARCH, IMPL, VERIFY, and COMPLETE phases and renders a NAVIGATOR_STATUS block with progress percentage and machine-readable pilot-signal JSON each iteration. - Use Case: Tell the agent "Run until done: add user authentication with tests" and it iterates through research, implementation, and verification, committing changes and emitting a completion signal only when tests pass and criteria are met. ## Quick Start Ask the agent to run until done implementing your feature, for example: "Run until done: add an isPrime function with passing tests."

Frequently Asked Questions about nav-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI coding agent run until a task is done?

Invoke loop mode by saying "run until done" or "keep going until complete" followed by the task. The agent iterates through research, implementation, and verification phases, exiting only when completion indicators and an explicit exit signal are both satisfied.

How does the loop know when a task is complete?

Completion requires a dual-condition gate: at least two heuristics (code committed, tests passing, docs updated, marker created) plus an explicit EXIT_SIGNAL emitted as a pilot-signal JSON block. Either condition alone is insufficient to exit.

What happens when the loop gets stuck repeating the same state?

A stagnation detector hashes each iteration's state and triggers after a configurable threshold of identical states. By default it pauses for user input; with never_pause_on_stagnation enabled it auto-diversifies using combine, radical, or reread strategies.

Can the loop run unattended overnight without user prompts?

Yes, set iteration_approval to "none" and never_pause_on_stagnation to true in .nav-config.json. A max_iterations cap is required as a safety guard so the autonomous loop cannot spin indefinitely on a broken task.

When should I not use loop mode for a coding task?

Avoid loop mode for single-step quick fixes, exploratory work without clear completion criteria, tasks blocked on external dependencies, and changes with security implications that require human review between steps.