diff --git a/README.md b/README.md
index 99d51ad49..d919f1e72 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,14 @@ Key variables for development:
 | `SOCKET_CLI_API_BASE_URL` | Override API endpoint |
 | `SOCKET_CLI_NO_API_TOKEN` | Disable default API token |
 
+## Further Reading
+
+- [`docs/build-guide.md`](docs/build-guide.md) — build pipeline, SEA binaries, cache management
+- [`docs/bundle-tools.md`](docs/bundle-tools.md) — how bundled tools (opengrep, trivy, etc.) are integrated
+- [`packages/cli/README.md`](packages/cli/README.md) — CLI package architecture
+- [`packages/build-infra/README.md`](packages/build-infra/README.md) — shared build tooling
+- [`packages/package-builder/README.md`](packages/package-builder/README.md) — template-based package generation
+
 ## See Also
 
 - [Socket API Reference](https://docs.socket.dev/reference)
diff --git a/docs/build-guide.md b/docs/build-guide.md
index 0c083a1da..3fef8abec 100644
--- a/docs/build-guide.md
+++ b/docs/build-guide.md
@@ -252,13 +252,13 @@ Assets are downloaded from [socket-btm](https://github.com/SocketDev/socket-btm)
 
 ```bash
 # Clear download cache
-pnpm run clean-cache
+pnpm run clean:cache
 
 # Clear CLI build cache
 pnpm --filter @socketsecurity/cli run clean
 
 # Clear all caches
-pnpm clean
+pnpm run clean
 ```
 
 ### Environment Variables