// Convert an ML PRD into prd.json for ML-Ralph. Use when you have an ML PRD and need prd.json. Triggers on: convert this prd, turn this into ml-ralph format, create prd.json from this, ralph json.
ML-Ralph autonomous agent. Start ML projects, create PRDs through conversation, run autonomous experiments. Triggers: ralph, ml project, kaggle, create prd, start ml, run experiments.
Generate an ML-centric PRD for ML-Ralph. Use when planning an ML project, experiment plan, or when asked to create an ML PRD. Triggers on: create a prd, write prd for, plan this ML feature, requirements for, spec out.
| name | ralph |
| description | Convert an ML PRD into prd.json for ML-Ralph. Use when you have an ML PRD and need prd.json. Triggers on: convert this prd, turn this into ml-ralph format, create prd.json from this, ralph json. |
Converts ML PRDs into the prd.json format used by ML-Ralph.
Take a PRD (markdown or text) and convert it to prd.json in the ML-Ralph directory.
{
"project": "[Project Name]",
"branchName": "ml-ralph/[feature-name-kebab-case]",
"description": "[Short description]",
"userStories": [
{
"id": "US-001",
"title": "[Story title]",
"description": "As a [role], I want [outcome] so that [benefit].",
"type": "discovery | experiment | evaluation | implementation | ops",
"hypothesis": "[Optional hypothesis]",
"evidenceRequired": "[Required evidence to log]",
"acceptanceCriteria": [
"Criterion 1",
"Criterion 2",
"Ruff check passes",
"Ruff format passes",
"Mypy passes",
"Pytest passes (if tests exist)",
"Evidence logged in progress.jsonl"
],
"priority": 1,
"passes": false,
"notes": "",
"supersededBy": "",
"risk": ""
}
]
}
Each story must be completable in one iteration. If you cannot describe the change in 2-3 sentences, split it.
Order stories so earlier ones unlock later ones:
priority orders executionpasses: false for allsupersededBy empty string for allbranchName must start with ml-ralph/ML-Ralph refines prd.json every iteration based on evidence. This is expected and part of the loop. Do not attempt to “lock” the backlog.