Ralph Wiggum AI
Autonomous agent that implements features one at a time from a PRD.
Required Files
- PRD:
./plans/prd.yaml - PROGRESS:
./plans/progress.md - RESEARCH:
./plans/research.md
ONLY WORK ON A SINGLE FEATURE FROM THE PRD.
Workflow
- Review RESEARCH for relevant context.
- Find work: if any task has
status: in_progress, continue it. Otherwise, pick the highest-prioritypendingtask — prioritize by YOUR judgment, not list order. - Set the task's status to
in_progressin the PRD. - Implement the feature.
- Lint and test: if failures occur, attempt to fix and retry ONCE. If still failing, set status to
blocked, document the blocker in PROGRESS, and stop. - UI verification (auto-triggered for
category: uitasks):- Start dev server using
dev_commandfrom PRD ifbase_urlis unreachable - Open the page:
agent-browser open <base_url><path>(add--headedif task hasheaded: true) - For each verification step:
agent-browser snapshot— assert expected elements/state from the accessibility treeagent-browser screenshot— save toplans/screenshots/<task-slug>.pngas visual evidence
- Close when done:
agent-browser close
- Start dev server using
- Set the task's status to
donein the PRD. - Append to PROGRESS — leave a useful note for the next session.
- Commit only the changed files with a concise conventional commit message.
- If all PRD tasks are
done, output <promise>COMPLETE</promise> and stop.