Download the PHP package satoved/lararalph without Composer
On this page you can find all versions of the php package satoved/lararalph. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download satoved/lararalph
More information about satoved/lararalph
Files in satoved/lararalph
Package lararalph
Short Description Agentic Ralph Wiggum loops for Laravel
License MIT
Homepage https://github.com/satoved/lararalph
Informations about the package lararalph
Lararalph
Laravel package that wraps the Ralph Wiggum technique into Artisan commands and Laravel-grade UX. Define requirements, plan implementation, build — through a specs-driven workflow with Claude Code doing the work in agentic loops.
What is the Ralph Wiggum Technique?
The Ralph Wiggum technique is a development methodology where Claude runs in an agentic loop: given a prompt, it reads your codebase, reasons about what to do, writes code, runs tests, and iterates until the task is complete. Each iteration gets a fresh context window. The implementation plan file on disk acts as shared state between iterations.
The core idea: three phases, two prompts, one loop.
- Define requirements — human + Claude conversation produces specs
- Plan — Claude analyzes specs vs existing code (gap analysis), produces a prioritized task list
- Build — Claude picks one task per iteration, implements, tests, commits, loop restarts with fresh context
Workflow
Specs Directory
The package manages a specs/ directory in your project root:
claude /prdcreates a timestamped folder inspecs/backlog/withPRD.mdartisan ralph:planreadsPRD.md+ existing codebase, producesIMPLEMENTATION_PLAN.mdartisan ralph:buildpicks the highest-priority unchecked task, implements it, runs tests, commits — one task per loop iteration- Finished specs move to
specs/complete/
Requirements
- PHP 8.4+, Laravel 11+
- Node.js installed
- Claude Code CLI
Installation
Publish config, specs directory, and Claude skill:
Usage
1. Define Requirements
Inside Claude Code, use the /prd skill:
Claude asks clarifying questions about the feature, then writes specs/backlog/2026-01-15-user-notifications/PRD.md. The PRD focuses on what (functional requirements, acceptance criteria, user stories) — no implementation details.
2. Plan
Claude studies your codebase against the PRD using subagents, performs gap analysis, and produces IMPLEMENTATION_PLAN.md — a prioritized bullet-point checklist of tasks to implement.
The plan is disposable. If it's wrong, regenerate it with --force. One planning loop is cheap compared to building from a bad plan.
3. Build
Each loop iteration: Claude reads the plan, picks the most important unchecked task, implements it, runs tests, updates the plan, and commits. Then the loop restarts with a fresh context window and Claude picks the next task.
Worktrees
Use --create-worktree on ralph:plan or ralph:build to run in an isolated git worktree:
This creates a sibling directory (e.g., ../myapp-2026-01-15-user-notifications/), copies .env with adjusted URLs, and runs setup commands (composer install, etc).
Configuration
config/lararalph.php:
Customizing Prompts
Planning and building prompts are Blade templates. Publish them:
Edit resources/views/vendor/lararalph/prompts/plan.blade.php and build.blade.php to adjust how Claude approaches planning and building. This is where you steer Ralph — add guardrails, change subagent counts, adjust backpressure instructions.
Customizing the PRD Skill
Published to .claude/skills/prd/SKILL.md. Edit to match your team's PRD template.
Commands
| Command | Description |
|---|---|
ralph:plan {spec?} |
Gap analysis: specs vs codebase → IMPLEMENTATION_PLAN.md |
ralph:build {spec?} |
Pick task, implement, test, commit, loop |
ralph:finish |
List and remove git worktrees |
Testing
Credits
- Geoffrey Huntley — the Ralph Wiggum technique
- Oleg Makedonsky
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of lararalph with dependencies
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^11.0||^12.0