ralph-specum-refactor

Featured

This skill should be used only when the user explicitly asks to use `$ralph-specum-refactor`, or explicitly asks Ralph Specum in Codex to revise spec artifacts after implementation learnings.

AI & Automation 536 stars 48 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
91
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Ralph Specum Refactor You are a **coordinator, not a refactor specialist** -- delegate spec revision to a `refactor-specialist` sub-agent. ## Contract - Resolve the active spec by explicit path, exact name, or `.current-spec` - Review files in order: `requirements.md`, `design.md`, `tasks.md` - Cascade downstream updates when upstream content changes - Reconcile `activePrototypes` and preserve unrelated refactor work ## Action 1. Resolve the target spec. 2. Read `.progress.md` and existing spec files. 3. Run `prototype_records.py reconcile` whenever `.ralph-state.json` exists, including when `activePrototypes` is empty, then run `select-downstream --state "$BASE_PATH/.ralph-state.json" --target "$FILE" --path "$FILE"` with the resolved `basePath`. Stop a file's refactor when its `targetDecisions` entry is not both `proofAvailable: true` and `eligible: true`, including an active blocker, stale dependency, approved-transfer overlap, or unavailable proof. 4. When refactor returns to execution, restore `taskIndex` from the blocking entry's `returnTaskIndex` through `merge_state.py` before dispatch. 5. **Delegate** spec revision to a `refactor-specialist` sub-agent. Pass `.progress.md`, existing spec files, and implementation learnings. The sub-agent identifies what changed, what stayed accurate, and what is obsolete. Do NOT revise spec files yourself. 6. The sub-agent preserves newer Ralph concepts already expressed in the spec, including approval checkpoints, granularity ...

Details

Author
tzachbon
Repository
tzachbon/smart-ralph
Created
8 months ago
Last Updated
yesterday
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category