mirror of https://github.com/carbon-language/carbon-lang.git synced 2026-09-24 19:50:14 +01:00

Files

T

Jon Ross-Perkins 6b2d55d289 Adjust tool usage notes (#6853 )

Trying to work on some behaviors:

- Using `black` to format Python files (using `pre-commit` makes better
use of allow-listed commands)
- Writing Python code over 80 columns (adding more style notes)
- Running `bazel` (being more emphatic about `bazelisk`, splitting tool
usage out to its own skill to try making clear it's not
toolchain-specific)

Assisted-by: Google Antigravity with Gemini

2026-03-09 14:56:41 +00:00

1.8 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
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.

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.

1.8 KiB Raw Blame History