productlisted

# $product — Interactive PRODUCT.md Generation > **Purpose:** Guide the user through creating a `PRODUCT.md` that unlocks product-aware reviews in `$pre-mortem` and `$vibe`, including the default quick-mode inline paths. **YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.** **CLI dependencies:** None required. ## Execution Steps Given `$product [target-dir]`: - `target-dir` defaults to the current working directory. ### Step 1: Pre-flight Check if PRODUCT.md already exists: ```bash ls PRODUCT.md 2>/dev/null ``` **If it exists:** Ask the user directly: - **Question:** "PRODUCT.md already exists. What would you like to do?" - **Options:** - "Overwrite — start fresh" → continue to Step 2 - "Update — keep existing content as defaults" → read existing file, use its values as pre-populated suggestions in Step 3 - "Cancel" → stop, report no changes **If it does not exist:** continue to Step 2. ### Step 2: Gather Context Read available project files to pre-populate suggestions: 1. **README.md** — extract project description, purpose, target audience 2. **package.json / pyproject.toml / go.mod / Cargo.toml** — extract project name 3. **Directory listing** — `ls` the project root for structural hints Use what you find to draft initial suggestions for each section. If no files exist, proceed with blank suggestions. ### Step 3: Interview Ask the user about each section. For each question, offer pre-populated suggestions from Step 2 where available. #### 3a