ralph:archive

Archive Ralph prd.json and progress.txt into dated directories under .ralph/archive.

17|1|Updated Nov 17, 2024
One-click install
npx skills add https://github.com/ruska-ai/orchestra --skill ralph-archive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph:archive
Source: https://github.com/ruska-ai/orchestra/tree/main/.claude/skills/ralph-archive
Command: npx skills add https://github.com/ruska-ai/orchestra --skill ralph-archive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill archives the current Ralph prd.json and progress.txt before starting a new feature, preventing data loss and enabling clean restarts.

Core Features & Use Cases

  • Archive Ralph run state files (prd.json and progress.txt) into a dated archive directory under .ralph/archive/YYYY-MM-DD-feature-name.
  • Derive the feature name from branchName in prd.json (strip ralph/ prefix) and handle name collisions by appending a numeric suffix.
  • Preserve existing archives and ensure a new archive is created only when needed, without deleting source files.

Quick Start

Run the archive action to move .ralph/prd.json and .ralph/progress.txt into a dated archive directory, then begin a fresh Ralph run.

Frequently Asked Questions about ralph:archive

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

FAQPage Schema
How do I archive Ralph run state files before starting a new feature?

This Skill archives Ralph run state files by moving prd.json and progress.txt into a dated directory under .ralph/archive/YYYY-MM-DD-feature-name, preventing data loss and enabling clean restarts before new features.

When should I archive prd.json and progress.txt files?

Archive prd.json and progress.txt when a Ralph run is completed or abandoned, ensuring a historical record and a smooth transition before starting subsequent work on a new feature.

How does date-based archiving handle duplicate feature names?

Date-based archiving handles duplicate feature names by deriving the name from branchName in prd.json, stripping the ralph/ prefix, and appending a numeric suffix to handle existing archives without overwriting.

Does archiving Ralph files delete the original prd.json and progress.txt?

Archiving Ralph files moves prd.json and progress.txt to the archive without deleting originals, preserving existing archives and ensuring a new archive is created only when needed.

Can I start a fresh Ralph run without losing previous progress.txt data?

Yes, you can start a fresh Ralph run without losing previous progress.txt data by archiving the current state files into a dated directory under .ralph/archive, which moves the files safely to preserve project history.