Add concise code pointers to docs for LLM navigation

Co-authored-by: max-lt <9805205+max-lt@users.noreply.github.com>

Author: Copilot

docs/architecture.md

@@ -30,11 +30,16 @@ platform.rs                 ← V8 Platform (singleton, once per process)
 
 ## Execution Modes
 
-| Mode              | API                | Performance    | Use Case             |
-| ----------------- | ------------------ | -------------- | -------------------- |
-| **Legacy**        | `Worker::new()`    | Slow (~ms/req) | Max isolation, tests |
-| **Shared Pool**   | `execute_pooled()` | Fast (~µs/req) | Multi-thread         |
-| **Thread-Pinned** | `execute_pinned()` | Fastest        | **Production**       |
+| Mode              | API                | Performance    | Use Case                 |
+| ----------------- | ------------------ | -------------- | ------------------------ |
+| **Legacy**        | `Worker::new()`    | Slow (~ms/req) | Max isolation, tests     |
+| **Shared Pool**   | `execute_pooled()` | Fast (~µs/req) | Multi-thread, production |
+| **Thread-Pinned** | `execute_pinned()` | Fastest        | Multi-tenant, no lock    |
+
+**Code pointers:**
+- `execute_pooled()` → `pooled_execution.rs` (uses `isolate_pool.rs`)
+- `execute_pinned()` → `thread_pinned_pool.rs`
+- `Worker` → `worker.rs`
 
 See [execution_modes.md](./execution_modes.md) for details.
 

docs/execution_modes.md

@@ -131,3 +131,12 @@ Legacy code using SharedIsolate? → Keep it (but migrate)
 | Thread-Pinned | `Mutex` (local)        | Zero cross-thread     |
 
 V8 isolates are **not thread-safe**. `v8::Locker` provides mutual exclusion at the V8 level—required for any cross-thread sharing.
+
+## Code Pointers
+
+| Mode          | Entry point          | Implementation               |
+| ------------- | -------------------- | ---------------------------- |
+| Worker        | `Worker::new()`      | `worker.rs`                  |
+| IsolatePool   | `execute_pooled()`   | `pooled_execution.rs` → `isolate_pool.rs` |
+| Thread-Pinned | `execute_pinned()`   | `thread_pinned_pool.rs`      |
+| SharedIsolate | `ExecutionContext::new()` | `execution_context.rs` + `shared_isolate.rs` |

docs/isolate_pool.md

@@ -183,3 +183,12 @@ Rust compiler prevents:
 - Sending Locker to another thread
 - Using isolate without Locker
 - Locker outliving its scope
+
+## Code Pointers
+
+| Component            | File                        | Key functions                     |
+| -------------------- | --------------------------- | --------------------------------- |
+| Pool singleton       | `isolate_pool.rs`           | `init_pool()`, `get_pool()`       |
+| Pool entry point     | `pooled_execution.rs`       | `execute_pooled()`                |
+| Isolate wrapper      | `locker_managed_isolate.rs` | `LockerManagedIsolate::new()`     |
+| Execution context    | `execution_context.rs`      | `new_with_pooled_isolate()`       |

docs/streams.md

@@ -149,3 +149,11 @@ while (true) {
 - `Bytes` uses reference counting (zero-copy)
 - Receivers removed during `read_chunk()` to prevent deadlock
 - Auto-cleanup on `Done` or `Error`
+
+## Code Pointers
+
+| Component      | File                        | Key functions                          |
+| -------------- | --------------------------- | -------------------------------------- |
+| StreamManager  | `runtime/stream_manager.rs` | `create_stream()`, `write_chunk()`, `read_chunk()` |
+| JS bindings    | `runtime/bindings/streams.rs` | `__nativeStreamRead()`               |
+| Scheduler      | `runtime/scheduler.rs`      | `SchedulerMessage::StreamRead`         |