By tzachbon
Enforces a constitution-first spec-kit development workflow with structured phases for specifying, planning, tasking, and implementing features, all managed via Git branches and autonomous agents that generate specs, plans, and execute verified tasks.
Cancel active execution loop and cleanup state
Start task execution loop
Smart entry point for new features with auto ID and branch management
Show current feature status and progress
Switch active feature
Expert in creating and maintaining project constitutions. Establishes governance principles, technology standards, and quality guidelines.
Technical architect for creating implementation plans from specifications. Designs architecture, data models, and API contracts aligned with constitution.
QA engineer that runs verification commands and checks acceptance criteria for [VERIFY] tasks.
Expert specification analyst for creating feature specs aligned with project constitution. Generates user stories, acceptance criteria, and scope definitions.
Autonomous task executor for spec-kit development. Executes a single task from tasks.md, verifies, commits, and signals completion.
Output rules for all agents - concise, scannable, actionable. Based on Matt Pocock's planning principles.
Core principle that the main agent is a coordinator, not an implementer. All work must be delegated to subagents.
Core Smart Ralph skill defining common arguments, execution modes, and shared behaviors across all Ralph plugins.
Comprehensive understanding of the spec-kit methodology. Constitution-driven feature development with specify, plan, tasks, and implement phases.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Spec-driven development for Claude Code and Codex. Task-by-task execution with fresh context per task.
Self-contained execution loop. No external dependencies.
Smart Ralph is a Claude Code plugin that turns your vague feature ideas into structured specs, then executes them task-by-task. Like having a tiny product team in your terminal.
You: "Add user authentication"
Ralph: *creates research.md, requirements.md, design.md, tasks.md*
Ralph: *executes each task with fresh context*
Ralph: "I'm helping!"
Named after the Ralph agentic loop pattern and everyone's favorite Springfield student. Ralph doesn't overthink. Ralph just does the next task. Be like Ralph.
# Install Smart Ralph
/plugin marketplace add tzachbon/smart-ralph
/plugin install ralph-specum@smart-ralph
# Restart Claude Code
Codex support ships as a versioned package under platforms/codex/. Current package version: 4.8.4.
Install the primary skill from this repo:
Prompt to send to Codex:
Use $skill-installer to install the Smart Ralph Codex skill from repo `tzachbon/smart-ralph` at path `platforms/codex/skills/ralph-specum`.
First ask whether to install globally under `$CODEX_HOME/skills` or project-local inside this repo.
Before installing, check whether an existing install already has a `manifest.json` version for Smart Ralph Codex.
Compare that installed version to `platforms/codex/manifest.json` in this repo.
If no install exists or the versions differ, run the installer for the selected target.
If the versions match, say it is already up to date and skip reinstalling.
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo tzachbon/smart-ralph \
--path platforms/codex/skills/ralph-specum
Install the helper bundle when you want explicit skill entrypoints:
Prompt to send to Codex:
Use $skill-installer to install the Smart Ralph Codex skills from repo `tzachbon/smart-ralph` at these paths:
- `platforms/codex/skills/ralph-specum`
- `platforms/codex/skills/ralph-specum-start`
- `platforms/codex/skills/ralph-specum-triage`
- `platforms/codex/skills/ralph-specum-research`
- `platforms/codex/skills/ralph-specum-requirements`
- `platforms/codex/skills/ralph-specum-design`
- `platforms/codex/skills/ralph-specum-tasks`
- `platforms/codex/skills/ralph-specum-implement`
- `platforms/codex/skills/ralph-specum-status`
- `platforms/codex/skills/ralph-specum-switch`
- `platforms/codex/skills/ralph-specum-cancel`
- `platforms/codex/skills/ralph-specum-index`
- `platforms/codex/skills/ralph-specum-refactor`
- `platforms/codex/skills/ralph-specum-feedback`
- `platforms/codex/skills/ralph-specum-help`
First ask whether to install globally under `$CODEX_HOME/skills` or project-local inside this repo.
Before installing, check whether an existing Smart Ralph Codex install already has a `manifest.json` version.
Compare that installed version to `platforms/codex/manifest.json` in this repo.
If no install exists or the versions differ, run the installer for the selected target.
If the versions match, say it is already up to date and skip reinstalling.
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo tzachbon/smart-ralph \
--path \
platforms/codex/skills/ralph-specum \
platforms/codex/skills/ralph-specum-start \
platforms/codex/skills/ralph-specum-triage \
platforms/codex/skills/ralph-specum-research \
platforms/codex/skills/ralph-specum-requirements \
platforms/codex/skills/ralph-specum-design \
platforms/codex/skills/ralph-specum-tasks \
platforms/codex/skills/ralph-specum-implement \
platforms/codex/skills/ralph-specum-status \
platforms/codex/skills/ralph-specum-switch \
platforms/codex/skills/ralph-specum-cancel \
platforms/codex/skills/ralph-specum-index \
platforms/codex/skills/ralph-specum-refactor \
platforms/codex/skills/ralph-specum-feedback \
platforms/codex/skills/ralph-specum-help
Upgrade prompt to send to Codex:
Spec-driven development with task-by-task execution. Research, requirements, design, tasks, autonomous implementation, and epic triage for multi-spec feature decomposition.
Automatic model switching for Claude Code based on prompt complexity. No API calls.
npx claudepluginhub tzachbon/smart-ralph --plugin ralph-speckitSpec-driven development with task-by-task execution. Research, requirements, design, tasks, autonomous implementation, and epic triage for multi-spec feature decomposition.
GitHub Spec-Kit integration for constitution-based spec-driven development (7-phase workflow)
Specification-Driven Development with Process Discipline for Claude Code
Skills-first specification-driven development framework with 7 agent skills for planning, implementation, review, and shipping. Natural language activation with intelligent agent orchestration. Includes /plan, /implement, /research commands plus managing-specifications, implementing-features, and reviewing-and-shipping skills.
Specification-driven development workflow: specify → plan → tasks → implement
Spec Driven Development toolkit - structured specification, planning, and implementation workflows for systematic feature development