Build Compile Agent

Orchestrate Rust build operations with proper error handling, optimization, and workspace management. Use this agent when compiling the self-learning memory project or troubleshooting build errors in CI/CD pipelines.

Core Capabilities

Build Operations

Compile Rust workspaces with appropriate optimization levels
Handle build errors with systematic debugging
Manage cross-compilation and platform-specific targets
Parallel build optimization for CI/CD

Error Diagnosis

Parse compiler error messages
Identify dependency conflicts
Resolve feature flag issues
Detect memory/timeout constraints

Quality Assurance

Run clippy for lint checks
Execute test suite compilation
Verify release build integrity
Validate stripped binary sizes

Build Modes

Mode	Use Case	Performance	Size	Flags
`dev`	Development iteration	Fast	Large	`--workspace`
`release`	Production deployment	Optimized	Medium	`--release --workspace`
`profile`	Performance analysis	Medium	Medium	`--release --timings`
`check`	Fast validation	Fastest	N/A	`--workspace` (type-check only)
`clean`	Artifact cleanup	N/A	N/A	`--clean`

CLI Integration

For human operators, see the build-rust CLI documentation:

bash

# Quick development iteration
./scripts/build-rust.sh dev

# Production build
./scripts/build-rust.sh release

# Performance profiling
./scripts/build-rust.sh profile

# Fast type-check
./scripts/build-rust.sh check

# Clean artifacts
./scripts/build-rust.sh clean

Error Handling Patterns

Timeout Errors

Symptom: Build exceeds time limits
Diagnosis: Check
```
CARGO_BUILD_JOBS
```
parallelism
Solution: Reduce concurrency:
```
CARGO_BUILD_JOBS=4 cargo build
```
Alternative: Use
```
check
```
mode for faster feedback

Memory Errors

Symptom: OOM during link phase
Diagnosis: Monitor with
```
/usr/bin/time -v cargo build
```
Solution:
```
cargo build -j 1
```
(sequential)
Fallback: Use
```
check
```
mode (no codegen)

Dependency Conflicts

Symptom: Feature flag conflicts
Diagnosis:
```
cargo tree -e features
```
Solution:
```
cargo update
```
for compatible versions
Manual: Edit
```
Cargo.toml
```
feature resolution

Platform-Specific

Symptom: Missing target triple
Diagnosis: Check
```
rustc --print target-list
```
Solution:
```
rustup target add <triple>
```
Conditional:
```
#[cfg(target_os = "linux")]
```

CI/CD Optimization

Caching Strategy

yaml

- name: Cache cargo registry
  uses: actions/cache@v3
  with:
    path: ~/.cargo/registry
    key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}

Parallel Jobs

bash

# Default: Number of CPU cores
export CARGO_BUILD_JOBS=4

# Measure optimal concurrency
hyperfine -N 'cargo build -j 1' 'cargo build -j 2' 'cargo build -j 4'

Artifact Management

bash

# Save compiled dependencies
cargo build --release

# Strip debug symbols (80% size reduction)
strip target/release/memory-mcp

# Verify binary
ldd target/release/memory-mcp
./target/release/memory-mcp --version

Verification Checklist

Build completes without errors
No clippy warnings (
```
cargo clippy -- -D warnings
```
)
Tests compile (
```
cargo test --no-run
```
)
Binary size acceptable (< 10MB stripped)
Startup time < 100ms
No memory leaks (valgrind/check)
Cross-platform targets build successfully

Common Workflows

Full CI Pipeline

bash

#!/usr/bin/env bash
set -euxo pipefail
./scripts/code-quality.sh fmt
./scripts/code-quality.sh clippy --workspace
cargo build --release --workspace
cargo test --all
cargo doc --no-deps

Quick Development Cycle

bash

#!/usr/bin/env bash
cargo check -p memory-core
cargo test -p memory-core --lib
cargo build -p memory-core

Production Release

bash

#!/usr/bin/env bash
cargo build --release --workspace
strip target/release/memory-*
upx --best --lzma target/release/memory-*
sha256sum target/release/memory-* > SHA256SUMS

Troubleshooting

Issue: Incremental compilation cache corruption Fix:

cargo clean && cargo build

Issue: Stale lock file Fix:

rm Cargo.lock && cargo generate-lockfile

Issue: Rust version mismatch Fix:

rustup update stable && rustup default stable

**Issue: Cross-compilation failures Fix: Install toolchain:

rustup target add x86_64-unknown-linux-musl

Related Skills

code-quality: Lint and format checks before builds
test-runner: Execute tests after successful compilation
debug-troubleshoot: Diagnose runtime issues post-build
github-workflows: CI/CD pipeline integration

build-compile

NPX Install

Tags

SKILL.md Content

Build Compile Agent

Core Capabilities

Build Modes

CLI Integration

Error Handling Patterns

CI/CD Optimization

Verification Checklist

Common Workflows

Troubleshooting

Related Skills