diff --git a/README.md b/README.md
index 0d5a98c..1c8d394 100644
--- a/README.md
+++ b/README.md
@@ -2,16 +2,49 @@
 
 This is my monorepo, started in 2026.
 
-## Monorepo Structure
-```
-dev/                Monorepo root
-├── .archive/       Archived projects
-├── configs/        Declarative configuration
-│   └── nixos/      NixOS hosts, modules, guests, registry, and secrets
-├── docs/           Obsidian vault / Second brain
-├── src/            Projects
-│   └── tools/      Projects that are tools
-└── third_party/    Open source tools, libraries or otherwise
+## Monorepo structure
+
+```text
+dev/                    Monorepo root
+├── bazel/               Bazel support files
+├── configs/             Declarative configuration
+│   └── nixos/           NixOS hosts, modules, guests, registry, and secrets
+├── docs/                Repository documentation
+├── src/                 Projects
+│   ├── dotfiles/        Home and system configuration
+│   └── machoke/         Rust application
+├── third_party/         External source and vendoring support
+│   └── crates/          Generated Rust crate sources and Bazel targets
+├── Cargo.lock           Shared Rust dependency lockfile
+├── Cargo.toml           Rust workspace manifest
+└── MODULE.bazel         Bazel module definition
 ```
 
+## Rust dependencies
+
+The repository root contains one Cargo dependency graph.
+Each Rust project declares its dependencies in its local `Cargo.toml` file.
+Add each Rust project to the `members` list in the root `Cargo.toml` file.
+Use explicit member paths because the Bazel generator does not expand workspace globs.
+
+Update the shared lockfile after changing a project manifest:
+
+```sh
+cargo generate-lockfile
+```
+
+Regenerate local crate sources and Bazel targets:
+
+```sh
+bazel run //third_party:vendor_crates
+```
+
+Reference each dependency with an explicit local Bazel label:
+
+```starlark
+deps = ["//third_party/crates:crate_name"]
+```
+
+Commit the generated files under `third_party/crates/`.
+Do not edit generated files manually.