ralph-planning

Guide AI agents through discovery, specification, and implementation planning phases.

2|2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/srulyt/srulys-agent-packs --skill ralph-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-planning
Source: https://github.com/srulyt/srulys-agent-packs/tree/main/agent-packs/ralph-copilot-cli/.github/skills/planning
Command: npx skills add https://github.com/srulyt/srulys-agent-packs --skill ralph-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for agents to navigate the complex phases of software development, ensuring thoroughness and clarity from initial code exploration to detailed implementation planning.

Core Features & Use Cases

  • Phase-Based Guidance: Offers step-by-step instructions for discovery, specification, and planning.
  • Artifact Generation: Mandates the creation of crucial documents like discovery notes, specifications, and implementation plans.
  • State Management: Ensures proper updates to the agent's state throughout the planning lifecycle.
  • Use Case: An agent uses this skill to systematically explore a new codebase, document its architecture, write a detailed feature specification, and then create a phased implementation plan before any code is written.

Quick Start

Use the ralph-planning skill to guide the agent through the discovery phase for a new feature.

Frequently Asked Questions about ralph-planning

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

FAQPage Schema
How do I guide an AI agent through software development planning phases?

Guide an AI agent through software development planning by using structured phase-based instructions for context discovery, specification writing, and implementation planning. This enforces methodical artifact generation and state updates before any code is written.

What is the best way to document codebase analysis before writing a feature specification?

Document codebase analysis by enforcing the creation of discovery notes during the initial exploration phase. This ensures an agent systematically records architecture observations and context before progressing to specification writing.

How do I create an implementation plan for agentic workflows?

Create an implementation plan for agentic workflows by following structured phase-based guidance that transitions from feature specification to detailed implementation planning. This mandates proper state updates and artifact generation throughout the lifecycle.

Do I need to write a specification before an AI agent starts implementation planning?

You need to write a specification before implementation planning because the structured lifecycle mandates sequential progression through discovery, specification, and planning. This ensures thoroughness and clarity before any code is written.

Can I use this structured development approach for new codebase exploration?

You can use this structured development approach for new codebase exploration because it provides step-by-step instructions for the discovery phase. An agent systematically explores the codebase and documents its architecture as mandated artifacts.

What limitations exist when using phase-based guidance for software development?

A limitation of this phase-based guidance is that it strictly covers phases 1 through 3 of the development lifecycle, stopping before actual implementation. It focuses entirely on discovery, specification, and planning artifacts rather than code execution.