ralph-specum-start

Solid

This skill should be used only when the user explicitly asks to use `$ralph-specum-start`, or explicitly asks Ralph Specum in Codex to start or resume a spec.

AI & Automation 339 stars 21 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
84
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Ralph Specum Start Use this for the `start` and `new` entrypoints. ## Contract - Read `.claude/ralph-specum.local.md` when present - Default specs root is `./specs` - Keep `.current-spec` in the default specs root - Keep the standard Ralph files stable - Merge `.ralph-state.json`. Do not replace the full object ## Action 1. Parse explicit name, goal, `--quick`, commit flags, optional specs root, and optional `--tasks-size fine|coarse`. 2. Resolve the target by explicit path, exact name, or `.current-spec`. 3. If the same name exists in multiple configured roots, stop and require a full path. 4. Check active epic context from `specs/.current-epic` when no explicit spec was chosen. 5. For large or cross-cutting goals, route to triage instead of forcing a single spec. 6. `new` is an alias here. Create the spec directory if needed. 7. Initialize or merge state with: - `source: "spec"` - `name` - `basePath` - `phase: "research"` - `taskIndex: 0` - `totalTasks: 0` - `taskIteration: 1` - `maxTaskIterations: settings default or 5` - `globalIteration: 1` - `maxGlobalIterations: 100` - `commitSpec: settings auto_commit_spec or true` - `relatedSpecs: []` - `awaitingApproval: true` when the run will stop after setup and wait for explicit direction - `awaitingApproval: false` when quick mode or explicit autonomy will continue without pausing - preserve or set `quickMode` - preserve or set `granularity` when `--tasks-size` was supplied...

Details

Author
tzachbon
Repository
tzachbon/smart-ralph
Created
4 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category