carbon-language/carbon-lang

builtin-functions

Instructions for registering, mapping, constant evaluating, and lowering builtin functions in the Carbon toolchain.

diagnostics

Instructions for declaring, formatting, emitting, testing, and styling diagnostic messages (errors, warnings, notes) in the Carbon toolchain.

agent-tools

Guidelines and restrictions on shell commands and file manipulation tools for AI assistants.

bazel-usage

Instructions that **MUST** be followed when using Bazel or Bazelisk to build, test, and debug in the Carbon repository.

jujutsu-jj-usage

Instructions for using Jujutsu (jj) for version control in the Carbon repository.

prek

Instructions for running prek, the Carbon pre-submit/style/lint checker, that *MUST* be run before submitting an change.

toolchain-tests

Instructions for authoring, structuring, and running toolchain tests using the file_test infrastructure.

toolchain-development

Instructions for checking, building, debugging, and understanding the Carbon toolchain.

summarize-testdata-changes

Instructions for summarizing changes to Carbon testdata files (`toolchain/*/testdata`).

proposals

Instructions for writing, submitting, and managing Carbon evolution proposals.

github-cli-usage

Instructions for using the `gh` command to query and inspect GitHub state safely.

accessing-github-issues

Instructions for safely viewing and accessing GitHub issues by way of command line.

code-style

Instructions for code formatting and style guidelines in the Carbon toolchain.