ralph-plan

Guide interactive task planning and generate Ralph-compatible JSON state files.

2|Updated Dec 28, 2024
One-click install
npx skills add https://github.com/shonenm/dotfiles --skill ralph-plan-shonenm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-plan
Source: https://github.com/shonenm/dotfiles/tree/main/common/claude/.claude/skills/ralph-plan
Command: npx skills add https://github.com/shonenm/dotfiles --skill ralph-plan-shonenm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of defining requirements, designing solutions, and breaking down tasks for implementation, generating a structured state file for the Ralph system.

Core Features & Use Cases

  • Interactive Planning: Guides users through defining functional/non-functional requirements, acceptance criteria, and design specifications.
  • Task Decomposition: Breaks down complex tasks into an atomic, dependency-aware task graph.
  • State File Generation: Produces a JSON state file compatible with the /ralph implementation loop.
  • Use Case: When starting a new feature like "implement user authentication," this skill will help you define all necessary requirements, design the architecture, and list out each small step needed for implementation before any code is written.

Quick Start

Use the ralph-plan skill to define requirements and plan the implementation for adding a user authentication feature.

Frequently Asked Questions about ralph-plan

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

FAQPage Schema
How do I break down software requirements into an actionable task graph?

Task decomposition breaks down complex software requirements into an atomic, dependency-aware task graph. This skill guides you through defining functional and non-functional requirements, then automatically structures them into sequential implementation steps.

What is the best way to plan feature implementation before writing code?

Pre-implementation planning is best handled by interactively defining requirements, acceptance criteria, and design specifications. This approach ensures architecture and task steps are fully mapped out and approved before any code is written.

How do I generate a state file for the Ralph implementation loop?

To generate a Ralph-compatible state file, you interactively define requirements, design specifications, and acceptance criteria. The skill processes these approved inputs and outputs a structured JSON file for the implementation loop.

Can I define acceptance criteria and design specifications interactively for a new feature?

Yes, you can interactively define acceptance criteria and design specifications for new features. The planning process requires user approval at each phase, ensuring the generated state file accurately reflects your architectural decisions.

Does this task decomposition tool require manual approval for each planning phase?

Yes, the interactive planning process requires manual user approval at each phase before proceeding. You must review and approve the requirement definitions, design specifications, and task breakdown before the final state file is generated.