[PR #63] [MERGED] feat: add ralph plan and ralph task commands for SOP-driven sessions #115

New issue

Closed

opened 2026-02-27 10:22:17 +03:00 by kerem · 0 comments

kerem commented

2026-02-27 10:22:17 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/mikeyobrien/ralph-orchestrator/pull/63
Author: @mikeyobrien
Created: 1/16/2026
Status: ✅ Merged
Merged: 1/16/2026
Merged by: @mikeyobrien

Base: main ← Head: feat/sop-commands

📝 Commits (8)

0d3019b feat: add ralph plan and ralph task commands for SOP-driven sessions
205e4ef fix: include SOPs in published crate for cargo install
90f1f74 style: apply cargo fmt to fix CI formatting check
38f3ba6 chore: add pre-commit hooks for fmt and clippy checks
9b91265 fix: resolve clippy collapsible_if warnings for Rust 1.92
c7a17d8 docs: add animated demos for ralph plan and ralph task commands
553fb96 Revert "docs: add animated demos for ralph plan and ralph task commands"
cb8c53d fix: resolve all clippy warnings for Rust 1.92

📊 Changes

59 files changed (+4305 additions, -872 deletions)

View changed files

📝 .claude/skills/code-task-generator/SKILL.md (+14 -0)
📝 .claude/skills/pdd/SKILL.md (+15 -0)
➕ .github/workflows/ci.yml (+78 -0)
➕ .hooks/pre-commit (+27 -0)
📝 AGENTS.md (+43 -0)
📝 crates/ralph-adapters/src/auto_detect.rs (+58 -20)
📝 crates/ralph-adapters/src/claude_stream.rs (+18 -7)
📝 crates/ralph-adapters/src/cli_backend.rs (+212 -25)
📝 crates/ralph-adapters/src/cli_executor.rs (+24 -14)
📝 crates/ralph-adapters/src/lib.rs (+9 -4)
📝 crates/ralph-adapters/src/pty_executor.rs (+155 -50)
📝 crates/ralph-adapters/src/stream_handler.rs (+2 -6)
📝 crates/ralph-bench/src/main.rs (+46 -56)
➕ crates/ralph-cli/sops/code-task-generator.md (+341 -0)
➕ crates/ralph-cli/sops/pdd.md (+309 -0)
📝 crates/ralph-cli/src/init.rs (+7 -8)
📝 crates/ralph-cli/src/main.rs (+355 -98)
➕ crates/ralph-cli/src/sop_runner.rs (+266 -0)
📝 crates/ralph-cli/tests/integration_clean.rs (+19 -5)
📝 crates/ralph-cli/tests/integration_resume.rs (+32 -32)

...and 39 more files

📄 Description

Summary

Add ralph plan [IDEA] command that starts an interactive Prompt-Driven Development session
Add ralph task [INPUT] command that starts an interactive code-task-generator session
Add interactive backend configurations with backend-specific quirks (e.g., Gemini uses -i not -p)
Update PDD and code-task-generator skills to offer PROMPT.md generation for Ralph integration

These commands are thin wrappers that bypass Ralph's orchestration loop, spawning the AI backend directly with bundled SOP content for quick planning and task generation workflows.

Demos

`ralph plan` - Start a PDD Planning Session

Shows: Command invocation → backend detection → PDD session starting with guided planning workflow

`ralph task` - Generate Code Task Files

Shows: Command invocation → backend detection → code task generator creating structured .code-task.md files

Test plan

Verify ralph plan starts an interactive PDD session
Verify ralph task starts an interactive code-task-generator session
Verify --backend flag overrides auto-detection
Run cargo test to confirm all unit tests pass

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/mikeyobrien/ralph-orchestrator/pull/63 **Author:** [@mikeyobrien](https://github.com/mikeyobrien) **Created:** 1/16/2026 **Status:** ✅ Merged **Merged:** 1/16/2026 **Merged by:** [@mikeyobrien](https://github.com/mikeyobrien) **Base:** `main` ← **Head:** `feat/sop-commands` --- ### 📝 Commits (8) - [`0d3019b`](https://github.com/mikeyobrien/ralph-orchestrator/commit/0d3019ba55a7ce183521aab6f314c16e5bd283c5) feat: add ralph plan and ralph task commands for SOP-driven sessions - [`205e4ef`](https://github.com/mikeyobrien/ralph-orchestrator/commit/205e4ef17f9fb5c3a1e1428017baf424216f2289) fix: include SOPs in published crate for cargo install - [`90f1f74`](https://github.com/mikeyobrien/ralph-orchestrator/commit/90f1f7403ecd770974d82c5a501f935343ef0310) style: apply cargo fmt to fix CI formatting check - [`38f3ba6`](https://github.com/mikeyobrien/ralph-orchestrator/commit/38f3ba6e913800c250ef0b5fbe433571549e8792) chore: add pre-commit hooks for fmt and clippy checks - [`9b91265`](https://github.com/mikeyobrien/ralph-orchestrator/commit/9b91265422aa3b1e68587061e8f4300db7cd37e3) fix: resolve clippy collapsible_if warnings for Rust 1.92 - [`c7a17d8`](https://github.com/mikeyobrien/ralph-orchestrator/commit/c7a17d823e438511eea743c64f3ec9b0fecb610e) docs: add animated demos for ralph plan and ralph task commands - [`553fb96`](https://github.com/mikeyobrien/ralph-orchestrator/commit/553fb96df0e0efe2954465a5b74268a64af0fea1) Revert "docs: add animated demos for ralph plan and ralph task commands" - [`cb8c53d`](https://github.com/mikeyobrien/ralph-orchestrator/commit/cb8c53dd498f0fae733d708de2c7c48efbd1ee2a) fix: resolve all clippy warnings for Rust 1.92 ### 📊 Changes **59 files changed** (+4305 additions, -872 deletions) <details> <summary>View changed files</summary> 📝 `.claude/skills/code-task-generator/SKILL.md` (+14 -0) 📝 `.claude/skills/pdd/SKILL.md` (+15 -0) ➕ `.github/workflows/ci.yml` (+78 -0) ➕ `.hooks/pre-commit` (+27 -0) 📝 `AGENTS.md` (+43 -0) 📝 `crates/ralph-adapters/src/auto_detect.rs` (+58 -20) 📝 `crates/ralph-adapters/src/claude_stream.rs` (+18 -7) 📝 `crates/ralph-adapters/src/cli_backend.rs` (+212 -25) 📝 `crates/ralph-adapters/src/cli_executor.rs` (+24 -14) 📝 `crates/ralph-adapters/src/lib.rs` (+9 -4) 📝 `crates/ralph-adapters/src/pty_executor.rs` (+155 -50) 📝 `crates/ralph-adapters/src/stream_handler.rs` (+2 -6) 📝 `crates/ralph-bench/src/main.rs` (+46 -56) ➕ `crates/ralph-cli/sops/code-task-generator.md` (+341 -0) ➕ `crates/ralph-cli/sops/pdd.md` (+309 -0) 📝 `crates/ralph-cli/src/init.rs` (+7 -8) 📝 `crates/ralph-cli/src/main.rs` (+355 -98) ➕ `crates/ralph-cli/src/sop_runner.rs` (+266 -0) 📝 `crates/ralph-cli/tests/integration_clean.rs` (+19 -5) 📝 `crates/ralph-cli/tests/integration_resume.rs` (+32 -32) _...and 39 more files_ </details> ### 📄 Description ## Summary - Add `ralph plan [IDEA]` command that starts an interactive Prompt-Driven Development session - Add `ralph task [INPUT]` command that starts an interactive code-task-generator session - Add interactive backend configurations with backend-specific quirks (e.g., Gemini uses `-i` not `-p`) - Update PDD and code-task-generator skills to offer PROMPT.md generation for Ralph integration These commands are thin wrappers that bypass Ralph's orchestration loop, spawning the AI backend directly with bundled SOP content for quick planning and task generation workflows. ## Demos ### `ralph plan` - Start a PDD Planning Session ![ralph plan demo](https://raw.githubusercontent.com/mikeyobrien/ralph-orchestrator/feat/sop-commands/docs/demos/ralph-plan.gif) *Shows: Command invocation → backend detection → PDD session starting with guided planning workflow* ### `ralph task` - Generate Code Task Files ![ralph task demo](https://raw.githubusercontent.com/mikeyobrien/ralph-orchestrator/feat/sop-commands/docs/demos/ralph-task.gif) *Shows: Command invocation → backend detection → code task generator creating structured .code-task.md files* ## Test plan - [x] Verify `ralph plan` starts an interactive PDD session - [x] Verify `ralph task` starts an interactive code-task-generator session - [x] Verify `--backend` flag overrides auto-detection - [x] Run `cargo test` to confirm all unit tests pass --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>