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.