iterate

What problem does it solve?

When a current approach to a task is no longer working, the iteration skill provides a structured, reproducible way to record the failure, create a clean workspace for the next attempt, and preserve context so future agents or collaborators do not repeat the same mistakes.

Core Features & Use Cases

• Iteration discovery: Detects the current highest iteration by scanning .thoughts for iteration-NN directories.
• Changelog updates: Appends a concise summary explaining why the iteration is being restarted into .thoughts/iterations.md to guide future agents.
• Iteration initialization: Creates the next .thoughts/iteration-NN directory and seeds a progress.md with a high-level context summary.
• Use Case: When an agentic workflow stalls or a prototype approach fails, invoke this flow to record why the attempt ended and begin a new iteration without altering unrelated files.

Quick Start

Start a new iteration for the current task with reason "current approach failing to converge" so the skill appends a summary to .thoughts/iterations.md, creates the next .thoughts/iteration-NN/ directory, and initializes its progress.md.