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.