# AGENTS.md

Carbon Language's main repository: documents, design, implementation, and related tools. (NOTE: Carbon Language is experimental; see README)

## Setup

```
# TODO: the install command. No lockfile was found, so this could not be inferred.
```

## Commands

```
ruff check .   # lint
```

## Layout

- `toolchain/` 588 source files
- `common/`    101 source files
- `scripts/`   26 source files
- `testing/`   26 source files
- `utils/`     10 source files
- `proposals/` 9 source files

## Conventions

- Tests live alongside the code they cover, following `bazel/cc_toolchains/cc_tools_test.py`.
- CI defines what passing means. See `.github/workflows/auto_label_prs.yaml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `toolchain/check/import_ref.cpp` is 210KB. It will not fit comfortably in context, so read it in parts.
- No lockfile is committed, so an install here may not match what CI produced.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.