/dev-ralplan

name: dev-ralplan
description: Multi-perspective consensus planning with Planner/Architect/Critic loop. Use when high-stakes decisions need RALPLAN-DR structured deliberation (auth, migrations, public APIs, irreversible changes). Pairs with @compass-planner + @apex-architect + @raven-critic.

Dev Ralplan

Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.

Consensus mode planning: a Planner/Architect/Critic loop that produces a plan with explicit principles, decision drivers, viable options, and an ADR. Used for high-stakes or irreversible work.

Use When

• Multi-perspective consensus needed on a plan or design
• High-stakes work: auth, security, data migrations, destructive/irreversible changes, production incidents, compliance/PII, public API breakage
• User says "ralplan", "consensus", "let's deliberate"
• When `dev-plan --consensus` would normally apply

Do Not Use When

• Simple, low-risk task → use `dev-plan` standard mode
• User wants direct execution → use `dev-autopilot`
• Single-perspective is sufficient → use `dev-plan` direct mode

Workflow

Stage 1 — Initial plan (`@compass-planner`)

• Run interview if needed
• Emit RALPLAN-DR summary: Principles (3-5), Decision Drivers (top 3), Viable options (≥2)
• If only 1 viable option remains, document explicit invalidation rationale for alternatives

Stage 2 — Architecture review (`@apex-architect`)

• Read the plan
• Provide consensus addendum: strongest steelman antithesis, real tradeoff tension, synthesis if viable
• In deliberate mode, flag explicit principle violations

Stage 3 — Critique (`@raven-critic`)

• Multi-perspective adversarial review
• Pre-commitment predictions
• Gap analysis
• Self-audit + realist check
• Verdict: REJECT / REVISE / ACCEPT-WITH-RESERVATIONS / ACCEPT

Stage 4 — Revised plan (`@compass-planner`)

• Incorporate apex + raven feedback
• Final plan must include ADR: Decision, Drivers, Alternatives considered, Why chosen, Consequences, Follow-ups
• In deliberate mode: pre-mortem (3 scenarios) + expanded test plan (unit/integration/e2e/observability)

Mode Selection

• **Short mode (default):** principles + drivers + ADR
• **Deliberate mode (`--deliberate`):** + pre-mortem + expanded test plan + principle violation flags

Trigger deliberate mode when: auth/security touched, data migration, destructive/irreversible change, production incident response, compliance/PII implications, public API breakage.

Output

Final plan saved to `workspace/development/plans/[C]ralplan-{name}-{date}.md` with ADR section.

Pairs With

• `@compass-planner` (drives the loop)
• `@apex-architect` (architecture review)
• `@raven-critic` (adversarial review)
• `dev-plan` (which can chain into ralplan with `--consensus`)
• `dev-autopilot` (skips its own Phase 0+1 if a ralplan plan already exists)