Summary

Fixes #141

The AI agent was generating invalid prd.json files with nested structures (e.g., wrapping everything in a "prd" object) instead of the flat schema expected by the JSON tracker.

Changes

• PrdChatApp.tsx: Added explicit WRONG examples and stronger "DO NOT USE" guidance in the skillPrompt
• ralph-tui-create-json/SKILL.md: Added comprehensive anti-patterns section with visual ❌ WRONG and ✅ CORRECT examples

Problem

When using ralph-tui create-prd with chat mode, the AI agent would sometimes generate:

{
  "prd": {
    "metadata": {...},
    "overview": {...},
    ...
  }
}

Instead of the correct flat structure:

{
  "name": "Feature Name",
  "userStories": [...]
}

Solution

The validation in json.ts already correctly rejects these invalid schemas, but this fix prevents the AI from generating them in the first place by:

1. Adding explicit examples of WRONG patterns in the skill prompt
2. Using visual markers (❌ ✅) to make correct/incorrect patterns obvious
3. Listing specific forbidden fields and patterns

Testing

• bun run typecheck passes
• bun run build succeeds

Summary by CodeRabbit

Documentation

• Clarified PRD document structure requirements with improved guidance and detailed specifications
• Added comprehensive validation rules and compliance guidelines to prevent errors
• Enhanced instructional examples demonstrating proper formatting and structure
• Documented common mistakes and forbidden patterns with clear prevention guidance
• Improved field requirement documentation for better user understanding and compliance

_{✏️ Tip: You can customize this high-level summary in your review settings.}