ralphify-spec

What problem does it solve?

Ralphify helps you avoid wasting agent cycles on one-shot requests by translating open-ended, stop-condition-driven iteration into a runnable ralph directory.

Core Features & Use Cases

• Generates a complete ralph folder: produces a valid RALPH.md with the expected YAML frontmatter and prompt body structure.
• Designs loop iteration safely: enforces iteration awareness (iteration numbering) and the COMPLETE sentinel requirement so runs terminate cleanly.
• Hardens burn-down-todos workflows: when the task is queue-driven, includes the closer gate pattern to prevent firing the closer during per-item work.
• Scaffold-first workflow: starts from ralphify’s canonical template and rewrites it to match the user’s real iterative goal.
• Project-aware commands: chooses sensible default commands and stop-condition probes based on the repo stack (Python/Rust/Node/any repo).

Quick Start

Tell your agent: “Ralphify this repetitive loop so it runs until the work is done, with a clear stop condition and a safe per-iteration approach.”