feat: Implement plan-precise command and path reading script for precise analysis

.claude/commands/gemini/mode/plan-precise.md

@@ -0,0 +1,140 @@
+---
+name: plan-precise
+description: Precise path planning analysis for complex projects
+usage: /gemini:mode:plan-precise "planning topic"
+examples:
+  - /gemini:mode:plan-precise "design authentication system"
+  - /gemini:mode:plan-precise "refactor database layer architecture"
+---
+
+### 🚀 Command Overview: `/gemini:mode:plan-precise`
+
+Precise path-based planning analysis using user-specified directories instead of --all-files.
+
+### 📝 Execution Template
+
+```pseudo
+# Precise path planning with user-specified scope
+
+PLANNING_TOPIC = user_argument
+PATHS_FILE = "./planning-paths.txt"
+
+# Step 1: Check paths file exists
+IF not file_exists(PATHS_FILE):
+    Write(PATHS_FILE, template_content)
+    echo "📝 Created planning-paths.txt in project root"
+    echo "Please edit file and add paths to analyze"
+    # USER_INPUT: User edits planning-paths.txt and presses Enter
+    wait_for_user_input()
+ELSE:
+    echo "📁 Using existing planning-paths.txt"
+    echo "Current paths preview:"
+    Bash(grep -v '^#' "$PATHS_FILE" | grep -v '^$' | head -5)
+    # USER_INPUT: User confirms y/n
+    user_confirm = prompt("Continue with these paths? (y/n): ")
+    IF user_confirm != "y":
+        echo "Please edit planning-paths.txt and retry"
+        exit
+
+# Step 2: Read and validate paths
+paths_ref = Bash(.claude/scripts/read-paths.sh "$PATHS_FILE")
+
+IF paths_ref is empty:
+    echo "❌ No valid paths found in planning-paths.txt"
+    echo "Please add at least one path and retry"
+    exit
+
+echo "🎯 Analysis paths: $paths_ref"
+echo "📋 Planning topic: $PLANNING_TOPIC"
+
+# BASH_EXECUTION_STOPS → MODEL_ANALYSIS_BEGINS
+```
+
+### 🧠 Model Analysis Phase
+
+After bash script prepares paths, model takes control to:
+
+1. **Present Configuration**: Show user the detected paths and analysis scope
+2. **Request Confirmation**: Wait for explicit user approval  
+3. **Execute Analysis**: Run gemini with precise path references
+
+### 📋 Execution Flow
+
+```pseudo
+# Step 1: Present plan to user
+PRESENT_PLAN:
+  📋 Precise Path Planning Configuration:
+  
+  Topic: design authentication system
+  Paths: src/auth/**/* src/middleware/auth* tests/auth/**/* config/auth.json
+  Gemini Reference: $(.claude/scripts/read-paths.sh ./planning-paths.txt)
+  
+  ⚠️ Continue with analysis? (y/n)
+
+# Step 2: MANDATORY user confirmation  
+IF user_confirms():
+    # Step 3: Execute gemini analysis
+    Bash(gemini -p "$(.claude/scripts/read-paths.sh ./planning-paths.txt) @{CLAUDE.md} $(cat ~/.claude/prompt-templates/plan.md)
+
+Planning Topic: $PLANNING_TOPIC")
+ELSE:
+    abort_execution()
+    echo "Edit planning-paths.txt and retry"
+```
+
+### ✨ Features
+
+- **Root Level Config**: `./planning-paths.txt` in project root (no subdirectories)
+- **Simple Workflow**: Check file → Present plan → Confirm → Execute  
+- **Path Focused**: Only analyzes user-specified paths, not entire project
+- **No Complexity**: No validation, suggestions, or result saving - just core function
+- **Template Creation**: Auto-creates template file if missing
+
+### 📚 Usage Examples
+
+```bash
+# Create analysis for authentication system
+/gemini:mode:plan-precise "design authentication system"
+
+# System creates planning-paths.txt (if needed)
+# User edits: src/auth/**/* tests/auth/**/* config/auth.json  
+# System confirms paths and executes analysis
+```
+
+### 🔍 Complete Execution Example
+
+```bash
+# 1. Command execution
+$ /gemini:mode:plan-precise "design authentication system"
+
+# 2. System output
+📋 Precise Path Planning Configuration:
+
+Topic: design authentication system
+Paths: src/auth/**/* src/middleware/auth* tests/auth/**/* config/auth.json
+Gemini Reference: @{src/auth/**/*,src/middleware/auth*,tests/auth/**/*,config/auth.json}
+
+⚠️ Continue with analysis? (y/n)
+
+# 3. User confirms
+$ y
+
+# 4. Actual gemini command executed
+$ gemini -p "$(.claude/scripts/read-paths.sh ./planning-paths.txt) @{CLAUDE.md} $(cat ~/.claude/prompt-templates/plan.md)
+
+Planning Topic: design authentication system"
+```
+
+### 🔧 Path File Format
+
+Simple text file in project root: `./planning-paths.txt`
+
+```
+# Comments start with #
+src/auth/**/*
+src/middleware/auth*  
+tests/auth/**/*
+config/auth.json
+docs/auth/*.md
+```
+

.claude/scripts/read-paths.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# read-paths.sh - Simple path reader for gemini format
+# Usage: read-paths.sh <paths_file>
+
+PATHS_FILE="$1"
+
+# Check file exists
+if [ ! -f "$PATHS_FILE" ]; then
+    echo "❌ File not found: $PATHS_FILE" >&2
+    exit 1
+fi
+
+# Read valid paths
+valid_paths=()
+while IFS= read -r line; do
+    # Skip comments and empty lines
+    [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue
+    
+    # Clean and add path
+    path=$(echo "$line" | xargs)
+    [ -n "$path" ] && valid_paths+=("$path")
+done < "$PATHS_FILE"
+
+# Check if we have paths
+if [ ${#valid_paths[@]} -eq 0 ]; then
+    echo "❌ No valid paths found in $PATHS_FILE" >&2
+    exit 1
+fi
+
+# Output gemini format @{path1,path2,...}
+printf "@{"
+printf "%s" "${valid_paths[0]}"
+printf ",%s" "${valid_paths[@]:1}"
+printf "}"