api-reference

Understanding the prd.json Schema for User Stories and Passes Status in Ralph

April 13, 2026 snarktank/ralph ↗

The prd.json schema defines a JSON structure where each user story includes a passes boolean flag that indicates whether all acceptance criteria and automated checks have succeeded, enabling the Ralph automation loop to track completion status without manual intervention.

The prd.json file serves as the product requirements document for projects managed by Ralph, an autonomous development agent. Understanding the prd.json schema for user stories and passes status is essential for teams leveraging the snarktank/ralph repository to automate their development workflow, as this structure dictates how the AI interpre

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how snarktank/ralph works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →