validate-build — Claude Code command: build checks
The validate-build command detects a project’s build system and runs checks for Node.js, Python, Go, or Rust. Use it after changes and before committing.
MIT ★ 1,424 updated 2026-10-06
.claude/commands/validate-build.mdWhat validate-build does
The command looks for project configuration files, then picks a check for the detected ecosystem. For Node.js, it tries npm, yarn, pnpm, and bun; for Python, it compiles files or performs a package installation dry run. Go and Rust projects use go build ./... and cargo build.
It checks build artifacts and parses warnings and errors. The report includes the command run, its exit code, findings, and suggested fixes. For Node.js, it looks for dist/ or build/, so a project that writes output elsewhere may fail that artifact check.
In Claude Code, place the command file at .claude/commands/validate-build.md. Run it before committing to catch build failures.
What it helps with
- check whether changes still compile
- compile Python files and catch syntax errors
- identify warnings and build failures
- verify that expected build artifacts exist
Example prompts for the agent
- Check the project build before I commit.
- Run the build check and list errors with their file and line locations.
- Check the build artifacts and report warnings after these changes.
How to install validate-build
Manually: put the files in place
.claude/commands/validate-build.mdCall it with /validate-build. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/validate-build.mdCall it with /prompts:validate-build. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/validate-build.prompt.mdManually: put the files in place
.gemini/commands/validate-build.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about validate-build
How do I install validate-build in Claude Code?
Place the command file at .claude/commands/validate-build.md.
What does validate-build do?
It detects the project’s build system, runs a matching check, and reports errors, warnings, and build artifacts.
Which build systems does validate-build check?
It runs checks for Node.js/TypeScript, Python, Go, and Rust. For Node.js, it tries npm, yarn, pnpm, and bun build commands.
Source text
validate-build.md · MIT
---
description: Validates project build process. Run after changes to ensure the project compiles/transpiles correctly.
---
# Validate Build
Validate that the project builds successfully. Run BEFORE commits to catch build failures early.
## Phase 1: Detect Build System
Identify the project's build system:
```bash
# Check for common build configurations
ls package.json Makefile setup.py pyproject.toml go.mod Cargo.toml CMakeLists.txt 2>/dev/null
```
## Phase 2: Run Build Commands
Based on detected system:
### Node.js/TypeScript
```bash
npm run build 2>&1 || yarn build 2>&1 || pnpm build 2>&1 || bun run build 2>&1
```
### Python
```bash
find . -name "*.py" -exec python -m py_compile {} +
# or for packages:
pip install -e . --dry-run
```
### Go
```bash
go build ./...
```
### Rust
```bash
cargo build
```
## Phase 3: Verify Build Artifacts
Check that expected outputs exist:
- `dist/` or `build/` directory for JS/TS
- Compiled binaries for Go/Rust
- No missing dependencies
```bash
# Example for Node.js
ls -la dist/ build/ 2>/dev/null
```
## Phase 4: Check for Warnings
Parse build output for:
- Deprecation warnings
- Unused variables/imports
- Performance warnings
- Type coercion warnings
## Output Format
```
## 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]
```
## Auto-Fix Suggestions
If build fails, suggest:
1. Missing dependency installation commands
2. Type errors with file:line locations
3. Syntax errors with context
4. Configuration issues
## Usage
This command ships with the project-starter plugin. Invoke with: `/project-starter:validate-build`
© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2