AI Development Workflow

ralphy-spec

Spec-driven development with iterative AI execution.
OpenSpec + Ralph Loop in one command.

🔄
Ralph Loop AI self-corrects through iteration until task completion
📋
OpenSpec Structured specs lock intent before code is written
⚡
Ralphy-Spec Ship production-ready projects with autonomous agent workflows—no context window limits
Get Started View Source

Quick Start

01 Install (cd your-project)
npx ralphy-spec init
02 Use Commands
/ralphy:plan → Create specs from requirements
/ralphy:implement → Build with iterative loop
/ralphy:validate → Verify acceptance criteria
/ralphy:archive → Complete and archive
Files Created
.cursor/prompts/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
Example
# Plan
/ralphy:plan Add user authentication with JWT

# Implement
/ralphy:implement add-user-auth

# Validate
/ralphy:validate

# Archive
/ralphy:archive add-user-auth
/ralphy:plan → Create specs from requirements
/ralphy:implement → Build with iterative loop
/ralphy:validate → Verify acceptance criteria
/ralphy:archive → Complete and archive
Files Created
.claude/commands/
├── ralphy-plan.md
├── ralphy-implement.md
├── ralphy-validate.md
└── ralphy-archive.md

openspec/
├── specs/
├── changes/
└── project.md
Example
# Plan
/ralphy:plan Add payment processing with Stripe

# Implement
/ralphy:implement add-payments

# Validate & Archive
/ralphy:validate && /ralphy:archive add-payments
"Follow AGENTS.md to plan [feature]"
"Follow AGENTS.md to implement [change]"
"Follow AGENTS.md to validate"
"Follow AGENTS.md to archive [change]"
Files Created
AGENTS.md

openspec/
├── specs/
├── changes/
└── project.md

.ralphy/
├── config.json
└── ralph-loop.state.json
With Ralph Loop Runner
npm install -g @th0rgal/ralph-wiggum

ralph "Follow AGENTS.md to implement add-api. \
  Output <promise>DONE</promise> when complete." \
  --max-iterations 20

How It Works

01

Ralph Wiggum Loop

AI receives the same prompt repeatedly until task completion. Each iteration, it sees previous work in files and self-corrects.

while !done; do
  ai "Build X. Output DONE when complete."
done
02

OpenSpec

Specs before code. Structured specifications with acceptance criteria ensure AI knows exactly what to build.

openspec/
├── specs/      # Truth
├── changes/    # Work
└── archive/    # Done
Workflow
Plan PRD → Spec
→
Implement Loop
→
Validate Tests
→
Archive Merge
Why This Works
Vague requirements → Specs lock intent
AI stops mid-task → Loop retries
No verification → Tests validate
Manual setup → One command

Credits

Ralph Methodology Geoffrey Huntley opencode-ralph-wiggum @Th0rgal OpenSpec Fission-AI