[plan] Research and document Ralph Loop pattern for agentic workflows

[github-actions]

Objective

Research the Ralph Loop pattern and document how it can be implemented using gh-aw agentic workflows.

Context

Ralph is an autonomous AI agent loop that runs AI coding tools repeatedly until all PRD items are complete. Each iteration is a fresh instance with clean context. Memory persists via git history, progress.txt, and prd.json.

Reference: https://github.com/snarktank/ralph

Approach

1. Review the Ralph Loop pattern and its key concepts:

   • Fresh context per iteration
   • Memory via git history + progress.txt + prd.json
   • Small, atomic tasks
   • Feedback loops (typecheck, tests)
   • AGENTS.md updates for learnings

2. Identify mapping between Ralph concepts and gh-aw features:

   • How to structure PRD as workflow frontmatter
   • How to track task completion state
   • How to persist learnings between iterations
   • How to implement quality checks

3. Create a design document in docs/examples/ralph-loop.md covering:

   • Overview of Ralph Loop pattern
   • Mapping to gh-aw agentic workflows
   • Proposed workflow structure
   • Key differences from bash-based Ralph

Files to Create

• docs/examples/ralph-loop.md - Design document

Acceptance Criteria

• Design document explains Ralph Loop pattern clearly
• Document maps Ralph concepts to gh-aw features
• Document outlines proposed workflow structure
• Document identifies any gaps or limitations
  Related to Add Ralph Loop examples for agentic workflows #11132

AI generated by Plan Command for #11132

[github-actions]

🍪 Issue Monster has assigned this to Copilot!

I've identified this issue as a good candidate for automated resolution and assigned it to the Copilot agent.

Note: This is the first sub-issue of parent #11132. The other sibling sub-issues (#11134-#11137) will be processed sequentially after this one completes to ensure orderly implementation of the Ralph Loop feature.

The Copilot agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

AI generated by Issue Monster