Ralph Specum Start
This is the entry point for Ralph Specum's spec workflow. It parses your goal, sets up the spec directory structure, initializes state tracking in `.ralph-state.json`, and writes a `.progress.md` file. By default it stops after setup and waits for you to explicitly continue, which is actually helpful because you can review the generated artifacts before it starts tearing through your codebase. Quick mode (`--quick`) skips that pause and runs straight into implementation. The state tracking is pretty thorough: phase, task index, iteration counts, commit flags, and related specs. It also handles epic context and will route large goals to triage instead of cramming everything into one spec. Honest take: the explicit approval gates feel bureaucratic until you've seen an LLM misinterpret a vague goal.
- GitHub stars
- 340
- last updated
- May 19, 2026
Install
$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-start --agent claude-codeInstalls into .claude/skills of the current project.
Files
Ralph Specum Start
Use this for the start and new entrypoints.
Derive RALPH_CODEX_PLUGIN_ROOT from this loaded skill by resolving two parent directories from the SKILL.md directory. Never derive it from the project working directory.
Contract
- Read
.claude/ralph-specum.local.mdwhen present - Default specs root is
./specs - Keep
.current-specin the default specs root - Keep the standard Ralph files stable
- Merge
.ralph-state.json. Do not replace the full object
Action
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/tzachbon/smart-ralph
- Category
- Automation & Workflows
- License
- MIT
- First seen
- Jun 11, 2026
More from tzachbon/smart-ralph
All 28- Ralph Specum Status
- Ralph Specum Switch
- Ralph Specum Tasks
- Ralph Specum Triage
- Reality Verification
- Skill Development
- Smart Ralph
- Spec Workflow
- Speckit Workflow
- Command Development
- Communication Style
- Delegation Principle
- Hook Development
- Interview Framework
- MCP Integration
- Plugin Settings
- Plugin Structure
- Ralph Specum
- Ralph Specum Cancel
- Ralph Specum Design
- Ralph Specum Feedback
- Ralph Specum Help
- Ralph Specum Implement
- Ralph Specum Index
Recommended
More Automation & Workflows
ralph-specum-statustzachbon/smart-ralphThis is a status reporter for Ralph Specum, a spec-driven development workflow tool.0skills.sh installsralph-specum-taskstzachbon/smart-ralphThis is the orchestration layer for Ralph Specum's task planning phase.0skills.sh installs
video-composeutopai-research/pai-proGenerates and prompts video clips on the filmmaking canvas. Use when the user asks to generate, render, animate, continue, restyle, edit, shoot, or compose a vi0skills.sh installs
openspec-archive-changevila-lab/figmirrorArchive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.0skills.sh installs
quality-standardsVilnaCRM-Org/user-serviceOverview of protected quality thresholds and quick reference for all quality tools. Use when you need to understand quality metrics, run comprehensive quality c0skills.sh installs
n8n-workflow-generatorjeremylongshore/claude-code-plugins-plus-skillsGenerate n8n workflow generator operations. Auto-activating skill for Business Automation. Triggers on: n8n workflow generator, n8n workflow generator Part of t268skills.sh installs