AI for Developers
Agent skill (SKILL.md) Open source MIT 566

Smart Ralph

Spec-driven development with smart compaction. Claude Code plugin combining Ralph Wiggum loop with structured specification workflow.

Install

For this project
$ npx skills add tzachbon/smart-ralph -a claude-code
For every project
$ npx skills add tzachbon/smart-ralph -a claude-code -g

Or copy the skill folder into .claude/skills/ (project) or ~/.claude/skills/ (all projects).

For this project
$ npx skills add tzachbon/smart-ralph -a codex
For every project
$ npx skills add tzachbon/smart-ralph -a codex -g

Or copy the skill folder into .agents/skills/ (project) or ~/.agents/skills/ (all projects).

See the repository README for installation instructions.

When to use

Use it when you want to approve a spec before an agent builds, and to let it work through a long task list across sessions.

Smart Ralph is spec-driven development for Claude Code and Codex. It turns a feature request into a structured spec, with research, requirements, design and task files, and then executes it one task at a time with fresh context. The execution loop is self-contained and has no external plugin dependencies. Large goals can start with triage, which splits them into dependency-aware specs.

The spec files stay in the project, so you can review or edit each phase before execution. Progress is recorded between tasks and a stopped session can resume. An optional prototype can test one design question without turning throwaway code into production code. The name comes from the Ralph Wiggum loop.

Related skills

All skills