**Summary:** Updated all 62 command files in `.claude/commands` directory to improve parameter documentation clarity by replacing `examples` field with descriptive `argument-hint` field. **Changes:** - Added/improved `argument-hint` for all commands based on usage patterns - Removed `examples` field and all example items from YAML headers - Maintained all other YAML fields (name, description, usage, allowed-tools) - Deleted obsolete commands: workflow/issue/*, workflow/session/pause.md, workflow/session/switch.md - Cleaned up temporary analysis files **Rationale:** The `argument-hint` field provides clearer, more concise parameter documentation than example lists, improving command discoverability and usability in the Claude Code interface. **Files Modified:** 62 command files **Lines Changed:** -1570 insertions, +192 deletions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
6.4 KiB
name, description, usage, argument-hint, allowed-tools
| name | description | usage | argument-hint | allowed-tools |
|---|---|---|---|---|
| execute | Auto-execution of implementation tasks with YOLO permissions and intelligent context inference | /cli:execute [--tool <codex|gemini|qwen>] [--enhance] <description|task-id> | [--tool codex|gemini|qwen] [--enhance] description or task-id | SlashCommand(*), Bash(*) |
CLI Execute Command (/cli:execute)
Purpose
Execute implementation tasks with YOLO permissions (auto-approves all confirmations). MODIFIES CODE.
Intent: Autonomous code implementation, modification, and generation Supported Tools: codex, gemini (default), qwen Key Feature: Automatic context inference and file pattern detection
Core Behavior
- Code Modification: This command MODIFIES, CREATES, and DELETES code files
- Auto-Approval: YOLO mode bypasses confirmation prompts for all operations
- Implementation Focus: Executes actual code changes, not just recommendations
- Requires Explicit Intent: Use only when implementation is intended
Core Concepts
YOLO Permissions
Auto-approves: file pattern inference, execution, file modifications, summary generation
⚠️ WARNING: This command will make actual code changes without manual confirmation
Execution Modes
1. Description Mode (supports --enhance):
- Input: Natural language description
- Process: [Optional: Enhance] → Keyword analysis → Pattern inference → Execute
2. Task ID Mode (no --enhance):
- Input: Workflow task identifier (e.g.,
IMPL-001) - Process: Task JSON parsing → Scope analysis → Execute
Context Inference
Auto-selects files based on keywords and technology:
- "auth" →
@{**/*auth*,**/*user*} - "React" →
@{src/**/*.{jsx,tsx}} - "api" →
@{**/api/**/*,**/routes/**/*} - Always includes:
@{CLAUDE.md,**/*CLAUDE.md}
For precise file targeting, use rg or MCP tools to discover files first.
Codex Session Continuity
Resume Pattern for related tasks:
# First task - establish session
codex -C [dir] --full-auto exec "[task]" --skip-git-repo-check -s danger-full-access
# Related task - continue session
codex --full-auto exec "[related-task]" resume --last --skip-git-repo-check -s danger-full-access
Use resume --last when current task extends/relates to previous execution. See intelligent-tools-strategy.md for auto-resume rules.
Parameters
--tool <codex|gemini|qwen>- Select CLI tool (default: gemini)--enhance- Enhance input with/enhance-promptfirst (Description Mode only)<description|task-id>- Natural language description or task identifier--debug- Verbose logging--save-session- Save execution to workflow session
Workflow Integration
Session Management: Auto-detects .workflow/.active-* marker
- Active session: Save to
.workflow/WFS-[id]/.chat/execute-[timestamp].md - No session: Create new session or save to scratchpad
Task Integration: Load from .task/[TASK-ID].json, update status, generate summary
Output Routing
Execution Log Destination:
- IF active workflow session exists:
- Save to
.workflow/WFS-[id]/.chat/execute-[timestamp].md - Update task status in
.task/[TASK-ID].json(if task ID provided) - Generate summary in
.workflow/WFS-[id]/.summaries/[TASK-ID]-summary.md
- Save to
- ELSE (no active session):
- Option 1: Create new workflow session for task
- Option 2: Save to
.workflow/.scratchpad/execute-[description]-[timestamp].md
Output Files (when active session exists):
- Execution log:
.workflow/WFS-[id]/.chat/execute-[timestamp].md - Task summary:
.workflow/WFS-[id]/.summaries/[TASK-ID]-summary.md(if task ID) - Modified code: Project files per implementation
Examples:
- During session
WFS-auth-system, executingIMPL-001:- Log:
.workflow/WFS-auth-system/.chat/execute-20250105-143022.md - Summary:
.workflow/WFS-auth-system/.summaries/IMPL-001-summary.md
- Log:
- No session, ad-hoc implementation:
- Log:
.workflow/.scratchpad/execute-jwt-auth-20250105-143045.md
- Log:
Command Template
# Gemini/Qwen: MODE=write with --approval-mode yolo
cd . && ~/.claude/scripts/gemini-wrapper --approval-mode yolo -p "
PURPOSE: [implementation goal]
TASK: [specific implementation]
MODE: write
CONTEXT: @{CLAUDE.md} [auto-detected files]
EXPECTED: Working implementation with code changes
RULES: [constraints] | Auto-approve all changes
"
# Codex: MODE=auto with danger-full-access
codex -C . --full-auto exec "
PURPOSE: [implementation goal]
TASK: [specific implementation]
MODE: auto
CONTEXT: [auto-detected files]
EXPECTED: Complete implementation with tests
" --skip-git-repo-check -s danger-full-access
Examples
Basic Implementation (⚠️ modifies code):
/cli:execute "implement JWT authentication with middleware"
# Executes: Creates auth middleware, updates routes, modifies config
# Result: NEW/MODIFIED code files with JWT implementation
Enhanced Implementation (⚠️ modifies code):
/cli:execute --enhance "implement JWT authentication"
# Step 1: Enhance to expand requirements
# Step 2: Execute implementation with auto-approval
# Result: Complete auth system with MODIFIED code files
Task Execution (⚠️ modifies code):
/cli:execute IMPL-001
# Reads: .task/IMPL-001.json for requirements
# Executes: Implementation based on task spec
# Result: Code changes per task definition
Codex Implementation (⚠️ modifies code):
/cli:execute --tool codex "optimize database queries"
# Executes: Codex with full file access
# Result: MODIFIED query code, new indexes, updated tests
Qwen Code Generation (⚠️ modifies code):
/cli:execute --tool qwen --enhance "refactor auth module"
# Step 1: Enhanced refactoring plan
# Step 2: Execute with MODE=write
# Result: REFACTORED auth code with structural changes
Comparison with Analysis Commands
| Command | Intent | Code Changes | Auto-Approve |
|---|---|---|---|
/cli:analyze |
Understand code | ❌ NO | N/A |
/cli:chat |
Ask questions | ❌ NO | N/A |
/cli:execute |
Implement | ✅ YES | ✅ YES |
Notes
- Command templates, YOLO mode details, and session management: see intelligent-tools-strategy.md (loaded in memory)
- Output routing and scratchpad details: see workflow-architecture.md
- ⚠️ Code Modification: This command modifies code - execution logs document changes made