PRD Generator

Generate a Product Requirements Document (prd.md) from validated idea files.

Terms used throughout:

• PROJECT_DIR: the folder that holds idea.md and validate.md. prd.md is written there.
• Run mode: create when PROJECT_DIR/prd.md does not exist or the user asks for a new PRD; modify when it exists and the user wants changes to it.
• Ideas repo: the git repository that contains PROJECT_DIR, when its root has scripts/update_readme_ideas_index.py or a README.md ideas table with a PRD column.
• Status: COMPLETE, PARTIAL or BLOCKED, chosen by the rules in Final Report.

Run order: Phase 1 (Repo Sync runs inside it), Phases 2-7, then the Final Report. A modify run replaces Phases 2-5 with Modification Mode. A stop at any point still produces the Final Report.

Repo Sync Before Edits (mandatory)

Run this inside the git repository that contains PROJECT_DIR, after Phase 1 step 1 resolves PROJECT_DIR and before any file is written.

1. Run git -C "$PROJECT_DIR" rev-parse --show-toplevel. If it fails, PROJECT_DIR is not in a git repository: skip this sync and go on.
2. Run git status --porcelain in that repository.
3. If the output is empty, sync: