What happens if a task fails multiple times?

Smart Ralph monitors a 'max-task-iterations' counter (defaulting to 5). If a task exceeds this limit, the process pauses and suggests manual intervention to resolve the underlying issue.

Can I prevent Smart Ralph from automatically committing files?

Yes, you can use the --no-commit argument to explicitly disable the automatic staging and pushing of spec or feature files to your repository.

What is the purpose of the .ralph-state.json file?

This file tracks the current execution phase, task index, and iteration count. It allows the skill to maintain context and resume progress if the development process is interrupted.

What is the Ralph Wiggum loop?

The Ralph Wiggum loop is an iterative execution pattern where the agent breaks a specification into smaller tasks and loops through them, verifying completion at each step until the entire feature is implemented.

How does Quick Mode differ from Normal Mode?

Normal Mode is interactive, requiring user approval between phases. Quick Mode skips prompts and interviews, auto-generates artifacts, and immediately begins execution for faster results.

Smart Ralph Development Workflow

Name: Smart Ralph Development Workflow
Author: tzachbon

bytzachbon

•

144

•

生産性とワークフロー

Orchestrates spec-driven development cycles using the Ralph Wiggum loop and structured state management for iterative coding tasks.

Smart Ralph serves as the foundational engine for the Ralph plugin ecosystem, enabling a robust spec-driven development workflow within Claude Code. It manages the entire lifecycle of a feature implementation—from initial artifact generation and interactive interviews to iterative task execution and branch management. By utilizing the 'Ralph Wiggum' loop, this skill ensures high-quality code output through self-correcting cycles and granular state tracking. It offers flexible execution modes, allowing developers to choose between high-speed automation via Quick Mode or human-in-the-loop validation for complex architectural changes.

主な機能

01Iterative 'Ralph Wiggum' loop for self-correcting task execution

02Granular state management using persistent JSON state files

03Automated Git branch management and spec-file commit workflows

04144 GitHub stars

05Dual execution modes: Interactive (Normal) and Fully Automated (Quick)

06Configurable retry logic to handle complex or failing development tasks

ユースケース

01Rapidly prototyping features from high-level specifications with minimal manual intervention

02Executing complex code refactors that require multiple iterative passes to ensure stability

03Maintaining a structured, state-driven development process with automated progress tracking

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tzachbon/smart-ralph smart-ralph

For use in Claude.ai and ChatGPT