Agent skill
ralph-discard
Abandon RALPH worktree without merging changes
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ralph-discard
SKILL.md
RALPH-DISCARD - Abandon Worktree
Discard a RALPH worktree and all its changes without merging.
Commands
| Command | Description |
|---|---|
/ralph-discard |
Discard current/only worktree |
/ralph-discard {spec-name} |
Discard specific worktree |
/ralph-discard --force |
Skip confirmation prompt |
/ralph-discard --all |
Discard all RALPH worktrees |
Triggers
/ralph-discard- "discard worktree"
- "abandon ralph changes"
- "delete worktree"
Process
Step 1: Select Worktree
If multiple worktrees exist:
? Which worktree do you want to discard?
○ ralph/user-authentication (4 commits, 12 files)
○ ralph/payment-integration (2 commits, 5 files)
○ All worktrees
Step 2: Show Impact
╔════════════════════════════════════════════════════════════════╗
║ Discard Warning ║
╚════════════════════════════════════════════════════════════════╝
⚠ You are about to discard:
Worktree: .worktrees/user-authentication
Branch: ralph/user-authentication
This will permanently delete:
- 4 commits
- 12 files of work
- +342 lines of code
PRD progress will NOT be affected:
- prd.json will remain unchanged
- You can re-run /ralph-run to start fresh
This action CANNOT be undone.
Step 3: Confirm
? Are you sure you want to discard this worktree?
○ Yes, discard all changes
○ No, keep the worktree
○ No, let me review first (/ralph-review)
Step 4: Execute Discard
# Remove worktree (force to handle uncommitted changes)
git worktree remove .worktrees/{spec-name} --force
# Delete the branch
git branch -D ralph/{spec-name}
Step 5: Confirm Cleanup
╔════════════════════════════════════════════════════════════════╗
║ Worktree Discarded ║
╚════════════════════════════════════════════════════════════════╝
✓ Removed worktree: .worktrees/user-authentication
✓ Deleted branch: ralph/user-authentication
The following changes were discarded:
- 4 commits
- 12 files
- +342 lines
Your main branch is unchanged.
Next steps:
- Run /ralph-run to start fresh implementation
- Run /ralph to check PRD status
Discard All
With /ralph-discard --all:
╔════════════════════════════════════════════════════════════════╗
║ Discard All Worktrees ║
╚════════════════════════════════════════════════════════════════╝
⚠ You are about to discard ALL RALPH worktrees:
1. ralph/user-authentication
- 4 commits, 12 files
2. ralph/payment-integration
- 2 commits, 5 files
Total: 6 commits, 17 files will be lost.
? Proceed with discarding all worktrees?
○ Yes, discard everything
○ No, let me choose specific worktrees
○ Cancel
Force Mode
With --force, skip confirmation:
# Used for automated cleanup or when you're certain
/ralph-discard --force
# Or for specific worktree
/ralph-discard user-authentication --force
Output:
✓ Force discarded: ralph/user-authentication
Uncommitted Changes
If the worktree has uncommitted changes:
╔════════════════════════════════════════════════════════════════╗
║ Uncommitted Changes ║
╚════════════════════════════════════════════════════════════════╝
⚠ This worktree has uncommitted changes:
Modified:
~ src/services/user.service.ts
~ tests/services/user.service.test.ts
Untracked:
+ src/utils/temp.ts
? How do you want to proceed?
○ Discard everything (including uncommitted)
○ Commit changes first, then discard
○ Cancel and review changes
Recovery Note
╔════════════════════════════════════════════════════════════════╗
║ Recovery Information ║
╚════════════════════════════════════════════════════════════════╝
If you accidentally discarded a worktree, you may be able to recover
commits using git reflog (within 30 days):
git reflog
git checkout -b recovered {commit-hash}
However, uncommitted changes CANNOT be recovered.
Error Handling
| Error | Action |
|---|---|
| No worktrees | Inform user, nothing to discard |
| Worktree not found | List available worktrees |
| Permission denied | Suggest --force flag |
| Branch in use | Checkout different branch first |
Safety Checks
Before discarding:
- Check for unique work - Warn if commits aren't pushed anywhere
- Check uncommitted changes - Extra confirmation required
- Verify worktree path - Prevent accidental deletion of wrong directory
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?