AGENTS.md

1# Gemini & AI Assistant Guide for Carbon
2 
3<!--
4Part of the Carbon Language project, under the Apache License v2.0 with LLVM
5Exceptions. See /LICENSE for license information.
6SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7-->
8 
9This document provides high-density technical context for AI assistants
10contributing to the Carbon Language project.
11 
12## General instructions
13 
14-   **Communication**: Be concise, professional, and technical. Use GitHub-style
15    markdown.
16-   **Verification**: Always run relevant tests.
17 
18## Project structure
19 
20-   **[`common/`](common/)**: Common C++ utilities used across the project.
21-   **[`core/`](core/)**: The Carbon standard library (Core).
22-   **[`docs/`](docs/)**: Project documentation, design, and style guides.
23-   **[`examples/`](examples/)**: Example Carbon programs and code snippets.
24-   **[`proposals/`](proposals/)**: Evolution proposals.
25-   **[`testing/`](testing/)**: Testing utilities and infrastructure.
26-   **[`toolchain/`](toolchain/)**: The C++ implementation of the compiler
27    (Toolchain).
28 
29## Bazel usage
30 
31> [!IMPORTANT] Always use `bazelisk` instead of `bazel` for all commands in the
32> Carbon project. Refer to the
33> [Bazel usage skill](/.agents/skills/bazel/SKILL.md) for detailed instructions.
34