preyan/0xchess/ralplan

Ralplan (Consensus Planning)

Shorthand for /plan --consensus. Triggers iterative planning with Planner, Architect, and Critic agents until consensus is reached.

Flags

• --deliberate: Forces deliberate mode for high-risk work. Adds pre-mortem (3 scenarios) and expanded test planning.

Interactive Hook Protocol

MANDATORY: Use vscode_askQuestions at every decision gate in this skill (when available). If vscode_askQuestions is NOT available (e.g., Copilot CLI), present numbered options in markdown and ask the user to respond with a number or freeform text.

When to Fire Hooks

Workflow

1. @planner creates initial plan with RALPLAN-DR summary:

• Principles (3-5)
• Decision Drivers (top 3)
• Viable Options (>=2) with pros/cons

1. HOOK: Present options via vscode_askQuestions when options have significant trade-offs:

`` header: "ralplan-options" question: "Planner identified [N] viable approaches. Select preferred direction:" options: [ { label: "Option A: [name]", description: "Pros: X, Y. Cons: Z" }, { label: "Option B: [name]", description: "Pros: A, B. Cons: C" }, { label: "Let agents decide based on technical merit", recommended: true } ] allowFreeformInput: true ``

1. @architect reviews for architectural soundness

• If architect raises concerns: HOOK — present trade-offs for user decision

1. @critic validates quality and testability

• If critic rejects: HOOK — show issues and ask for direction:

`` header: "ralplan-critic-feedback" question: "Critic identified [N] issues: [summary]. How to proceed?" options: [ { label: "Address all issues", recommended: true }, { label: "Address critical issues only, skip minor" }, { label: "Override — I accept the trade-offs" }, { label: "Restart with different constraints" } ] ``

1. Loop until critic approves (max 5 iterations)
2. Final plan includes ADR (Decision, Drivers, Alternatives, Why chosen, Consequences)
3. HOOK: Final approval via vscode_askQuestions:

`` header: "ralplan-approval" question: "Consensus reached after [N] iterations. Execute?" options: [ { label: "Execute with team (parallel)", recommended: true }, { label: "Execute with ralph (sequential + verification)" }, { label: "Execute with omg-autopilot (full pipeline)" }, { label: "Save plan — don't execute yet" } ] ``

Deliberate Mode Hooks

When --deliberate is active, add:

• HOOK: Pre-mortem scenarios — present 3 risk scenarios, ask user to rank priority
• HOOK: Test strategy — present expanded test plan for user approval

Pre-Execution Gate

Vague execution requests (e.g., "ralph improve the app") are redirected through ralplan first to ensure explicit scope, testable criteria, and multi-agent consensus.

Passes gate (specific enough): prompts with file paths, function names, issue numbers, numbered steps, or acceptance criteria.

Gated (needs scoping): prompts with only vague descriptions and no concrete anchors.

After Approval

• Execute via /team (parallel agents, recommended) or /ralph (sequential with verification)