Skip to content

Add flick: Ralph cleanup skill and script#123

Open
saiyajosh wants to merge 4 commits intosnarktank:mainfrom
saiyajosh:feat/add-flick-cleanup-skill
Open

Add flick: Ralph cleanup skill and script#123
saiyajosh wants to merge 4 commits intosnarktank:mainfrom
saiyajosh:feat/add-flick-cleanup-skill

Conversation

@saiyajosh
Copy link
Copy Markdown

@saiyajosh saiyajosh commented Mar 13, 2026

Motivation

Found myself needing to search for and cleanup these files (admittedly I just wanted to not archive, and just blow these intermediary files away), so I made this little helper.

Thought it might be useful for others, so sharing.

Summary

  • Adds a /flick skill and flick.sh script to find and delete Ralph intermediary files (prd.json, progress.txt) after a completed run.
  • Updates ralph.sh to display a cleanup tip on successful completion.

Screenshot

skill-based

image

script-based

❯ ./ralph.sh --tool claude
Starting Ralph - Tool: claude - Max iterations: 10

===============================================================
  Ralph Iteration 1 of 10 (claude)
===============================================================
All stories have `passes: true`.

<promise>COMPLETE</promise>

Ralph completed all tasks!
Completed at iteration 1 of 10

Tip: clean up Ralph's intermediary files when you're ready:
  Via your AI coding tool : /flick
  Via script (from project): path/to/ralph/flick.sh
  
  ❯ ./flick.sh

════════════════════════════════════════
Location: /Users/josh/src/ralph
Files:    prd.json,progress.txt

── prd.json (first 15 lines) ──────────
{
  "project": "Ralph",
  "branchName": "ralph/readme-benign-change",
  "description": "README Benign Change - Add one line to README.md to verify the Ralph pipeline end-to-end",
  "userStories": [
    {
      "id": "US-001",
      "title": "Add a note to README.md",
      "description": "As a developer, I want to add one benign line to README.md so that the Ralph pipeline is verified end-to-end.",
      "acceptanceCriteria": [
        "One line added to README.md (e.g., a badge, a note, or a minor clarification)",
        "Change is accurate and not misleading",
        "No other files modified besides README.md",
        "Commit is clean and repo remains in a healthy state"
      ],

Delete these files? (y/n)

Key Changes

skills/flick/SKILL.md — Claude Code skill

  • Defines the /flick skill so users can trigger cleanup directly from their AI coding tool
  • Supports --nuke, --all, "nuke it", "delete everything", and "delete all" as force-delete triggers
  • Covers the same search locations as the shell script

flick.sh — cleanup script

  • Alternative to ai-native skill (more direct, less token usage, if developer prefers)
  • Searches known Ralph file locations (project root, .agents/ralph, .claude/ralph, and user-level equivalents)
  • Shows a preview of prd.json (first 15 lines) before prompting for deletion
  • Supports --nuke and --all flags to skip confirmation prompts and delete all found files immediately

ralph.sh — completion tip

  • Prints a helpful tip on successful run completion pointing users to both the /flick skill and flick.sh script

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant