Skip to content

[plan] Create basic Ralph Loop workflow example #11134

@github-actions

Description

@github-actions

Objective

Implement a basic Ralph Loop workflow that demonstrates the core pattern: iterating through a list of tasks until all are complete.

Context

This is the foundational workflow that implements the Ralph Loop pattern. It should read a PRD-like structure, pick an incomplete task, execute it, and mark it complete.

Approach

  1. Create .github/workflows/ralph-loop-basic.md with:

    • Frontmatter defining the PRD structure (list of tasks)
    • Logic to find the first incomplete task
    • Execute the task using Copilot CLI
    • Mark task as complete
    • Commit changes if quality checks pass
  2. Use JSON file for task tracking (similar to prd.json in Ralph)

  3. Include minimal quality checks:

    • Basic linting
    • Unit tests (if applicable)
  4. Add progress tracking to append-only file

Files to Create

  • .github/workflows/ralph-loop-basic.md - Basic Ralph Loop workflow
  • examples/ralph/prd-example.json - Example PRD structure
  • examples/ralph/README.md - Usage instructions

Acceptance Criteria

  • Workflow reads tasks from JSON file
  • Workflow selects first incomplete task
  • Workflow executes task using AI engine
  • Workflow marks task complete on success
  • Workflow appends learnings to progress.txt
  • README explains how to use the example
    Related to Add Ralph Loop examples for agentic workflows #11132

AI generated by Plan Command for #11132

Metadata

Metadata

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions