rb-planning

Convert planning inputs into epics and worker-ready task cards with EARS acceptance criteria.

33|5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/kylesnowschwartz/ralph-ban --skill rb-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rb-planning
Source: https://github.com/kylesnowschwartz/ralph-ban/tree/main/skills/rb-planning
Command: npx skills add https://github.com/kylesnowschwartz/ralph-ban --skill rb-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It converts a high-level plan, design doc, or requirements into actionable kanban cards that orchestrators and workers can execute reliably.

Core Features & Use Cases

  • Epic + task decomposition: Breaks work into epics for organization and tasks for dispatchable, commit-sized work.
  • EARS-ready acceptance specs: Writes testable acceptance criteria so the board can gate promotion from backlog to todo.
  • Worker-ready card context: Produces task descriptions with concrete file scope, verification steps, and an ## Oracle block for the correct test surface.
  • Dependency-aware planning: Marks tasks as blocked-by other tasks when outputs must exist first, including optional spike/implementation splitting.
  • Design-first safety rail: Routes architecture-sensitive decisions through a Plan path before implementation cards are created.

Quick Start

Ask it to plan by providing your requirements text, design doc path, or plan description so it creates the epics and tasks directly on the ralph-ban board.

Frequently Asked Questions about rb-planning

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

FAQPage Schema
How do I convert requirements and design docs into actionable kanban cards?

To convert requirements into kanban cards, provide your design doc or plan text to the planner, which decomposes the input into epics and worker-ready task cards with EARS acceptance criteria and oracle exercise instructions.

How do I break down a high-level plan into commit-sized work items for task orchestration?

Breaking down plans into commit-sized work items involves structuring epics for organization and dispatchable tasks for workers, marking dependencies when outputs must exist first, and routing architecture-sensitive decisions through a dedicated Plan path.

What is the best way to write testable acceptance criteria for kanban task cards?

Writing testable acceptance criteria is best handled using EARS specs, which allow the board to gate promotion from backlog to todo by ensuring each task card has concrete file scope, verification steps, and a dedicated oracle block for the correct test surface.

Do I need the bl CLI to create task cards with dependency mapping?

Yes, creating task cards with dependency mapping requires the bl CLI, as it is used to generate cards directly on the ralph-ban board with correct specs, priorities, epic grouping, and self-contained worker instructions referencing relevant code patterns.

Can I split architecture-sensitive tasks into separate spike and implementation cards?

Yes, you can split architecture-sensitive tasks into separate spike and implementation cards, applying dependency-aware planning to mark tasks as blocked-by other tasks when specific outputs must exist before implementation work begins.

Why should I not use manual task decomposition for complex orchestration workflows?

Manual task decomposition lacks design-first safety rails and EARS-ready acceptance specs, risking misaligned worker context and missing dependency mapping that automated board card generation provides for reliable orchestration execution.