majiayu000 v2.88 Key Changes (MODEL-AGNOSTIC)
- Model-agnostic: Uses model configured in
~/.claude/settings.jsonor CLI/env vars - No flags required: Works with the configured default model
- Flexible: Works with GLM-5, Claude, Minimax, or any configured model
- Settings-driven: Model selection via
ANTHROPIC_DEFAULT_*_MODELenv vars
PRD System
Generate and manage Product Requirements Documents (PRDs) with INVEST-compliant user stories for structured task breakdown.
When to Use
- Planning new features or major enhancements
- Breaking down complex projects into user stories
- Creating structured task lists for Ralph Loop execution
- Documenting requirements for team collaboration
- Converting PRDs into actionable implementation tasks
PRD Structure
| Section | Purpose |
|---|---|
| Overview | Brief description and business value |
| Goals | Measurable objectives |
| User Stories | INVEST-compliant stories with acceptance criteria |
| Technical Requirements | Architecture, stack, dependencies, security |
| Success Criteria | Metrics and targets |
| Out of Scope | What's explicitly NOT included |
| Implementation Plan | Phased tasks breakdown |
| Risks & Mitigations | Potential issues and solutions |
Commands
Create PRD
ralph prd create "Implement OAuth2 authentication"
ralph prd create "Add real-time notifications" --priority high
Creates file in tasks/prd-<feature>.md
Convert to Stories
ralph prd convert tasks/prd-auth.md
Creates actionable user stories in tasks/prd-auth.json
Show Status
ralph prd status
Shows progress across all PRDs
Get Next Story
ralph prd next
Returns next uncompleted story
User Story Format (INVEST)
As a {{persona}},
I want to {{action}},
So that {{benefit}}.
Acceptance Criteria:
- [ ] {{criterion_1}}
- [ ] {{criterion_2}}
- [ ] {{criterion_3}}
INVEST Principles:
- Independent: Can be completed standalone
- Negotiable: Details can be adjusted
- Valuable: Provides user/business value
- Estimable: Complexity can be estimated
- Small: Fits within iteration limits
- Testable: Clear acceptance criteria
Integration with Ralph Loop
0. PRD CREATION → ralph prd create "feature"
1. /clarify → Intensive questions (populate PRD)
2. /classify → Complexity routing
3. PLAN → User approval (review PRD)
4. PRD CONVERSION → ralph prd convert tasks/prd-feature.md
5. EXECUTION → ralph loop --prd tasks/prd-feature.json
6. /gates → Quality validation per story
7. /retrospective → Propose PRD improvements
→ VERIFIED_DONE
Best Practices
- Start with Overview - Clear problem statement before solutions
- Measurable Goals - Use specific metrics (e.g., "reduce load time by 30%")
- INVEST Stories - Ensure each story is independent and testable
- Scope Management - Explicitly document "Out of Scope" items
- Risk Assessment - Identify risks early with mitigations
- Stakeholder Review - Get approval before converting to stories
- Iterative Execution - Execute one story at a time with validation
Related Skills
/clarify- Intensive questions (populate PRD details)/loop- Execute PRD stories iteratively/orchestrator- Full workflow with PRD integration/plan- Plan-state management for execution tracking