bazel-build-optimization

Bazel Build Optimization

Production patterns for Bazel in large-scale monorepos.

Do not use this skill when

• The task is unrelated to bazel build optimization
• You need a different domain or tool outside this scope

Instructions

• Clarify goals, constraints, and required inputs.
• Apply relevant best practices and validate outcomes.
• Provide actionable steps and verification.
• If detailed examples are required, open resources/implementation-playbook.md.

Use this skill when

• Setting up Bazel for monorepos
• Configuring remote caching/execution
• Optimizing build times
• Writing custom Bazel rules
• Debugging build issues
• Migrating to Bazel

Core Concepts

1. Bazel Architecture

workspace/
├── WORKSPACE.bazel       # External dependencies
├── .bazelrc              # Build configurations
├── .bazelversion         # Bazel version
├── BUILD.bazel           # Root build file
├── apps/
│   └── web/
│       └── BUILD.bazel
├── libs/
│   └── utils/
│       └── BUILD.bazel
└── tools/
    └── bazel/
        └── rules/

2. Key Concepts

Concept	Description
Target	Buildable unit (library, binary, test)
Package	Directory with BUILD file
Label	Target identifier //path/to:target
Rule	Defines how to build a target
Aspect	Cross-cutting build behavior

Templates

##