ralplan
Skill4 starsChanged todayMITView on GitHub
[oh-my-agy] Multi-agent consensus planning with independent architectural and critic review (plus --hyperplan 5-persona hostile cross-critique), or lightweight evidence-backed single-lane planning (--light, --interview, --review) when full consensus review is unnecessary. Use for $ralplan, 'plan this', 'let's plan', lightweight feature scoping, reviewing an existing plan, high-stakes architectural plans, or the Autopilot planning stage. Flags: --light, --interview, --review, --interactive, --deliberate, --hyperplan, --advisory.
12 other projects use a version of this.
Adopted by
Most recently taken up by
- Yeachan-Heo/oh-my-claudecodetheir own version, first seen Nov 9, 2026
- lza6/claw-code-tingfengtheir own version, first seen Nov 1, 2026
- Joonghyun-Lee-Frieren/oh-my-antigravitytheir own version, first seen Oct 25, 2026
- Gopyr/gopyr-skills-hubtheir own version, first seen Oct 11, 2026
- Joonghyun-Lee-Frieren/oh-my-gemini-clitheir own version, first seen Oct 8, 2026
- zereight/gitlab-mcptheir own version, first seen Oct 8, 2026
Used with
Projects with it also use visual-verdict, deepinit and 5 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
LucasCooperBeySkillvisual-verdict
Structured visual QA verdict for screenshot-to-reference comparisons. Returns JSON scores driving edit iterations. Use after any UI implementation to verify visual fidelity.
Also in 3 projects that use this
woosikkimSkilldeepinit
Generate hierarchical AGENTS.md codebase maps for agent context
Also in 3 projects that use this
joker-yeSkillgit-master
Git expert for atomic commits, rebasing, and history management with style detection
Also in 3 projects that use this
buddyhSkilldeep-dive
Deep dive on any topic. Decomposes into subtopics, researches each in parallel with thorough source gathering, then synthesizes into a comprehensive report (4,000-10,000+ words, 40-100+ sources). Scales depth dynamically based on topic complexity. Use when asked for a deep dive, deep research, comprehensive analysis, or thorough investigation of a topic.
Also in 4 projects that use this
thoughtbotSkilltrace
Run a scenario and record what actually happened.
Also in 4 projects that use this
markmdevSkillself-improve
Analyze Claude Code sessions to find workflow frictions, underused tools, stale instructions, documentation gaps, and opportunities for new skills or automation. Produces actionable improvement suggestions with prioritized recommendations. Use when the user says "self-improve", "analyze my workflow", "what can we improve", "find frictions", "optimize workflow", or asks about improving their Claude Code setup. Also suggest running this after long sessions, multi-session projects, or when the user seems frustrated with repetitive work.
Also in 3 projects that use this
Other versions12 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 12
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
- Yeachan-Heo/oh-my-claude-sisyphus★ 41ksame name
- Yeachan-Heo/oh-my-codex★ 34ksame name
- zereight/gitlab-mcp★ 2.1ksame name
- Joonghyun-Lee-Frieren/oh-my-antigravity★ 214same name
- Joonghyun-Lee-Frieren/oh-my-gemini-cli★ 214same name
- lza6/claw-code-tingfeng★ 5same name
- an8079/take-skills★ 4same name
- ibahgat/oh-my-iflow★ 2same name
- Jkudjo/oh-my-cursor★ 1same name
2 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- rules/AGENTS.mdAGENTS.md
- ai-slop-cleanerSkill
- analyzeSkill
- askSkill
- autopilotSkill
- cancelSkill
- code-reviewSkill
- deep-interviewSkill
- deep-researchSkill
- doctorSkill
- hudSkill
- loftSkill
- modernizeSkill
- performance-goalSkill
- prSkill
- releaseSkill
- skillSkill
- teamSkill
- threat-modelSkill
- ultragoalSkill
- ultraqaSkill
- visual-ralphSkill
- wikiSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 1 is distinctive, and 6 are very specific to this project.
0
Common
Most of the 9 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 47
If a deep-interview spec exists (.omagy/specs/deep-interview-{slug}.md), treat it as the requirements source of truth and do not …
- Very specific: line 48
If ambiguity is still high, gather brownfield facts first (directly or via the explore subagent), then run $deep-interview --quick.
- Very specific: line 49
If the plan depends on official docs, version-aware guidance, or external dependency behavior, run $deep-research --quick (delegating to …
- Very specific: line 50
Treat an approved prior $deep-research --loop artifact (.omagy/specs/autoresearch-<slug>/) as evidence.
- Very specific: line 73
If .omagy/config.json has no qualityGates.ralplan entries, skip this step completely (strict no-op.
- Very specific: line 77
4-Tier
RECONCILEPrecedence: before revising on any non-APPROVE verdict, classify every Architect, Critic, --hyperplan, or custom … - Distinctive: line 108
When the handoff permits execution, suggest the following, recording the chosen lane in the handoff:
“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ralplan (Consensus & Lightweight Planning)
Ralplan owns both multi-agent consensus planning (the stage Autopilot runs between $deep-interview and $ultragoal driving Planner, Architect, and Critic review with RALPLAN-DR structured deliberation) and lightweight single-lane planning (--light, --interview, --review) for bounded features when full consensus review is unnecessary. Review evidence is local lifecycle evidence, not a security authority. Once the plan and sequential approvals are durable, progression to Ultragoal must stay reachable, and cancel/recovery must never be blocked.
Usage
$ralplan "task description"
$ralplan --light "task description"
$ralplan --interview "task description"
$ralplan --review ".omagy/plans/plan-<slug>.md"
$ralplan --interactive "task description"
$ralplan --deliberate "task description"
$ralplan --migrate "task description"
$ralplan --hyperplan "task description"
$ralplan --advisory "task description"Flags
--light: lightweight, explore-first single-lane planning without the multi-agent Architect + Critic consensus loop. Standalone--lightwrites.omagy/state/plan-state.json({"mode":"plan","active":true,"current_phase":"interview|drafting|review"}) so the planning write guard stays active while drafting, applies Intent Classification (CLEARvsUNCLEARautonomous defaults withAdopted Defaults), the Two-Filter + Owner-Decision Survival Gate (open "why" first; process steps as proposals), and the 4-Item Brief Sharpener (sharpen) (consumer,cheapest done-check,non-goals,outside verification check), saves.omagy/plans/plan-<slug>.md(>= 80%claims citingfile:line,>= 90%testable acceptance criteria,Affected User Ideal State & Gap Table,Review Focus (Top 5 Silent Edge Cases),Interfaces: Consumes / Produces), and terminalizesplan-state.jsonon delivery (or transitions to direct execution if the user says"just do it"/"skip planning").--interview: lightweight Socratic scoping before planning — gather repo facts first (exploreor direct reads), then ask one surviving owner-decision fork per turn viaask_question((Recommended)option first) before generating the plan in.omagy/plans/.--review: evaluate an existing plan in.omagy/plans/(or a specified path) via an independentcriticsubagent (APPROVE/ITERATE/REJECT; never self-approve; report the gap if an independent lane is unavailable).--interactive: pause at key decision points (draft review in step 2, final approval in step 6) usingask_question. Without it, the Planner -> Architect -> Critic loop runs fully automated.--deliberate: force deliberate mode. It adds a pre-mortem (3 scenarios) and an expanded test plan (unit/integration/e2e/observability). Deliberate mode also turns on automatically when the request signals high risk: auth/security, migrations, destructive changes, production incidents, compliance/PII, public API breakage.--migrate: safe legacy, database schema, API, or SDK migration planning — follow references/migration-and-ears.md. Enforces the 4-stage Strangler sequence ((1) Characterization Tests->(2) Strangler Adapter / Expand-Only Seam->(3) Dual-Run / Shadow Parity & Instant Rollback Switch->(4) Cutover & Legacy Decommission), EARS (THE/WHEN/WHILE/IF-THEN/WHERE) acceptance criteria, and deliberate pre-mortem review.--hyperplan: run a 2-round, 5-persona hostile cross-critique tournament before the Planner drafts the PRD:- Round 1 (Independent Analysis): dispatch parallel read-only subagents across 5 adversarial lenses:
skeptic(architectorresearchsubagent): attacks accidental complexity, speculative abstractions, and YAGNI violations.validator(test-engineerorverifiersubagent): attacks edge-case blast radius, data loss vectors, and untestable assumptions.researcher(researchersubagent): attacks uncited API/version claims and stale training-weight assumptions.architect(architectsubagent): attacks coupling, state ownership, and boundary leaks.creative(plannersubagent): proposes lateral inversions that achieve 80%+ of the outcome with a fraction of the moving parts.
- Round 2 (Cross-Attack & Survival Distillation): evaluate each persona's Round 1 claims against the others, tagging every major design proposal as
SURVIVES,WEAKENED (with required mitigation), orKILLED (with reason)in.omagy/plans/hyperplan-distillation-{slug}.md. Feed onlySURVIVESand mitigatedWEAKENEDproposals into Step 1 (Planner).
- Round 1 (Independent Analysis): dispatch parallel read-only subagents across 5 adversarial lenses:
--advisory: standalone only. It runs the same review lifecycle and returns the reviewed plan, but never authorizes execution. Terminal state recordsconsensus_gate.complete:falseandexecution_handoff.authorized:falseexplicitly. A later explicit execution request from the user is needed before any implementation. It cannot be combined with Autopilot, Ultragoal, or Team.
Pre-context intake
Before consensus planning:
- Derive a task slug. Reuse the latest
.omagy/context/{slug}-*.mdif one exists. - Otherwise create
.omagy/context/{slug}-{YYYYMMDDTHHMMSSZ}.mdwith task statement, desired outcome, known facts/evidence, constraints, unknowns, and likely touchpoints. - If a deep-interview spec exists (
.omagy/specs/deep-interview-{slug}.md), treat it as the requirements source of truth and do not re-interview. - If ambiguity is still high, gather brownfield facts first (directly or via the
exploresubagent), then run$deep-interview --quick. - If the plan depends on official docs, version-aware guidance, or external dependency behavior, run
$deep-research --quick(delegating to theresearchersubagent) before finalizing. - Treat an approved prior
$deep-research --loopartifact (.omagy/specs/autoresearch-<slug>/) as evidence. Do not make ongoing research automation a runtime component unless the user asked for it.
State
Standalone consensus mode: write .omagy/state/ralplan-state.json (mode:"ralplan", active:true, current_phase in planner|user-feedback|architect-review|critic-review|revise|handoff|complete, iteration, updated_at). Standalone lightweight mode (--light / --interview / --review): write .omagy/state/plan-state.json (mode:"plan", active:true, current_phase in interview|drafting|review) and terminalize it when the plan or review is delivered. Inside Autopilot, store the consensus fields under state.ralplan in autopilot-state.json instead, and keep Autopilot's current_phase:"ralplan".
Consensus workflow
Planner writes an adaptive plan, right-sized to scope (do not default to exactly five steps), plus a compact RALPLAN-DR summary:
- Principles (3-5)
- Decision Drivers (top 3)
- Viable Options (>= 2) with bounded pros/cons, or an explicit invalidation rationale when only one survives
- Deliberate mode only: pre-mortem (3 scenarios) and an expanded test plan
- Global Constraints: verbatim spec/architectural invariants carried into every task and reviewer dispatch.
- Review Focus (Top 5 Silent Edge Cases): the 5 input classes or failure modes the spec is silent on that would bite a real user, each wired to an owning task's test step.
- Per-Task
Interfaces: Consumes / Produces, EARS Criteria &ProportionCheck: explicit input/output signatures and EARS (THE/WHEN/WHILE/IF-THEN/WHERE; see references/migration-and-ears.md) acceptance criteria per goal/task without fake calendar/effort promises, keeping task bodies proportional (signatures + assertions, never full-file code transcripts longer than the spec). - Blind-Claim
AdversarialVerifyContract: specify in.omagy/plans/test-spec-{slug}.mdthat downstream heavy-rigorAdversarialVerify(verifier) receives onlyARTIFACT(diff /review-packagepath / touched file paths) +CONTRACT(acceptance criteria / invariants) + raw command exit codes, stripping persuasive executor narrative summaries (CLAIMrationales).
The main lane may author the plan for standalone runs. For complex Autopilot planning, invoke the
plannersubagent. Save.omagy/plans/prd-{slug}.mdand.omagy/plans/test-spec-{slug}.md.- User feedback (
--interactiveonly): present the draft plus Principles/Drivers/Options withask_question(Proceed to review/Request changes/Skip review). Otherwise proceed automatically. - Architect review:
invoke_subagentwithTypeName: "architect". Pass a Blind-Claim Review Packet containingARTIFACT(PRD/test-spec paths and context snapshot path),CONTRACT(raw user task statement and verbatim spec invariants), and raw prior gate outputs—stripping persuasive planner self-praise or narrative rationalizations outside the plan files. The architect must give the strongest steelman antithesis, at least one real tradeoff tension, and a synthesis when possible. In deliberate mode it flags principle violations. Wait for the result before step 4. - Critic review: only after the Architect returns,
invoke_subagentwithTypeName: "critic". Pass the same Blind-Claim Review Packet (ARTIFACT+CONTRACT) plus the completed raw Architect review. The Critic enforces principle-option consistency, fair alternatives, clear risk mitigation, testable acceptance criteria, and concrete verification. In deliberate mode it rejects a missing or weak pre-mortem or test plan. Verdict:APPROVE|ITERATE|REJECT. 4b. Configurable Custom Quality Gates (qualityGates.ralplan):- If
.omagy/config.jsonhas noqualityGates.ralplanentries, skip this step completely (strict no-op; emit no gate table). - When configured after Critic approval (entries normalized via
sh <plugin>/hooks/run.sh quality-gates <workspace> ralplanor by reading.omagy/config.json:"<skill>"defaults tomode: "blocking",model: "inherit"), reject any reserved workflow-controller skill (ralplan,deep-interview,code-review,ai-slop-cleaner,autopilot,ultragoal,team) to prevent self-recursion, and invoke each configured gate skill in a fresh independent subagent (Model: gate.model, never reusing thearchitectorcriticconversation ID). - Record all gate results in
.omagy/plans/ralplan-review-{slug}.md.advisorygates never block completion. Anyblockinggate returningiterateorrejectsetsralplan_consensus_gate.complete: false(blocked_reason: "quality_gate_not_approved:<skill>") and feeds into Step 5's re-review loop.
- If
- Re-review loop, 4-Tier
RECONCILE&Doubt/Review TheaterCircuit Breaker (max 5 iterations):- 4-Tier
RECONCILEPrecedence: before revising on any non-APPROVEverdict, classify every Architect, Critic,--hyperplan, or custom quality-gate finding in strict precedence order and record the disposition in.omagy/plans/ralplan-review-{slug}.md:(1) Contract gap— spec/plan ambiguity or contradictory requirement exposed -> escalate to the user or amend the source spec/constraints rather than guessing.(2) Actionable defect— proven architectural flaw, unhandled failure mode, signature mismatch, or untestable criterion ->needs-fix; Planner revises the plan, then re-runsArchitect -> Critic -> Custom Quality Gates.(3) Explicit Ruling— bounded non-defect tradeoff where alternatives carry higher cost/complexity -> recordRuling: <decision> — <why> — <cost_if_wrong>in.omagy/plans/ralplan-review-{slug}.mdand the PRD instead of churning architecture across rounds.(4) Context noise— false positive disproved by repositoryfile:lineor official documentation -> dismiss with concretefile:lineor doc citation.
Doubt/Review TheaterCircuit Breaker: if>= 2consecutive consensus review or downstream verification cycles return prose critiques ("substantive findings") with0actionable defects passing Tier 1–2, halt automated re-spinning immediately—either approve/checkpoint via an explicit Tier 3Ruling:(withcost_if_wrong, passing the citedRECONCILErulings once if needed to satisfy a pending Critic/gate verdict) or escalate directly to the user rather than burning remaining iterations up to 5. After 5 iterations without approval, present the best version and the outstanding objections to the user.
- 4-Tier
- On approval, persist both
.omagy/plans/ralplan-review-{slug}.md(human/HUD review log: Architect review, Critic review, verdicts,RECONCILErulings, iteration) and.omagy/plans/ralplan-review-{slug}.jsonviash <plugin>/hooks/run.sh plan-hash compute .omagy/plans/prd-{slug}.md --spec .omagy/plans/test-spec-{slug}.md [--source-spec .omagy/specs/deep-interview-{slug}.md] --write-receipt APPROVE --json(pass--source-specwhenever a deep-interview spec exists soplan_hashbinds the PRD, test spec, and source interview spec cryptographically alongside the fake-timeline lint; see references/migration-and-ears.md). Surface[oh-my-agy HUD](sidecar://oh-my-agy/hud/)once so the user can inspect theReviewstab in the Auxiliary Pane. Standalone interactive: ask which execution lane to use next. Inside Autopilot: the explicit$autopilotrequest authorizes the supervised transition to$ultragoal. - Record the handoff (in ralplan state or under Autopilot
handoff_artifacts.ralplan):{ "planning_artifacts": [".omagy/plans/prd-<slug>.md", ".omagy/plans/test-spec-<slug>.md"], "ralplan_architect_review": {"verdict": "approve", "path": ".omagy/plans/ralplan-review-<slug>.md"}, "ralplan_critic_review": {"verdict": "APPROVE", "path": ".omagy/plans/ralplan-review-<slug>.md"}, "ralplan_receipt": ".omagy/plans/ralplan-review-<slug>.json", "ralplan_consensus_gate": {"complete": true}, "ralplan_execution_handoff": {"authorized": true, "reason": "<rationale>", "authorized_at": "<ISO>", "review_cycle": 1, "source": "autopilot|user"} }source:"autopilot"is valid only inside an active Autopilot run whose phase isralplan. Standalone runs usesource:"user", and only after the user picks an execution lane. - Transition to
$ultragoal(or the chosen lane) only after the plan, the sequential approvals, and the handoff record exist. Do not implement inside Ralplan.
Important: steps 3 and 4 MUST run sequentially as separate subagents. Never put Architect and Critic in the same parallel batch. Never ask the Architect to also act as Critic. Never role-play either lane in the main lane. If a role agent is unavailable, use the
selfsubagent with the role'sagents/<role>.mdbody as the prompt preamble. If no independent lane can run at all, reportindependent review unavailableand stop atcritic-reviewrather than approving.
Planning/execution boundary
Ralplan is a planning mode. While it is active and no execution handoff exists, implementation writes are out of scope. Ralplan may inspect the repository and write only planning artifacts under .omagy/context/, .omagy/plans/, .omagy/specs/, and .omagy/state/. (The optional oh-my-agy-planning-guard hook can enforce this boundary.)
Existing prd-*.md / test-spec-*.md files alone are never consensus evidence and never permission to skip Ralplan. A conversational "just do it" does not replace the review evidence. Offer $cancel + direct execution if the user wants to abandon planning.
Goal-mode follow-ups
When the handoff permits execution, suggest the following, recording the chosen lane in the handoff:
$ultragoal: the default durable goal-mode follow-up.$team: coordinated parallel implementation, with Ultragoal owning the ledger.$deep-research --loop: when the plan centers on a research question with an evaluator.$performance-goal: when the plan centers on measurable performance.
For team-worthy plans, include explicit staffing: lanes, role per lane (executor, test-engineer, designer, ...), owned files per lane, and verification responsibilities.
Scenario examples
Good: the user says continue after the workflow already has a clear next step. Continue the current branch instead of restarting.
Good: the user changes only the delivery step (e.g. make a PR). Keep the earlier constraints and apply the update locally.
Bad: the user says continue, and the workflow restarts discovery or stops before gathering the missing review evidence.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

