Why use this skill instead of editing JSON manually?

Manual edits are prone to syntax errors and race conditions. This skill uses deterministic jq commands for atomic, safe, and predictable updates to the marathon-ralph state file.

Can I reset the tracking if I fix a recurring issue?

Yes, the skill provides specific commands like 'reset-issue-tracking' and 'reset-on-success' to clear failure signatures and counters when a task is successfully resolved.

Does this skill increase my token usage?

No, the skill executes via shell scripts locally. It performs state updates without loading the entire JSON file into the LLM's context, providing zero-token overhead.

What happens if a specific coding phase fails repeatedly?

The skill can detect repeated error signatures and increment attempt counters. Once limits are hit, it can programmatically skip a phase or an entire issue to prevent wasted resources.

How does the circuit breaker system work?

It tracks attempts and error signatures across different phases (like plan, code, and test), automatically skipping tasks or aborting the marathon if pre-defined failure limits are reached.

Marathon State Manager

Name: Marathon State Manager
Author: gruckion

bygruckion

•

Productividad y Flujo de Trabajo

Manages and synchronizes project state using deterministic jq commands to ensure reliable task tracking and circuit breaking.

Acerca de

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.

Características Principales

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

Casos de Uso

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

Acerca de

Características Principales

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

Casos de Uso

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