# SCOPE

> Lightweight boundary for agents and contributors.

## One-liner

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.

## Core Idea

ralph-workplan exists to provide the capability described in INTENT.md.

## In Scope

- Defining the workplan Markdown file format (frontmatter + task blocks)
- Providing a Claude Code skill (`/ralph-workplan`) that starts a Ralph Loop bound to a workplan file
- Self-retiring the loop when all tasks reach `done` and workplan `status: done`
- Guarding against starting a loop on an already-completed workplan
- Install/uninstall tooling (`install.sh`) for the plugin
- Basic CI smoke workflow for the plugin

## Out of Scope

- Acting as a general-purpose task runner unrelated to workplan files
- External state coordination or persistence (no state hub, no HTTP calls)
- Implementing the underlying `/ralph-loop` plugin itself (this repo only builds on top of it)
- Task scheduling across multiple repos or domains
- Any sector-specific business logic (this is a dev-tooling repo, not a domain vertical)

## Current State

- Working prototype: skill and plugin scaffolding are in place with an install script, workplan spec, and a Forgejo CI smoke workflow; not yet published or widely adopted.

## Getting Oriented

- Start with: INTENT.md
- Agent instructions: AGENTS.md
- Workplans: workplans/