docs: fix global refiner command references

Author: Aitomates

.planning/STATE.md

@@ -27,5 +27,12 @@
 ### Blockers
 - None.
 
+### Quick Tasks Completed
+
+| # | Description | Date | Commit | Status | Directory |
+|---|-------------|------|--------|--------|-----------|
+| 260610-pps | Fix PR #1 review blocker: README and build_and_install.ps1 must accurately document the globally exposed gemini-prompt-refiner command | 2026-06-10 | this commit | Verified | [260610-pps-fix-pr-1-review-blocker-readme-and-build](./quick/260610-pps-fix-pr-1-review-blocker-readme-and-build/) |
+
 ## Session Continuity
+Last activity: 2026-06-10 - Completed quick task 260610-pps: Fix PR #1 command documentation blocker.
 The project is set up with a clear 3-phase roadmap. Next step is to begin planning Phase 1.

.planning/quick/260610-pps-fix-pr-1-review-blocker-readme-and-build/260610-pps-PLAN.md

@@ -0,0 +1,30 @@
+---
+quick_id: 260610-pps
+status: ready
+mode: quick-full
+description: "Fix PR #1 review blocker: README and build_and_install.ps1 must accurately document the globally exposed gemini-prompt-refiner command"
+---
+
+# Quick Task 260610-pps Plan
+
+## Goal
+
+Make the root README and install script accurately identify the global executable exposed by `universal-refiner/package.json`.
+
+## Must Haves
+
+- `README.md` tells users to configure `gemini-prompt-refiner`, matching the package manifest's `bin` key.
+- `build_and_install.ps1` reports and recommends `gemini-prompt-refiner` after global installation.
+- The task remains documentation-only and does not alter package behavior.
+
+## Tasks
+
+1. Update inaccurate `prompt-refiner` command references in `README.md` and `build_and_install.ps1`.
+2. Verify the package manifest and both user-facing files agree on `gemini-prompt-refiner`.
+3. Run `git diff --check`, record validation evidence, update GSD state, and commit the complete quick task atomically.
+
+## Validation
+
+- Inspect `universal-refiner/package.json` and confirm `bin` contains `gemini-prompt-refiner`.
+- Search `README.md` and `build_and_install.ps1` for command references and confirm no inaccurate `prompt-refiner` executable remains.
+- Run `git diff --check`.

.planning/quick/260610-pps-fix-pr-1-review-blocker-readme-and-build/260610-pps-SUMMARY.md

@@ -0,0 +1,21 @@
+---
+quick_id: 260610-pps
+status: complete
+completed: 2026-06-10
+---
+
+# Quick Task 260610-pps Summary
+
+Updated every user-facing executable reference in `README.md` and `build_and_install.ps1` to `gemini-prompt-refiner`, matching the sole `bin` key in `universal-refiner/package.json`.
+
+## Changes
+
+- Corrected the README architecture label and MCP client configuration instruction.
+- Corrected the install script's success and usage messages.
+- Left package behavior unchanged.
+
+## Validation
+
+- Parsed `universal-refiner/package.json` and confirmed `bin=gemini-prompt-refiner`.
+- Inspected all `prompt-refiner` references in `README.md` and `build_and_install.ps1`.
+- Ran `git diff --check`.

.planning/quick/260610-pps-fix-pr-1-review-blocker-readme-and-build/260610-pps-VERIFICATION.md

@@ -0,0 +1,17 @@
+---
+quick_id: 260610-pps
+status: passed
+verified: 2026-06-10
+---
+
+# Quick Task 260610-pps Verification
+
+## Result
+
+Passed. `README.md` and `build_and_install.ps1` consistently identify `gemini-prompt-refiner` as the globally exposed command defined by `universal-refiner/package.json`.
+
+## Evidence
+
+- Manifest inspection found exactly one `bin` key: `gemini-prompt-refiner`.
+- Targeted inspection found no standalone stale `prompt-refiner` command references in the blocked files.
+- `git diff --check` completed without errors.

README.md

@@ -42,7 +42,7 @@ That distinction matters because this repo is about credible system direction, n
 
 ```mermaid
 flowchart LR
-    CLI["AI CLI\n(Claude / Cursor)"] -->|"stdio"| PI["PromptImprover\n(prompt-refiner)"]
+    CLI["AI CLI\n(Claude / Cursor)"] -->|"stdio"| PI["PromptImprover\n(gemini-prompt-refiner)"]
     subgraph internal["PromptImprover Engine"]
         RAG["RAG Snippets\n(FlexSearch)"]
         Memory["SQLite Memory\n(LocalBrain)"]
@@ -69,7 +69,7 @@ cd Promptimprover
 .\build_and_install.ps1
 ```
 
-Add `prompt-refiner` to your MCP client configuration. See the [Setup Guide](https://github.com/Coding-Autopilot-System/Promptimprover/wiki/Setup-Guide) for full configuration instructions.
+Add `gemini-prompt-refiner` to your MCP client configuration. See the [Setup Guide](https://github.com/Coding-Autopilot-System/Promptimprover/wiki/Setup-Guide) for full configuration instructions.
 
 ## License
 

build_and_install.ps1

@@ -8,5 +8,5 @@ npm install -g .
 $package = Get-Content .\package.json | ConvertFrom-Json
 $version = $package.version
 
-Write-Host "Prompt Refiner v$version installed globally as 'prompt-refiner'" -ForegroundColor Green
-Write-Host "Use 'prompt-refiner' command in your MCP configurations." -ForegroundColor Yellow
+Write-Host "Prompt Refiner v$version installed globally as 'gemini-prompt-refiner'" -ForegroundColor Green
+Write-Host "Use 'gemini-prompt-refiner' command in your MCP configurations." -ForegroundColor Yellow