---
repo: ralph-workplan
updated: "2026-07-08"
---

# INTENT

## Why it exists

ralph-workplan is a Claude Code skill/plugin that runs a Ralph Loop scoped to a Markdown workplan file, automatically stopping once every task in the workplan is marked done.

A Claude Code skill that starts a [Ralph Loop](https://github.com/anthropics/claude-code) tied to a workplan file. The loop retires automatically when all tasks in the workplan are done — no external services required.

## Governing principle

This repository should stay focused on the purpose above. Work that changes its
authority, ownership boundaries, or operational promises should be captured in a
workplan before implementation.

## What it enables

- A coding agent can understand why the repository exists before changing it.
- State Hub can register and coordinate work for this repository.
- Future workplans can stay connected to the repository's intended role.