Prd Parsing Logic

PRD Parsing Logic

Extracts machine-readable signals from the Factory standard PRD format.

Prerequisites

• A valid knowledge/prd.md file following the Factory PRD template.
• Target PRD must be in READY state.

Process

1. Load PRD: Read knowledge/prd.md.
2. Identify JSON Blocks: Locate all ```json blocks within the "Functional Requirements" section. These contain machine-executable acceptance criteria.
3. Extract Metadata:
   • Extract project_name from H1.
   • Extract description from Executive Summary.
4. Extract AI Components: Parse Section 5 "AI Component Specifications" to identify model requirements and grounding strategies.
5. Map to Config: Convert the extracted data into a ProjectConfig schema.

Guidelines

• Regex Precision: Use robust regex to find the start and end of specific sections (Functional Requirements, NFRs, etc.).
• Validation: Ensure that every extracted JSON block is valid and follows the story_id / acceptance structure.
• Error Handling: If a required section is missing, flag it as a warning but continue if possible.

Best Practices

• Schema Strictness: Validate extracted JSON blocks against story_id and acceptance criteria schemas.
• Context Preservation: Ensure AI component specs include all necessary grounding and model parameters.
• Idempotency: Parsing the same PRD multiple times should yield identical ProjectConfig objects.

When to Use

• When a knowledge/prd.md exists and is marked as READY.
• Before running the automated-code-generation skill.