# Nativelink Bazel Verification

> Nativelink Bazel Verification is an Agent Skill for testing & quality published in the TraceMachina/nativelink repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when verifying NativeLink changes with Bazel, selecting focused test targets, debugging rustfmt/clippy aspect failures, or preparing a confidence report for Rust/Bazel changes.

- Skill name: `nativelink-bazel-verification`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/TraceMachina/nativelink/blob/HEAD/.claude/skills/nativelink-bazel-verification/SKILL.md
- Repository: TraceMachina/nativelink (1,560 GitHub stars when collected)

## SKILL.md

# NativeLink Bazel Verification

Use this skill when a NativeLink change needs a focused Bazel build/test plan, when CI reports a Bazel failure, or when you need to decide how much verification is enough.

## Start With Scope

1. Inspect the touched files and nearby `BUILD.bazel` files.
2. Map changed Rust files to their crate package:
   - `nativelink-store/` for storage backends, CAS/AC, compression, Redis/S3/GCS/filesystem/memory stores.
   - `nativelink-scheduler/` for action scheduling and worker matching.
   - `nativelink-worker/` for local worker execution and action lifecycle.
   - `nativelink-service/` for REAPI, bytestream, BEP, and worker API services.
   - `nativelink-config/` for JSON5 configuration structs and examples.
   - `nativelink-util/` for shared helpers.
   - `nativelink-proto/` for protobuf-generated surfaces.
3. Prefer focused package tests first, then broaden only when the touched surface is shared.

## Common Commands

Use the repository's Bazel defaults unless the user asked for a specific Bazel version.

```bash
bazel build //:nativelink
bazel build //...
bazel test //...
bazel test //nativelink-store:memory_store_test
bazel run --config=rustfmt @rules_rust//:rustfmt
```

For this workspace, when the user requests Bazelisk 9.0.2:

```bash
USE_BAZEL_VERSION=9.0.2 bazelisk --output_user_root=/tmp/bazelisk-9.0.2 --batch build //:nativelink
USE_BAZEL_VERSION=9.0.2 bazelisk --output_user_root=/tmp/bazelisk-9.0.2 --batch test //...
```

## Failure Handling

- If `rustfmt` fails, run:

```bash
bazel run --config=rustfmt @rules_rust//:rustfmt
```

- If `clippy` fails, fix the code. Don't silence lints unless the suppression is local, justified, and consistent with existing code.
- If a test fails under a broad target like `//...`, rerun the specific failing target with output enabled before editing.
- If Bazel can't find a target, inspect `BUILD.bazel` rather than guessing labels.

## Verification Ladder

Use the smallest rung that proves the change:

1. Single package test for narrow implementation changes.
2. `bazel build //:nativelink` for server-path changes.
3. Package-wide tests for crate-level behavior.
4. `bazel test //...` for shared crates, proto/config surfaces, toolchain changes, or release confidence.

## Final Report

Always report:

- The exact commands run.
- Whether each command passed or failed.
- Any known unverified area.
- Any pre-existing dirty files that weren't part of the task.

---

Source: https://www.openparable.com/skill/testing-quality/nativelink-bazel-verification (OpenParable). Cite the canonical URL above.
