Marathon State Manager

About

The update-state skill provides a robust, script-based interface for managing the execution state of marathon-ralph projects. By utilizing deterministic jq operations instead of manual JSON editing, it ensures that project phases, issue tracking, and failure metrics are updated atomically and accurately. It is essential for maintaining consistency during long-running autonomous coding sessions, offering built-in failure tracking and circuit breaker patterns to prevent infinite loops and manage complex task transitions without increasing token consumption.

Key Features

• Zero-token overhead execution for efficient context management
• Deterministic state updates via jq to prevent JSON corruption
• Phase-specific attempt monitoring and error signature detection
• Comprehensive failure tracking with built-in circuit breaker logic
• Automated issue progression including start, complete, and skip actions
• 9 GitHub stars

Use Cases

• Maintaining a precise, programmatic audit log of task progress and completion stats
• Preventing infinite loops during autonomous sessions via failure limits and error signatures
• Automating transitions between coding, testing, and QA phases in a development marathon