ralph

Long-running adaptive iteration loops use a constitution-driven tmux runner to repeatedly inject a system prompt, allowing your research workflow to adapt based on new evidence found during each cycle.

Constitution-driven iteration defines your desired state in a markdown file and re-reads it each loop, ensuring adaptive planning adjusts goals dynamically rather than functioning as a stale checklist.

To start a constitution iteration loop, execute the bundled ralph runner script with your markdown constitution file, which launches a persistent tmux session spawning fresh workers per iteration.

Versioned provenance and YAML frontmatter status validation are needed when running end-to-end reproductions or refactoring loops, as they track progress and allow the tmux loop to stop when marked closed.

Yes, you can run a single iteration while inside an active loop; the skill supports three modes including drafting a constitution, launching a full loop, or executing individual iterations on demand.

The tmux runner requires a root SKILL.md-defined workflow with YAML frontmatter and will not stop automatically unless the constitution frontmatter is explicitly set to closed.