Paul.Kim/tst-claude-code-samples
1
0
Fork 0
generated from Paul.Kim/tpl-superclaude
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
15b3eaf5cb1230941e662692d9b6400ba06b0ef4
tst-claude-code-samples/.claude/COMMANDS.md
Paul.Kim 15b3eaf5cb Initial commit
2025-07-21 14:31:56 +09:00

5.6 KiB
Raw Blame History

COMMANDS.md - SuperClaude Command Execution Framework

Command execution framework for Claude Code SuperClaude integration.

Command System Architecture

Core Command Structure

---
command: "/{command-name}"
category: "Primary classification"
purpose: "Operational objective"
wave-enabled: true|false
performance-profile: "optimization|standard|complex"
---

Command Processing Pipeline

  1. Input Parsing: $ARGUMENTS with @<path>, !<command>, --<flags>
  2. Context Resolution: Auto-persona activation and MCP server selection
  3. Wave Eligibility: Complexity assessment and wave mode determination
  4. Execution Strategy: Tool orchestration and resource allocation
  5. Quality Gates: Validation checkpoints and error handling

Integration Layers

  • Claude Code: Native slash command compatibility
  • Persona System: Auto-activation based on command context
  • MCP Servers: Context7, Sequential, Magic, Playwright integration
  • Wave System: Multi-stage orchestration for complex operations

Wave System Integration

Wave Orchestration Engine: Multi-stage command execution with compound intelligence. Auto-activates on complexity ≥0.7 + files >20 + operation_types >2.

Wave-Enabled Commands:

  • Tier 1: /analyze, /build, /implement, /improve
  • Tier 2: /design, /task

Development Commands

/build $ARGUMENTS

---
command: "/build"
category: "Development & Deployment"
purpose: "Project builder with framework detection"
wave-enabled: true
performance-profile: "optimization"
---
  • Auto-Persona: Frontend, Backend, Architect, Scribe
  • MCP Integration: Magic (UI builds), Context7 (patterns), Sequential (logic)
  • Tool Orchestration: [Read, Grep, Glob, Bash, TodoWrite, Edit, MultiEdit]
  • Arguments: [target], @<path>, !<command>, --<flags>

/implement $ARGUMENTS

---
command: "/implement"
category: "Development & Implementation"
purpose: "Feature and code implementation with intelligent persona activation"
wave-enabled: true
performance-profile: "standard"
---
  • Auto-Persona: Frontend, Backend, Architect, Security (context-dependent)
  • MCP Integration: Magic (UI components), Context7 (patterns), Sequential (complex logic)
  • Tool Orchestration: [Read, Write, Edit, MultiEdit, Bash, Glob, TodoWrite, Task]
  • Arguments: [feature-description], --type component|api|service|feature, --framework <name>, --<flags>

Analysis Commands

/analyze $ARGUMENTS

---
command: "/analyze"
category: "Analysis & Investigation"
purpose: "Multi-dimensional code and system analysis"
wave-enabled: true
performance-profile: "complex"
---
  • Auto-Persona: Analyzer, Architect, Security
  • MCP Integration: Sequential (primary), Context7 (patterns), Magic (UI analysis)
  • Tool Orchestration: [Read, Grep, Glob, Bash, TodoWrite]
  • Arguments: [target], @<path>, !<command>, --<flags>

/troubleshoot [symptoms] [flags] - Problem investigation | Auto-Persona: Analyzer, QA | MCP: Sequential, Playwright

/explain [topic] [flags] - Educational explanations | Auto-Persona: Mentor, Scribe | MCP: Context7, Sequential

Quality Commands

/improve [target] [flags]

---
command: "/improve"
category: "Quality & Enhancement"
purpose: "Evidence-based code enhancement"
wave-enabled: true
performance-profile: "optimization"
---
  • Auto-Persona: Refactorer, Performance, Architect, QA
  • MCP Integration: Sequential (logic), Context7 (patterns), Magic (UI improvements)
  • Tool Orchestration: [Read, Grep, Glob, Edit, MultiEdit, Bash]
  • Arguments: [target], @<path>, !<command>, --<flags>

/cleanup [target] [flags] - Project cleanup and technical debt reduction | Auto-Persona: Refactorer | MCP: Sequential

Additional Commands

/document [target] [flags] - Documentation generation | Auto-Persona: Scribe, Mentor | MCP: Context7, Sequential

/estimate [target] [flags] - Evidence-based estimation | Auto-Persona: Analyzer, Architect | MCP: Sequential, Context7

/task [operation] [flags] - Long-term project management | Auto-Persona: Architect, Analyzer | MCP: Sequential

/test [type] [flags] - Testing workflows | Auto-Persona: QA | MCP: Playwright, Sequential

/git [operation] [flags] - Git workflow assistant | Auto-Persona: DevOps, Scribe, QA | MCP: Sequential

/design [domain] [flags] - Design orchestration | Auto-Persona: Architect, Frontend | MCP: Magic, Sequential, Context7

Meta & Orchestration Commands

/index [query] [flags] - Command catalog browsing | Auto-Persona: Mentor, Analyzer | MCP: Sequential

/load [path] [flags] - Project context loading | Auto-Persona: Analyzer, Architect, Scribe | MCP: All servers

Iterative Operations - Use --loop flag with improvement commands for iterative refinement

/spawn [mode] [flags] - Task orchestration | Auto-Persona: Analyzer, Architect, DevOps | MCP: All servers

Command Execution Matrix

Performance Profiles

optimization: "High-performance with caching and parallel execution"
standard: "Balanced performance with moderate resource usage"
complex: "Resource-intensive with comprehensive analysis"

Command Categories

  • Development: build, implement, design
  • Planning: workflow, estimate, task
  • Analysis: analyze, troubleshoot, explain
  • Quality: improve, cleanup
  • Testing: test
  • Documentation: document
  • Version-Control: git
  • Meta: index, load, spawn

Wave-Enabled Commands

7 commands: /analyze, /build, /design, /implement, /improve, /task, /workflow