// Ralph autonomous agent for iterative development with multi-PRD parallel support. Commands: '/ralph-ryan:prd' (create PRD), '/ralph-ryan:prep' (prepare), '/ralph-ryan:run' (execute), '/ralph-ryan:status' (overview). Triggers on: ralph prd, ralph prep, ralph run, ralph go, ralph status.
| name | ralph-ryan |
| description | Ralph autonomous agent for iterative development with multi-PRD parallel support. Commands: '/ralph-ryan:prd' (create PRD), '/ralph-ryan:prep' (prepare), '/ralph-ryan:run' (execute), '/ralph-ryan:status' (overview). Triggers on: ralph prd, ralph prep, ralph run, ralph go, ralph status. |
Autonomous coding agent that implements user stories iteratively with multi-PRD parallel development support.
Based on user intent, load the corresponding instruction file:
| Intent | Keywords | Action |
|---|---|---|
| PRD | prd, create, generate, plan | Read {baseDir}/prd.md |
| Prep | prep, prepare, convert, setup | Read {baseDir}/prep.md |
| Run | run, execute, go, start | Read {baseDir}/run.md |
| Status | status, list, overview | Read {baseDir}/status.md |
.claude/ralph-ryan/
├── prd-06-risk-management/ # PRD 子目录
│ ├── prd.md # PRD 文档
│ ├── prd.json # 结构化数据
│ └── progress.txt # 进度日志
├── prd-07-model-governance/
│ ├── prd.md
│ ├── prd.json
│ └── progress.txt
└── ...
.claude/ralph-ryan-archived/ # 已完成的 PRD
└── 2026-01-29-prd-06-risk-management/
命名规范: prd-<slug> 或 <descriptive-name>，使用 kebab-case
| Item | Path |
|---|---|
| Working directory | .claude/ralph-ryan/ |
| PRD 子目录 | .claude/ralph-ryan/<prd-slug>/ |
| PRD markdown | .claude/ralph-ryan/<prd-slug>/prd.md |
| PRD JSON | .claude/ralph-ryan/<prd-slug>/prd.json |
| Progress log | .claude/ralph-ryan/<prd-slug>/progress.txt |
| Loop state | .claude/ralph-ryan/<prd-slug>/ralph-loop.local.md |
| Archived runs | .claude/ralph-ryan-archived/<date>-<prd-slug>/ |
| Field | Description |
|---|---|
branchName | Target branch for execution |
baseBranch | Base branch for creation (only if creating new branch) |
Branch strategy (set during prep):
branchName = current branch, no baseBranchbranchName = ralph/<prd-slug>, baseBranch = current branchbranchName = ralph/<prd-slug>, baseBranch = main# 查看所有 PRD 状态
/ralph-ryan:status
# 创建新 PRD (会询问 slug 名称)
/ralph-ryan:prd [describe your feature]
# 准备执行 (会列出可选 PRD)
/ralph-ryan:prep
# 执行 (会列出可选 PRD，自动循环直到完成)
/ralph-ryan:run [prd-slug] [--max-iterations N]
停止循环：直接 Ctrl+C 终止即可。
每个循环状态文件 (ralph-loop.local.md) 包含 session_hash 字段。Stop Hook 在第一次迭代时自动填入当前会话 transcript 路径的 SHA256 哈希值（16字符），确保：
每个 story 完成后，在 prd.json 中记录修改的文件：
{
"id": "US-003",
"passes": true,
"filesChanged": [
"app/risk/greeks/page.tsx",
"components/charts/greeks-heatmap.tsx"
]
}
用于：
