Validates project build process. Run after changes to ensure the project compiles/transpiles correctly.
Validates project build process and reports compilation status, artifacts, and warnings.
/plugin marketplace add CloudAI-X/claude-workflow/plugin install project-starter@claude-workflowValidate that the project builds successfully. Run BEFORE commits to catch build failures early.
Identify the project's build system:
# Check for common build configurations
ls package.json Makefile setup.py pyproject.toml go.mod Cargo.toml CMakeLists.txt 2>/dev/null
Based on detected system:
npm run build 2>&1 || yarn build 2>&1 || pnpm build 2>&1 || bun run build 2>&1
python -m py_compile **/*.py
# or for packages:
pip install -e . --dry-run
go build ./...
cargo build
Check that expected outputs exist:
dist/ or build/ directory for JS/TS# Example for Node.js
ls -la dist/ build/ 2>/dev/null
Parse build output for:
## Build Validation: [PASS/FAIL]
### Build Command
[command used]
### Result
- Exit code: [0/non-zero]
- Duration: [time if available]
### Artifacts
- [x] Output directory created
- [x] Expected files present
- [ ] Source maps generated (if applicable)
### Warnings
- [List any build warnings]
### Errors (if failed)
- [Parse and list specific errors]
- [Suggested fixes for each]
If build fails, suggest:
Copy to your project:
cp templates/subagents/validate-build.md .claude/commands/
Invoke with: /project:validate-build