feat: initial ralph-workplan skill

Standalone Claude Code skill that ties a ralph loop to a workplan file.
Retires automatically when all tasks are done — no external dependencies.

- plugin/ralph-workplan.md      skill entrypoint
- plugin/scripts/check-done.sh  pre-start guard (reads workplan status)
- plugin/scripts/setup.sh       writes ralph state file with workplan-aware prompt
- install.sh                    copies plugin files to ~/.claude/plugins/
- workplan-spec.md              workplan file format reference
- README.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-14 19:16:57 +01:00
commit f3174cebc9
7 changed files with 426 additions and 0 deletions

39
install.sh Executable file
View File

@@ -0,0 +1,39 @@
#!/bin/bash
# install.sh — install the ralph-workplan skill into ~/.claude/plugins/
#
# Usage:
# ./install.sh # install
# ./install.sh --uninstall # remove
set -euo pipefail
PLUGIN_NAME="ralph-workplan"
PLUGIN_SRC="$(cd "$(dirname "$0")/plugin" && pwd)"
PLUGIN_DEST="${HOME}/.claude/plugins/${PLUGIN_NAME}"
if [[ "${1:-}" == "--uninstall" ]]; then
if [[ -d "$PLUGIN_DEST" ]]; then
rm -rf "$PLUGIN_DEST"
echo "✅ Uninstalled: $PLUGIN_DEST"
else
echo " Not installed (nothing to remove)"
fi
exit 0
fi
# Install
mkdir -p "${PLUGIN_DEST}/scripts"
cp "${PLUGIN_SRC}/ralph-workplan.md" "${PLUGIN_DEST}/ralph-workplan.md"
cp "${PLUGIN_SRC}/scripts/check-done.sh" "${PLUGIN_DEST}/scripts/check-done.sh"
cp "${PLUGIN_SRC}/scripts/setup.sh" "${PLUGIN_DEST}/scripts/setup.sh"
chmod +x "${PLUGIN_DEST}/scripts/check-done.sh"
chmod +x "${PLUGIN_DEST}/scripts/setup.sh"
echo "✅ Installed: $PLUGIN_DEST"
echo ""
echo " Skill: /ralph-workplan <workplan-file> [--max-iterations N]"
echo " Spec: $(cd "$(dirname "$0")" && pwd)/workplan-spec.md"
echo ""
echo " Restart Claude Code for the skill to appear."