Repository navigation
AGENTS.md: Repository Structure section predates the move into crates/ #8416
Description
Summary
The "Repository Structure" section of AGENTS.md still describes the pre-crates/ layout, so every path in it is wrong. CONTRIBUTING.md § "Code organization" already describes the current layout, and the two documents now contradict each other.
Details
AGENTS.md L16-L31:
AGENTS.md says |
actual |
|---|---|
vm/ |
crates/vm/ |
compiler/ |
crates/compiler/ |
compiler/parser/ |
gone. Parsing is ruff_python_parser |
compiler/core/ |
crates/compiler-core/ |
compiler/codegen/ |
crates/codegen/ (a sibling crate, not a subdirectory) |
derive/ |
crates/derive/ (plus crates/derive-impl/) |
common/ |
crates/common/ |
stdlib/ |
crates/stdlib/ |
jit/ |
crates/jit/ |
pylib/ |
crates/pylib/ |
wasm/ |
still exists, but now holds demo/, notebook/, tests/, example/. The crate moved to crates/wasm/ |
Not listed at all: crates/capi, crates/host_env, crates/literal, crates/unicode, crates/wtf8, crates/sre_engine, crates/doc, crates/venvlauncher, crates/compiler-source.
Also minor, in the same file:
Line 3 in 04c3ecf
AGENTS.md and is read by several agents.
Possible fixes
- Rewrite the section to match the current tree.
- Drop the section and point at
CONTRIBUTING.md§ "Code organization" instead, so there is only one copy to keep current.
Related to #8356, which covers the broken DEVELOPMENT.md links in this same file. That is a separate problem from the structure list.
Drafted with AI assistance (Claude Code) and reviewed by me before posting.
Activity
leehanjeong commentedon Jul 30, 2026
take