ralplan

Run an iterative Planner/Architect/Critic loop to produce consensus-ready plans.

Updated May 5, 2026
One-click install
npx skills add https://github.com/HyperionBurn/searchv1beta --skill ralplan-hyperionburn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralplan
Source: https://github.com/HyperionBurn/searchv1beta/tree/main/.github/skills/ralplan
Command: npx skills add https://github.com/HyperionBurn/searchv1beta --skill ralplan-hyperionburn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ralplan helps you turn vague or risky planning requests into an explicit, testable, decision-ready consensus plan by iteratively aligning a Planner, Architect, and Critic.

Core Features & Use Cases

  • Iterative consensus loop: Runs Planner → Architect → Critic repeatedly until approval, with a max iteration cap to avoid endless churn.
  • Architecture and quality guardrails: Surfaces trade-offs and rejection reasons, then steers the plan toward testability and implementation readiness.
  • Risk-focused deliberate mode: With --deliberate, adds a pre-mortem with prioritized risk scenarios plus expanded test planning for higher-stakes work.
  • Interactive approval gates: Uses vscode_askQuestions at each major decision point (or falls back to numbered/freeform prompts when unavailable).

Use case examples: refining a software change proposal with explicit ADR (Decision Drivers, Alternatives, Consequences), scoping an execution request so it becomes concrete and acceptance-criteria-driven, and producing a team-executable plan after consensus is reached.

Quick Start

Ask for a consensus plan by invoking ralplan with the task description and optionally include --deliberate for high-risk work.

Frequently Asked Questions about ralplan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a testable software execution plan with architecture trade-offs resolved?

A testable software execution plan is produced by running an iterative Planner, Architect, and Critic loop until consensus is reached. This process surfaces architecture trade-offs and rejection feedback, steering the proposal toward implementation readiness and generating an ADR-backed plan.

How does multi-agent consensus planning work for scoping risky software changes?

Multi-agent consensus planning works by iteratively aligning a Planner, Architect, and Critic to review a scoped execution request. The loop repeats with a max iteration cap until all agents agree, resolving rejection reasons into a final team-executable plan with explicit acceptance criteria.

When do I need a pre-mortem risk analysis for my project plan?

A pre-mortem risk analysis is needed for higher-stakes or risky planning requests. By invoking a deliberate mode, the planning workflow adds prioritized risk scenarios and an expanded test strategy to the consensus plan to ensure potential failures are addressed before execution.

Does vscode_askQuestions support interactive approval gates during planning workflows?

Yes, vscode_askQuestions supports interactive approval gates at each major decision point during the planning workflow. If the component is unavailable, the system falls back to numbered or freeform prompts to ensure explicit user confirmation is still captured.

What is the best way to document decision drivers and alternatives for a software architecture proposal?

The best way to document decision drivers, alternatives, and consequences is by generating an Architecture Decision Record (ADR). The consensus planning loop produces an ADR-backed plan that explicitly captures these trade-offs and rejection feedback for team alignment.

What are the limitations of using an iterative consensus loop for execution planning?

The iterative consensus loop has a max iteration cap to prevent endless churn between the Planner, Architect, and Critic. It requires explicit user confirmation at decision gates and a final execution-or-save approval step, which may slow down rapid prototyping but ensures plan quality.