Skip to content

Comments

feat: Add Harness Loop (Ralph Wiggum Technique) for Autonomous Development#4

Merged
guicheffer merged 1 commit intomainfrom
feat/harness-loop
Jan 19, 2026
Merged

feat: Add Harness Loop (Ralph Wiggum Technique) for Autonomous Development#4
guicheffer merged 1 commit intomainfrom
feat/harness-loop

Conversation

@guicheffer
Copy link
Owner

@guicheffer guicheffer commented Jan 19, 2026

Summary

Implements Ralph Wiggum external harness pattern to devorch, enabling fully autonomous development by running Claude Code in an external bash loop with spec-based progress tracking.

What's Included

CLI Commands:

  • devorch harness init <feature> - Initialize feature folder structure with templates
  • devorch harness create-specs <feature> - Boot Claude to investigate and write detailed specs
  • devorch harness loop <feature> - Run autonomous loop until all tasks complete
  • devorch harness list - List all features with their status
  • devorch harness status <feature> - Show detailed progress for a feature

Key Features:

  • ✅ Autonomous execution without manual intervention
  • ✅ Progress tracking via acceptance criteria checkboxes in PLAN.md
  • ✅ Iteration logs created for every loop cycle
  • ✅ Graceful completion when "## COMPLETED" marker is added
  • ✅ Configurable max iterations and verbose mode

Components Added:

  • CLI commands: src/cli/commands/harness/
  • Harness library: src/cli/lib/harness/
  • Claude runner: src/cli/lib/claude-runner/ (for spawning Claude processes)
  • Skill: templates/skills/workflow/harness/SKILL.md (/workflow:harness)
  • Documentation: docs/user-guide/harness-loop.md
  • Visual assets: docs/assets/ralph.gif, docs/assets/harness-flow.jpg

Example Usage

# 1. Initialize a feature
devorch harness init auth-system

# 2. Generate specs (Claude investigates codebase)
devorch harness create-specs auth-system

# 3. Edit PLAN.md to add tasks with acceptance criteria

# 4. Run the autonomous loop
devorch harness loop auth-system --max-iterations 20

How It Works

  1. PROMPT.md contains instructions sent to Claude each iteration
  2. PLAN.md tracks tasks with acceptance criteria checkboxes
  3. Loop reads PROMPT, sends to Claude, Claude works on first incomplete task
  4. Claude creates iteration log, updates PLAN.md, loop repeats
  5. Stops when "## COMPLETED" marker is added or max iterations reached

Learn More

Test Plan

  • TypeScript compiles without errors
  • Lint-staged passes
  • Manual testing: devorch harness init test-feature
  • Manual testing: devorch harness list
  • Manual testing: devorch harness status test-feature

🤖 Generated with Claude Code

…pment

Ports the Ralph Wiggum external harness pattern from spec-machine, enabling
fully autonomous development by running Claude Code in an external bash loop
with spec-based progress tracking.

**Commands Added:**
- `devorch harness init <feature>` - Initialize feature folder structure
- `devorch harness create-specs <feature>` - Generate specs interactively
- `devorch harness loop <feature>` - Run autonomous loop until completion
- `devorch harness list` - List all features with status
- `devorch harness status <feature>` - Show detailed progress

**Key Features:**
- Autonomous execution without manual intervention
- Progress tracking via acceptance criteria checkboxes
- Iteration logs for every loop cycle
- Graceful completion with "COMPLETED" marker

**Components:**
- CLI commands: `src/cli/commands/harness/`
- Harness lib: `src/cli/lib/harness/`
- Claude runner: `src/cli/lib/claude-runner/`
- Skill: `templates/skills/workflow/harness/`
- Docs: `docs/user-guide/harness-loop.md`
- Visual assets: `docs/assets/ralph.gif`, `docs/assets/harness-flow.jpg`

Learn more: https://ghuntley.com/ralph/

Co-Authored-By: Claude <noreply@anthropic.com>
@guicheffer guicheffer self-assigned this Jan 19, 2026
@guicheffer guicheffer merged commit 4c0c1e0 into main Jan 19, 2026
5 of 6 checks passed
guicheffer added a commit that referenced this pull request Jan 22, 2026
feat: Add Harness Loop (Ralph Wiggum Technique) for Autonomous Development
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant