docs: remove placeholders and coming soon mentions

- Remove screenshot and asciinema placeholder components
- Replace "coming soon" with link to GitHub Discussions

Author: MiniCodeMonkey

docs/guide/quick-start.md

@@ -48,58 +48,64 @@ chief --version
 
 ## Step 2: Create Your First PRD
 
-Navigate to your project directory and initialize Chief:
+Navigate to your project directory and create a new PRD:
 
 ```bash
 cd your-project
 chief new
 ```
 
-<PlaceholderImage label="Screenshot: chief new flow" height="250px" />
+This launches Claude Code with a preloaded prompt. Work with Claude to describe what you want to build—your project goals, user stories, and acceptance criteria. Claude will help structure your requirements and write the `prd.md` file.
 
-This creates a `.chief/` directory with a sample PRD to get you started. The PRD includes:
+When you're done, type `/exit` to leave Claude Code. Chief then parses `prd.md` and generates `prd.json`:
 
-- `prd.md` - Human-readable project requirements
-- `prd.json` - Machine-readable user stories for Chief to execute
+- `prd.md` - Human-readable project requirements (written by Claude)
+- `prd.json` - Machine-readable user stories for Chief to execute (generated by Chief)
 
-::: tip Customize your PRD
-Open `.chief/prds/default/prd.md` in your editor to write your own user stories. Chief will parse it into `prd.json` automatically.
+::: tip Iterating on your PRD
+Run `chief edit` to reopen Claude Code and refine your `prd.md`. Chief will regenerate `prd.json` when you `/exit`.
 :::
 
-## Step 3: Run the Loop
+## Step 3: Launch the TUI
 
-Start the autonomous loop:
+Launch Chief's Terminal User Interface:
 
 ```bash
 chief
 ```
 
-That's it! Chief takes over from here.
+This opens the TUI dashboard in **Ready** state. The loop doesn't start automatically—you control when it begins.
 
-## Step 4: Watch It Work
+## Step 4: Start the Loop
 
-Chief launches a beautiful TUI (Terminal User Interface) that shows:
+Press `s` to start the Ralph Loop. Chief will begin working through your stories automatically.
 
-- **Current Story** - Which user story is being implemented
-- **Live Output** - Real-time streaming from Claude
-- **Progress** - How many stories are complete vs remaining
+The TUI shows:
 
-<PlaceholderImage label="Screenshot: TUI Dashboard" height="400px" />
+- **Tab Bar** - All your PRDs with status indicators
+- **Stories List** - User stories with completion status
+- **Story Details** - Current story's description and acceptance criteria
+- **Live Activity** - Real-time status updates from Claude
 
 ### Keyboard Controls
 
 | Key | Action |
 |-----|--------|
-| `Tab` | Switch between output and log views |
-| `↑/↓` | Scroll through output |
-| `q` | Quit Chief |
+| `s` | **Start** the loop (when Ready, Paused, or Stopped) |
+| `p` | **Pause** the loop (finishes current iteration) |
+| `x` | **Stop** the loop immediately |
+| `t` | **Toggle** between Dashboard and Log views |
+| `n` | Open **PRD picker** to switch or create PRDs |
+| `1-9` | **Quick switch** to PRD tabs 1-9 |
+| `j/↓` | Navigate down (stories or scroll log) |
+| `k/↑` | Navigate up (stories or scroll log) |
+| `?` | Show **help** overlay |
+| `q` | **Quit** Chief |
 
 ::: info Hands-off operation
-Chief runs autonomously. You can watch the progress or walk away - it will complete your PRD and play a sound when done.
+Once started with `s`, Chief runs autonomously. You can watch the progress or walk away—it will complete your PRD and play a sound when done.
 :::
 
-<AsciinemaPlaceholder label="Recording: Full Chief Workflow (chief new → chief)" />
-
 ## What's Next?
 
 Now that you've run your first Chief loop, explore these resources:

docs/reference/cli.md

@@ -254,8 +254,6 @@ When Chief is running, the TUI provides real-time feedback and interactive contr
 The TUI has two main views: **Dashboard** showing stories and progress, and **Log** view streaming Claude's output in real time. Press `t` to toggle between them.
 :::
 
-<PlaceholderImage label="Screenshot: TUI Log View" height="400px" />
-
 ## Exit Codes
 
 Chief uses standard exit codes:

docs/troubleshooting/faq.md

@@ -128,7 +128,7 @@ For specific problems and solutions.
 
 ### Is there a community chat?
 
-Coming soon. For now, use GitHub Discussions.
+Use [GitHub Discussions](https://github.com/minicodemonkey/chief/discussions) for questions and community support.
 
 ### Can I contribute?