Why does the schema reject the 'status' field?

The Ralph TUI schema uses a boolean 'passes' field (true/false) instead of a string-based 'status' to provide a clear, binary completion state that AI agents can easily interpret.

How do I check if my PRD file is valid?

You can invoke the command '/prd-schema validate ' to run a diagnostic check against the schema and receive specific feedback on any violations.

What is a prd.json file in this context?

A prd.json file is a structured document used by the Essentials plugin and Ralph TUI to define tasks, acceptance criteria, and dependencies for AI agents to execute within Claude Code.

Can I use nested subtasks in my PRD?

No, the schema requires a flat list of user stories. Complex hierarchies should be managed using the 'dependsOn' array to create a Directed Acyclic Graph (DAG) of tasks.

What is the relationship between plans and prd.json?

Architectural plans (.md) are high-level designs that are converted into prd.json files via the /tasks-converter skill, which prd-schema then validates for execution.

Ralph PRD Schema Validator

Name: Ralph PRD Schema Validator
Author: GantisStorm

byGantisStorm

•

生産性とワークフロー

Validates and manages prd.json task structures to ensure compatibility with Ralph TUI and Claude Code task systems.

The prd-schema skill provides a specialized framework for managing Project Requirement Documents (PRDs) in JSON format. It acts as a gatekeeper for the Ralph TUI ecosystem, ensuring that task lists and user stories are structured correctly with required fields like 'passes', 'id', and 'title'. By enforcing a strict schema and validating dependency graphs, this skill prevents execution errors in automated task loops and facilitates a seamless transition from high-level architectural plans to granular, executable coding tasks. It is an essential tool for developers using the Essentials plugin suite to maintain high-integrity project workflows.

主な機能

01Detection and correction of unsupported fields like 'status' or 'subtasks'

0284 GitHub stars

03Strict JSON schema validation for Ralph TUI compatibility

04Plan-to-PRD field mapping reference for architectural consistency

05Self-contained user story validation to ensure executor context

06Dependency graph (DAG) integrity checking for task sequencing

ユースケース

01Mapping architectural plan sections to standardized JSON fields during project setup

02Validating manually edited prd.json files before initiating a task swarm

03Troubleshooting execution blocks by verifying task dependencies and priorities

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gantisstorm/essentials-claude-code prd-schema

For use in Claude.ai and ChatGPT

Download Skill