Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/validate-build.md
Open on GitHub

What 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.md

Call it with /validate-build. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Testing and QA →

From the same set46

The whole set →

Project sponsors

Companies that keep this analytics open