SuperClaude/Framework-Lite/Commands/build.md

name	description	allowed-tools	category	complexity	scope	mcp-integration
build	Build, compile, and package projects with comprehensive error handling, optimization, and automated validation	Read Bash Grep Glob Write	utility	enhanced	project	servers personas wave-enabled playwright devops-engineer true

/sc:build - Project Building and Packaging

Purpose

Execute comprehensive build workflows that compile, bundle, and package projects with intelligent error handling, build optimization, and deployment preparation across different build targets and environments.

Usage

/sc:build [target] [--type dev|prod|test] [--clean] [--optimize] [--verbose]

Arguments

• target - Specific project component, module, or entire project to build
• --type - Build environment configuration (dev, prod, test)
• --clean - Remove build artifacts and caches before building
• --optimize - Enable advanced build optimizations and minification
• --verbose - Display detailed build output and progress information

Execution

Standard Build Workflow (Default)

1. Analyze project structure, build configuration files, and dependency manifest
2. Validate build environment, dependencies, and required toolchain components
3. Execute build process with real-time monitoring and error detection
4. Handle build errors with diagnostic analysis and suggested resolution steps
5. Optimize build artifacts, generate build reports, and prepare deployment packages

Claude Code Integration

• Tool Usage: Bash for build system execution, Read for configuration analysis, Grep for error parsing
• File Operations: Reads build configs and package manifests, writes build logs and artifact reports
• Analysis Approach: Configuration-driven build orchestration with dependency validation
• Output Format: Structured build reports with artifact sizes, timing metrics, and error diagnostics

Performance Targets

• Execution Time: <5s for build setup and validation, variable for compilation process
• Success Rate: >95% for build environment validation and process initialization
• Error Handling: Comprehensive build error analysis with actionable resolution guidance

Examples

Basic Usage

/sc:build
# Builds entire project using default configuration
# Generates standard build artifacts in output directory

Advanced Usage

/sc:build frontend --type prod --clean --optimize --verbose
# Clean production build of frontend module with optimizations
# Displays detailed build progress and generates optimized artifacts

Error Handling

• Invalid Input: Validates build targets exist and build system is properly configured
• Missing Dependencies: Checks for required build tools, compilers, and dependency packages
• File Access Issues: Handles source file permissions and build output directory access
• Resource Constraints: Manages memory and disk space during compilation and bundling

Integration Points

• SuperClaude Framework: Coordinates with test command for build verification and analyze for quality checks
• Other Commands: Precedes test and deployment workflows, integrates with git for build tagging
• File System: Reads source code and configurations, writes build artifacts to designated output directories

Boundaries

This command will:

• Execute project build systems using existing build configurations
• Provide comprehensive build error analysis and optimization recommendations
• Generate build artifacts and deployment packages according to target specifications

This command will not:

• Modify build system configuration or create new build scripts
• Install missing build dependencies or development tools
• Execute deployment operations beyond artifact preparation