| commit | 6719bb73c1bddd9e12df8e44cc7c6a56c23f9ac3 | [log] [tgz] |
|---|---|---|
| author | Aaron leventhal <[email protected]> | Wed Aug 06 23:36:53 2025 |
| committer | Chromium LUCI CQ <[email protected]> | Wed Aug 06 23:36:53 2025 |
| tree | 19cc72a623ff76ce4a9636b9cb305bf05a30fe04 | |
| parent | 902cf7babd22ac385424dfe362aa55ebeb487856 [diff] |
docs: Create foundational knowledge base for developers and agents This commit introduces a new set of documentation and tooling to improve the developer experience for both humans and AI agents working in the Chromium codebase. The core of this change is a new, structured knowledge base designed to improve the effectiveness of the agent's built-in Retrieval-Augmented Generation (RAG). This includes: - A new `agents/prompts/knowledge_base.md` file that provides high-level,task-oriented guidance for core Chromium concepts like the build system, dependency management, and Mojo IPC. - A suite of imported, canonical documentation from external sources (like the GN repository) cached in `docs/imported/`. This provides a stable, in-tree reference for foundational tools. Currently only the gn style guide is provided there. Eventually this should go away if web_fetch becomes widely available to agentic coders in Chromium, as the agent could fetch Docs on demand from https://gn.googlesource.com/gn/+/refs/heads/main/docs/. - New high-level overview documents for `//tools`, `//docs/debugging.md`, and the source tree layout to improve discoverability. These changes are linked in the agent's core `common.md` prompt, making the new knowledge base directly accessible to AI assistants. This structured approach enables both humans and agents to more efficiently find relevant information, tools, and architectural patterns. Need to use "No-Presubmit: true" any time we update the docs (we added a presubmit.py rule to prevent hand-editing of the imported docs). Bug: 435509437 No-Presubmit: true Change-Id: I932eda79f2108bb29b2bf3061de0de3bfe6053aa Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/6808155 Reviewed-by: Erik Chen <[email protected]> Commit-Queue: Aaron Leventhal <[email protected]> Auto-Submit: Aaron Leventhal <[email protected]> Reviewed-by: Jesse McKenna <[email protected]> Cr-Commit-Position: refs/heads/main@{#1497923}
ChromiumChromium is an open-source browser project that aims to build a safer, faster, and more stable way for all users to experience the web.
The project's web site is https://www.chromium.org.
To check out the source code locally, don't use git clone! Instead, follow the instructions on how to get the code.
Documentation in the source is rooted in docs/README.md.
Learn how to Get Around the Chromium Source Code Directory Structure.
For historical reasons, there are some small top level directories. Now the guidance is that new top level directories are for product (e.g. Chrome, Android WebView, Ash). Even if these products have multiple executables, the code should be in subdirectories of the product.
If you found a bug, please file it at https://crbug.com/new.