mirror of https://github.com/carbon-language/carbon-lang.git synced 2026-09-24 21:40:12 +01:00

Files

T

Chandler Carruth 327cb2396a Add a Bazel skill (#7061 )

Hopefully this significantly reduces how often agents try to run `bazel`
directly without repeatedly including that in prompts. Also tried to
generally give useful skills for building, testing, and running things.

Also added a specific admonition to the `AGENTS.md` as there is a chance
that agents don't think they need to look at any skills for "standard"
build system commands like `bazel`, as those are "trivial". It seems
like a small chunk of context to spend to avoid churning with bad build
commands.

Assisted-by: Antigravity with Gemini

2026-04-16 18:58:34 +00:00

2.0 KiB

Raw Blame History

Gemini & AI assistant guide for Carbon

This document provides high-density technical context for AI assistants (and humans!) contributing to the Carbon Language project. If you are an AI assistant, read this first to avoid common pitfalls.

General instructions
Project structure
Bazel usage
Toolchain development

General instructions

Communication: Be concise, professional, and technical. Use GitHub-style markdown.
Verification: Always run relevant tests.
Tool usage: Use web search for any research outside the immediate codebase or KIs.

Project structure

common/: Common C++ utilities used across the project.
core/: The Carbon standard library (Core).
docs/: Project documentation, design, and style guides.
examples/: Example Carbon programs and code snippets.
proposals/: Evolution proposals.
testing/: Testing utilities and infrastructure.
toolchain/: The C++ implementation of the compiler (Toolchain).

Tool usage

See the "Tool usage" skill for instructions on what tools to use in the carbon-lang project.

Bazel usage

[!IMPORTANT] Always use bazelisk instead of bazel for all commands in the Carbon project. Refer to the Bazel usage skill for detailed instructions.

Code style

See the "Code style" skill for instructions on formatting, style guides, and code conventions to follow.

Toolchain development

See the "Toolchain Development" skill for instructions on architecture, building, testing, debugging, C++ patterns, and common pitfalls.

2.0 KiB Raw Blame History