@faviovazquez/deliberate 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.9] - 2026-04-04
+
+### Added
+- `README.md`: Added local install path examples for `start-server.sh` / `stop-server.sh` under "Starting and stopping the server" — covers Claude Code global/local, Windsurf global/local, and Cursor local install paths.
+- `SKILL.md`: Step 5 now always offers the visual companion before starting the deliberation, even when `--visual` was not passed. Mirrors the behavior already present in BRAINSTORM.md Phase 2. The offer is a standalone message; the user can accept (y) or decline (N/Enter).
+
 ## [0.2.8] - 2026-04-04
 
 ### Added

package/README.md

@@ -492,20 +492,36 @@ If you say yes (or press Enter), it runs `scripts/stop-server.sh` to shut it dow
 
 If you ever need to manage the server manually:
 
+**Claude Code — global install:**
 ```bash
-# Start the server (from your project root)
 bash ~/.claude/skills/deliberate/scripts/start-server.sh --project-dir .
-
-# Stop the server
 bash ~/.claude/skills/deliberate/scripts/stop-server.sh
 ```
 
-For Windsurf:
+**Claude Code — local install:**
+```bash
+bash .claude/skills/deliberate/scripts/start-server.sh --project-dir .
+bash .claude/skills/deliberate/scripts/stop-server.sh
+```
+
+**Windsurf — global install:**
 ```bash
 bash ~/.codeium/windsurf/skills/deliberate/scripts/start-server.sh --project-dir .
 bash ~/.codeium/windsurf/skills/deliberate/scripts/stop-server.sh
 ```
 
+**Windsurf — local install:**
+```bash
+bash .windsurf/skills/deliberate/scripts/start-server.sh --project-dir .
+bash .windsurf/skills/deliberate/scripts/stop-server.sh
+```
+
+**Cursor — local install:**
+```bash
+bash .cursor/skills/deliberate/scripts/start-server.sh --project-dir .
+bash .cursor/skills/deliberate/scripts/stop-server.sh
+```
+
 ---
 
 ## Platforms

package/SKILL.md

@@ -207,12 +207,29 @@ Use the resolved model map from Step 0.5 (Claude Code) or the active context mod
 - `model_tier` in agent frontmatter is treated as metadata only — no model switching occurs
 - No model selection prompt is shown
 
-### Step 5: Visual Companion (optional)
+### Step 5: Visual Companion Offer
 
-If `--visual` flag is set, or if the user has previously accepted the visual companion in this session:
-1. Launch `scripts/start-server.sh --project-dir {project_root}`
+If `--visual` flag is set, skip directly to launching the server (step 5c below).
+
+Otherwise, **always offer the visual companion** before starting the deliberation:
+
+```
+Would you like to follow the deliberation in real time in your browser?
+The visual companion shows agent positions, agreement/disagreement maps,
+and verdict formation as it happens. (Requires opening a local URL)
+
+Open visual companion? (y/N)
+```
+
+**This offer MUST be its own message.** Wait for the user's response before continuing.
+
+- If **yes**: proceed to launch (5c)
+- If **no** or Enter: proceed without visual companion
+
+**5c — Launch:**
+1. Run `scripts/start-server.sh --project-dir {project_root}`
 2. Save `screen_dir` and `state_dir` from the response
-3. Tell user to open the URL
+3. Tell the user to open the URL
 4. Visual companion will be updated after each round
 
 ### Step 6: Round 1 -- Independent Analysis

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faviovazquez/deliberate",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Multi-agent deliberation skill for AI coding assistants. Agreement is a bug.",
   "license": "MIT",
   "author": "Favio Vazquez",