tzachbon/smart-ralph / plugins/ralph-specum-codex/skills/ralph-specum-switch
ralph-specum-switch
VerifiedThis skill should be used only when the user explicitly asks to use `$ralph-specum-switch`, or explicitly asks Ralph Specum in Codex to switch the active spec.
Ralph Specum Switch
Use this to switch the active spec.
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 - Parse
specs_dirsfrom frontmatter to discover all spec roots - Treat the first
specs_dirsentry as the default root - Default specs root is
./specs .current-speclives in the default specs root- Do not guess on ambiguous names
Action
- Resolve the requested target by full path or exact name.
- If no target was provided, list available specs grouped by root.
- If the name is ambiguous across roots, stop and require a full path.
- Update
.current-spec:- bare name for the default root
- full path for non-default roots
- Read the target spec state and summarize phase, progress, approval state, and present files.
- Report prototype dependencies without mutating them:
- Treat a missing
activePrototypesfield as an empty map. - When state exists, run
"$RALPH_CODEX_PLUGIN_ROOT/scripts/prototype_records.py" select-downstream --base-path "$BASE_PATH" --state "$BASE_PATH/.ralph-state.json"using the selected spec's resolvedbasePath. - Show each blocker from
activeBlockerswith prototype ID, status, blocked artifact or transition,returnPhase, andreturnTaskIndex. - Show
staleArtifactsandstaleTaskIndexesfrom the selection result. - Do not reconcile, remove active entries, edit records, or change blocker data. If no overlay or stale dependency exists, preserve the existing switch output.
- Treat a missing
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |