setup-prd

Setup PRD Command

Prepare development environment for a PRD by creating a feature branch, auto-assigning, and moving to Ready.

Purpose

Create isolated development environment for PRD:

• Create feature branch
• Set up Git worktree in worktrees/ (MANDATORY)
• Auto-assign to current user
• Move PRD to Ready (02-ready/)
• Update WORK_PLAN.md
• Keep main branch active in current window (CRITICAL)
• Accept draft PRDs (with warning) for parallel workflow

⚠️ Critical Rules (MANDATORY)

1. Worktree Location

ALWAYS use worktrees/ subdirectory for consistency:

# ✅ CORRECT (Standard as of 2025-11-02)
git worktree add worktrees/prd-007-oauth2-integration feat/PRD-007-oauth2-integration

# ❌ WRONG (Old pattern - deprecated)
git worktree add ../watchora-prd-007 feat/PRD-007-oauth2-integration

Rationale:

• ✅ Centralized organization (all worktrees in one place)
• ✅ Easier to find and manage
• ✅ Cleaner project structure
• ✅ Consistent with modern Git worktree best practices

2. Branch Context

ALWAYS return to main branch after setup:

# After creating worktree, ensure we're on main
git checkout main

Rationale:

• ✅ Main window stays on main (free for other work)
• ✅ Feature work happens in separate Cursor window (worktree)
• ✅ No accidental commits to feature branch in main window
• ✅ Parallel workflow enabled

---

Step-by-Step Process

Step 1: List Available PRDs

Scan PRD directories for available PRDs:

# Check these directories:
- product/prds/01-draft/
- product/prds/02-ready/
- product/prds/03-in-progress/ (to show what's already being worked on)

Display table:

📋 **PRDs Available**

**Draft** (Review later on feature branch):
| # | PRD ID | Feature | Created |
|---|--------|---------|---------|
| 1 | PRD-007 | OAuth2 Integration | 2025-10-26 |
| 2 | PRD-008 | Dark Mode Support | 2025-10-26 |

**Approved** (Ready to code):
| # | PRD ID | Feature | Grade |
|---|--------|---------|-------|
| 3 | PRD-003 | Design System | A- |
| 4 | PRD-004 | Landing Page | B+ |

**In Progress** (Already being developed):
| # | PRD ID | Feature | Branch |
|---|--------|---------|--------|
| 5 | PRD-005 | API v2 | feature/PRD-005-api-v2 |

Which PRD? (number, PRD-XXX, or filename)