ralph-resume

Restore Ralph session state from archived JSON files and define new tasks.

2|Updated Dec 28, 2024
One-click install
npx skills add https://github.com/shonenm/dotfiles --skill ralph-resume-shonenm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-resume
Source: https://github.com/shonenm/dotfiles/tree/main/common/claude/.claude/skills/ralph-resume
Command: npx skills add https://github.com/shonenm/dotfiles --skill ralph-resume-shonenm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This Skill allows you to restore the state of completed Ralph sessions, define new tasks, and re-execute them, preventing the loss of previous work and enabling iterative development.

Core Features & Use Cases

  • State Restoration: Loads the last saved state from Ralph's archive.
  • Task Definition: Allows users to add new tasks or modify existing ones based on the previous session's context.
  • Iterative Execution: Enables continuing development by re-running sessions with updated tasks.
  • Use Case: After a Ralph session completes but before the next phase begins, you realize a crucial error handling step was missed. Use this Skill to load the previous state, add the error handling task, and resume development without starting from scratch.

Quick Start

Use the ralph-resume skill to restore the last completed Ralph session and define new tasks.

Frequently Asked Questions about ralph-resume

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restore a completed development session state from an archived JSON file?

To restore a completed development session state, load the archived JSON file to retrieve the previous session's saved tasks, phase, and iteration counters. This enables seamless continuation of iterative development without losing prior work context.

Can I add new tasks and acceptance criteria to an existing session state for continued execution?

Yes, you can define and integrate new tasks and acceptance criteria into the existing session state. The system manages task IDs and acceptance criteria IDs, resetting phase and iteration counters to re-execute the session with the updated requirements.

What is the best way to resume iterative development after realizing a task was missed in a previous session?

The best way to resume iterative development is to restore the last saved state from the session archive, add the missing task or error handling step, and re-run the session. This prevents starting from scratch and leverages existing context.

Do I need jq installed to restore Ralph session archives?

Yes, jq is a required dependency to restore Ralph session archives. The Skill uses scripts that rely on jq to parse and manage the JSON state files needed for session state restoration and task definition.

How does session state restoration handle phase and iteration counters when resuming development?

Session state restoration handles phase and iteration counters by resetting them during the integration of new tasks and acceptance criteria. This ensures a seamless continuation of the development session from a clean execution baseline.

When should I use a session restoration approach instead of starting a new development task from scratch?

You should use session restoration when a completed session lacks crucial steps like error handling, and you need to maintain the existing context. It prevents the loss of previous work and enables iterative execution by re-running with updated tasks.