ralphex-plan

Creates structured implementation plans in docs/plans/ through interactive context gathering.

1.5k|123|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/umputun/ralphex --skill ralphex-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralphex-plan
Source: https://github.com/umputun/ralphex/tree/main/assets/claude/skills/ralphex-plan
Command: npx skills add https://github.com/umputun/ralphex --skill ralphex-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing implementation plans for autonomous execution requires gathering codebase context, defining scope, and structuring tasks with tests, which is time-consuming and error-prone when done manually.

Core Features & Use Cases

  • Interactive context gathering: Launches an Explore agent to inspect the repository, then asks focused questions one at a time about goals, scope, constraints, and testing approach.
  • Structured plan generation: Produces a dated Markdown plan file in docs/plans/ with task checkboxes, mandatory test requirements, progress tracking rules, and post-completion notes.
  • Approach exploration: Proposes 2-3 implementation approaches with trade-offs and a recommendation before writing the plan.
  • Use Case: A developer wants ralphex to autonomously implement a new API endpoint; this Skill interviews them, explores the codebase, and writes a task-by-task plan file that ralphex can execute.

Quick Start

Ask the assistant to create a ralphex implementation plan for the feature or bug fix you want to build.

Frequently Asked Questions about ralphex-plan

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

FAQPage Schema
How do I create an implementation plan for ralphex?

Invoke the plan creation flow and answer the guided questions about goal, scope, constraints, and testing approach. The Skill explores your codebase, proposes approaches, and writes a dated Markdown plan file into docs/plans/.

What format does a ralphex plan file use?

Plans are Markdown files named YYYYMMDD-<task-name>.md stored in docs/plans/. They contain an overview, context, development approach, checkbox-based task sections with mandatory tests, and a post-completion section for manual items.

Does the ralphex plan skill require the ralphex CLI installed?

Plan creation works without the CLI, but executing the plan requires ralphex installed via Homebrew, a .deb/.rpm package, or go install. The Skill checks for the binary and reminds you to install it before execution.

Why must every task in the plan include tests?

The plan structure enforces tests as separate checklist items for every task because ralphex executes tasks autonomously. Passing tests before moving to the next task prevents broken code from compounding across the plan.

Can I skip the approach exploration step when planning?

Yes, the approach proposal step is skipped when the implementation path is obvious, the user already specified how to build it, or the request is a bug fix with a clear solution.