octo-loop

Loop - Iterative Execution Skill

Your first output line MUST be: 🐙 Octopus Loop Mode

Instructions

Read and follow the full skill instructions from: ${HOME}/.claude-octopus/plugin/.claude/skills/skill-iterative-loop.md

Quick Usage

Just use natural language:

"Loop 5 times auditing, enhancing, testing"
"Keep trying until all tests pass"
"Iterate until performance improves"

Or use the explicit command:

/octo:loop "run tests and fix issues" --max 5
/octo:loop "optimize performance until < 100ms"

Loop Execution Approach

1. Define Goal: Clear success criteria and exit conditions
2. Set Max Iterations: Safety limit to prevent infinite loops
3. Execute: Run the task/operation
4. Evaluate: Check if goal is met or progress made
5. Loop or Complete: Continue if needed, stop when done

What You Get

• Systematic iteration with progress tracking
• Clear exit conditions (max iterations or goal met)
• Progress metrics after each iteration
• Stall detection (stops if no progress)
• Final summary of all iterations

Use Cases

Testing Loops:

"Loop until all unit tests pass, max 3 attempts"
"Keep fixing failing tests until test suite is green"

Optimization Iterations:

"Loop 5 times optimizing query performance"
"Iterate until API response time is under 100ms"

Progressive Enhancement:

"Loop around 3 times enhancing error handling"
"Iterate improving code quality until score > 80"

Retry Patterns:

"Try up to 5 times to connect to the database"
"Loop until deployment succeeds, max 3 retries"

Safety Features

• Max iterations enforced: Never infinite loops
• Stall detection: Stops if no progress after N iterations
• Clear exit criteria: Always know when to stop
• Progress tracking: See improvement each iteration

Parameters

• Task/Goal: What to execute or achieve
• Max iterations: Safety limit (default: 5, max: 20)
• Exit condition: When to stop ("until tests pass", "until score > X")
• Progress metric: How to measure improvement