iterative-planner

Enforce a state-machine-driven Explore, Plan, Execute, Reflect, and Pivot cycle for complex AI tasks.

63|5|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/NikolasMarkou/iterative-planner --skill iterative-planner-nikolasmarkou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterative-planner
Source: https://github.com/NikolasMarkou/iterative-planner/tree/main/src
Command: npx skills add https://github.com/NikolasMarkou/iterative-planner --skill iterative-planner-nikolasmarkou

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the common AI limitation where complex, multi-step tasks lead to AI agents losing focus, repeating errors, or becoming unproductive due to context window limitations. It provides a structured, state-machine-driven approach to ensure progress and recoverability.

Core Features & Use Cases

  • State Machine Enforcement: Guides AI through a rigorous Explore → Plan → Execute → Reflect → Pivot cycle.
  • Persistent Memory: Utilizes the filesystem as a reliable, long-term memory, preventing context rot and information loss.
  • Recoverability: Ensures that every decision, failed attempt, and discovery is logged, making complex tasks manageable and auditable.
  • Use Case: Refactoring a large codebase, researching a multifaceted topic, designing a complex system, or recovering from a previous AI attempt that went off track.

Quick Start

Use the iterative planner skill to plan the task of refactoring the authentication module.

Frequently Asked Questions about iterative-planner

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

FAQPage Schema
How do I stop an AI agent from losing focus during complex multi-step tasks?

To stop an AI agent from losing focus during complex multi-step tasks, use a state-machine-driven iterative planning process. This enforces a structured Explore, Plan, Execute, Reflect, and Pivot cycle, maintaining progress and recoverability.

How does filesystem persistent memory work for AI task management?

Filesystem persistent memory for AI task management records every decision, failed attempt, and discovery as files. This prevents context rot and information loss, ensuring complex projects remain auditable and recoverable across multiple execution states.

What is the best way to plan refactoring a large codebase with AI?

The best way to plan refactoring a large codebase with AI is enforcing task decomposition through a structured state machine. Iterative planning guides the agent sequentially through exploration, planning, execution, reflection, and pivoting.

Do I need Node.js to run the iterative planner for AI task execution?

Yes, you need Node.js installed as a prerequisite to run the iterative planner. The environment provides the runtime necessary to execute the scripts that enforce the state machine and manage the persistent filesystem memory.

Why does AI repeat errors when executing complex development tasks?

AI repeats errors during complex development tasks due to context window limitations causing information loss. Implementing a structured state machine with persistent filesystem memory logs previous attempts, preventing unproductive loops.

Can I recover an AI task that went off track during execution?

You can recover an off-track AI task by utilizing a state machine that logs every decision and failed attempt. This persistent memory allows the execution process to resume from a known state instead of restarting.