Claude-Code-Workflow/.claude/commands/cli/mode/bug-index.md

name, description, usage, argument-hint, examples, allowed-tools

name	description	usage	argument-hint	examples	allowed-tools
bug-index	Bug analysis and fix suggestions using CLI tools	/cli:mode:bug-index [--tool <codex|gemini|qwen>] [--enhance] [--cd "path"] "bug description"	[--tool codex|gemini|qwen] [--enhance] [--cd path] bug description	/cli:mode:bug-index "authentication null pointer error" /cli:mode:bug-index --tool qwen --enhance "login not working" /cli:mode:bug-index --tool codex --cd "src/auth" "token validation fails"	SlashCommand(*), Bash(*)

CLI Mode: Bug Index (/cli:mode:bug-index)

Purpose

Execute systematic bug analysis and fix suggestions using CLI tools with diagnostic template.

Supported Tools: codex, gemini (default), qwen

Execution Flow

1. Parse tool selection: Extract --tool flag (default: gemini)
2. If --enhance flag present: Execute /enhance-prompt "[bug-description]" first
3. Parse bug description (original or enhanced)
4. Detect target directory (from --cd or auto-infer)
5. Build command for selected tool with bug-fix template
6. Execute analysis
7. Save to session (if active)

Core Rules

1. Enhance First (if flagged): Execute /enhance-prompt before analysis
2. Directory Context: Use cd when --cd provided or auto-detected
3. Template Required: Always use bug-fix template
4. Session Output: Save to .workflow/WFS-[id]/.chat/bug-index-[timestamp].md

Command Template

Core Guidelines: @~/.claude/workflows/intelligent-tools-strategy.md

cd [directory] && ~/.claude/scripts/gemini-wrapper --all-files -p "
PURPOSE: [bug analysis goal]
TASK: Systematic bug analysis and fix recommendations
CONTEXT: @{CLAUDE.md,**/*CLAUDE.md} [entire codebase in directory]
EXPECTED: Root cause analysis, code path tracing, targeted fixes
RULES: $(cat ~/.claude/prompt-templates/bug-fix.md) | Bug: [description]
"

Examples

Basic Bug Analysis:

cd . && ~/.claude/scripts/gemini-wrapper --all-files -p "
PURPOSE: Debug authentication null pointer error
TASK: Identify root cause and provide fix
CONTEXT: @{CLAUDE.md,**/*CLAUDE.md}
EXPECTED: Root cause, code path, minimal fix, impact assessment
RULES: $(cat ~/.claude/prompt-templates/bug-fix.md) | Bug: null pointer in login flow
"

Directory-Specific:

cd src/auth && ~/.claude/scripts/gemini-wrapper --all-files -p "
PURPOSE: Fix token validation failure
TASK: Analyze token validation bug in auth module
CONTEXT: @{CLAUDE.md,**/*CLAUDE.md}
EXPECTED: Validation logic analysis, fix recommendation
RULES: $(cat ~/.claude/prompt-templates/bug-fix.md) | Bug: token validation fails intermittently
"

With Enhancement:

# User: /gemini:mode:bug-index --enhance "login broken"

# Step 1: Enhance
/enhance-prompt "login broken"
# Returns:
# INTENT: Debug login authentication failure
# CONTEXT: Known session state issue
# ACTION: Check session management → verify token → test flow

# Step 2: Analyze with enhanced context
cd . && ~/.claude/scripts/gemini-wrapper --all-files -p "
PURPOSE: Debug login authentication failure
TASK: Analyze session management, token handling, auth flow
CONTEXT: @{CLAUDE.md,**/*CLAUDE.md} Known: session state issue
EXPECTED: Root cause in session/token, targeted fix
RULES: $(cat ~/.claude/prompt-templates/bug-fix.md) | Focus on session management
"

Analysis Focus

Template provides:

• Root Cause Analysis: Systematic investigation
• Code Path Tracing: Execution flow analysis
• Targeted Solutions: Minimal, specific fixes
• Impact Assessment: Side effect evaluation

Session Output

Location: .workflow/WFS-[topic]/.chat/bug-index-[timestamp].md

Includes:

• Bug description
• Template used
• Analysis results
• Recommended actions