diff --git a/CLAUDE.md b/CLAUDE.md
index f393432..5ae657b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -13,7 +13,7 @@ Vectorless is a Document Understanding Engine for AI written in Rust.
 Cargo workspace with 17 fine-grained Rust crates + pure Python SDK:
 
 ```
-vectorless-core/
+crates/
 ├── vectorless-error/       # Error types (Result, Error enum)
 ├── vectorless-document/    # Document types (Document, Tree, NavigationIndex, ReasoningIndex)
 ├── vectorless-config/      # Configuration hub (aggregates all config types)
@@ -25,7 +25,7 @@ vectorless-core/
 ├── vectorless-llm/         # LLM client (pool, memo/cache, throttle, fallback)
 ├── vectorless-storage/     # Persistence (Workspace, LRU cache, file/memory backends)
 ├── vectorless-query/       # Query understanding (intent classification, rewrite)
-├── vectorless-index/       # Compile pipeline (10-stage, checkpointing, incremental update)
+├── vectorless-compiler/    # Compile pipeline (15-pass, checkpointing, incremental update)
 ├── vectorless-agent/       # Retrieval execution (Worker navigation + Orchestrator fusion)
 ├── vectorless-retrieval/   # Retrieval dispatch layer (dispatcher, cache, streaming)
 ├── vectorless-rerank/      # Result reranking (dedup, BM25 scoring, fusion)
@@ -44,7 +44,7 @@ Layer 0:  error · document · utils · scoring          (no workspace deps)
 Layer 1:  graph · events · config · metrics            (depends on Layer 0)
 Layer 2:  llm · storage                                 (depends on Layer 0–1)
 Layer 3:  query                                         (depends on Layer 0–2)
-Layer 4:  index · agent                                 (depends on Layer 0–3)
+Layer 4:  compiler · agent                               (depends on Layer 0–3)
 Layer 5:  retrieval · rerank                            (depends on Layer 0–4)
 Layer 6:  engine (facade) · vectorless-py (bindings)    (depends on all)
 ```
@@ -170,9 +170,9 @@ When uncertain whether an operation is safe, **default to asking user confirmati
 
 ## Common Development Workflow
 
-1. **Adding features**: Implement in the appropriate `vectorless-core/vectorless-*/` crate, add tests
+1. **Adding features**: Implement in the appropriate `crates/vectorless-*/` crate, add tests
 2. **Fixing bugs**: Add failing test case first, fix and ensure tests pass
-3. **Adding crates**: New modules get their own crate under `vectorless-core/`, add to workspace Cargo.toml
-4. **Python bindings**: Update `vectorless-core/vectorless-py/src/lib.rs` (PyO3) when Rust APIs change
+3. **Adding crates**: New modules get their own crate under `crates/`, add to workspace Cargo.toml
+4. **Python bindings**: Update `crates/vectorless-py/src/lib.rs` (PyO3) when Rust APIs change
 5. **Python SDK**: Update `vectorless/` when API surface changes
 6. **Committing code**: Use semantic commit messages, format: `type(scope): description`
diff --git a/Cargo.toml b/Cargo.toml
index b895873..026c7b8 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,24 +1,19 @@
 [workspace]
 members = [
-    "vectorless-core/vectorless-error",
-    "vectorless-core/vectorless-document",
-    "vectorless-core/vectorless-config",
-    "vectorless-core/vectorless-utils",
-    "vectorless-core/vectorless-scoring",
-    "vectorless-core/vectorless-graph",
-    "vectorless-core/vectorless-events",
-    "vectorless-core/vectorless-metrics",
-    "vectorless-core/vectorless-llm",
-    "vectorless-core/vectorless-storage",
-    # Strategy layer moved to Python — crates kept but not compiled:
-    # "vectorless-core/vectorless-query",
-    # "vectorless-core/vectorless-agent",
-    # "vectorless-core/vectorless-retrieval",
-    # "vectorless-core/vectorless-rerank",
-    "vectorless-core/vectorless-compiler",
-    "vectorless-core/vectorless-primitives",
-    "vectorless-core/vectorless-engine",
-    "vectorless-core/vectorless-py",
+    "crates/vectorless-error",
+    "crates/vectorless-document",
+    "crates/vectorless-config",
+    "crates/vectorless-utils",
+    "crates/vectorless-scoring",
+    "crates/vectorless-graph",
+    "crates/vectorless-events",
+    "crates/vectorless-metrics",
+    "crates/vectorless-llm",
+    "crates/vectorless-storage",
+    "crates/vectorless-compiler",
+    "crates/vectorless-primitives",
+    "crates/vectorless-engine",
+    "crates/vectorless-py",
 ]
 resolver = "2"
 
diff --git a/vectorless-core/vectorless-compiler/Cargo.toml b/crates/vectorless-compiler/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-compiler/Cargo.toml
rename to crates/vectorless-compiler/Cargo.toml
diff --git a/vectorless-core/vectorless-compiler/src/config.rs b/crates/vectorless-compiler/src/config.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/config.rs
rename to crates/vectorless-compiler/src/config.rs
diff --git a/vectorless-core/vectorless-compiler/src/incremental/detector.rs b/crates/vectorless-compiler/src/incremental/detector.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/incremental/detector.rs
rename to crates/vectorless-compiler/src/incremental/detector.rs
diff --git a/vectorless-core/vectorless-compiler/src/incremental/mod.rs b/crates/vectorless-compiler/src/incremental/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/incremental/mod.rs
rename to crates/vectorless-compiler/src/incremental/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/incremental/resolver.rs b/crates/vectorless-compiler/src/incremental/resolver.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/incremental/resolver.rs
rename to crates/vectorless-compiler/src/incremental/resolver.rs
diff --git a/vectorless-core/vectorless-compiler/src/incremental/updater.rs b/crates/vectorless-compiler/src/incremental/updater.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/incremental/updater.rs
rename to crates/vectorless-compiler/src/incremental/updater.rs
diff --git a/vectorless-core/vectorless-compiler/src/lib.rs b/crates/vectorless-compiler/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/lib.rs
rename to crates/vectorless-compiler/src/lib.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/markdown/config.rs b/crates/vectorless-compiler/src/parse/markdown/config.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/markdown/config.rs
rename to crates/vectorless-compiler/src/parse/markdown/config.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/markdown/frontmatter.rs b/crates/vectorless-compiler/src/parse/markdown/frontmatter.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/markdown/frontmatter.rs
rename to crates/vectorless-compiler/src/parse/markdown/frontmatter.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/markdown/mod.rs b/crates/vectorless-compiler/src/parse/markdown/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/markdown/mod.rs
rename to crates/vectorless-compiler/src/parse/markdown/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/markdown/parser.rs b/crates/vectorless-compiler/src/parse/markdown/parser.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/markdown/parser.rs
rename to crates/vectorless-compiler/src/parse/markdown/parser.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/mod.rs b/crates/vectorless-compiler/src/parse/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/mod.rs
rename to crates/vectorless-compiler/src/parse/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/pdf/mod.rs b/crates/vectorless-compiler/src/parse/pdf/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/pdf/mod.rs
rename to crates/vectorless-compiler/src/parse/pdf/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/pdf/parser.rs b/crates/vectorless-compiler/src/parse/pdf/parser.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/pdf/parser.rs
rename to crates/vectorless-compiler/src/parse/pdf/parser.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/pdf/types.rs b/crates/vectorless-compiler/src/parse/pdf/types.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/pdf/types.rs
rename to crates/vectorless-compiler/src/parse/pdf/types.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/assigner.rs b/crates/vectorless-compiler/src/parse/toc/assigner.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/assigner.rs
rename to crates/vectorless-compiler/src/parse/toc/assigner.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/detector.rs b/crates/vectorless-compiler/src/parse/toc/detector.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/detector.rs
rename to crates/vectorless-compiler/src/parse/toc/detector.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/mod.rs b/crates/vectorless-compiler/src/parse/toc/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/mod.rs
rename to crates/vectorless-compiler/src/parse/toc/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/parser.rs b/crates/vectorless-compiler/src/parse/toc/parser.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/parser.rs
rename to crates/vectorless-compiler/src/parse/toc/parser.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/processor.rs b/crates/vectorless-compiler/src/parse/toc/processor.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/processor.rs
rename to crates/vectorless-compiler/src/parse/toc/processor.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/repairer.rs b/crates/vectorless-compiler/src/parse/toc/repairer.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/repairer.rs
rename to crates/vectorless-compiler/src/parse/toc/repairer.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/structure_extractor.rs b/crates/vectorless-compiler/src/parse/toc/structure_extractor.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/structure_extractor.rs
rename to crates/vectorless-compiler/src/parse/toc/structure_extractor.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/types.rs b/crates/vectorless-compiler/src/parse/toc/types.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/types.rs
rename to crates/vectorless-compiler/src/parse/toc/types.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/toc/verifier.rs b/crates/vectorless-compiler/src/parse/toc/verifier.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/toc/verifier.rs
rename to crates/vectorless-compiler/src/parse/toc/verifier.rs
diff --git a/vectorless-core/vectorless-compiler/src/parse/types.rs b/crates/vectorless-compiler/src/parse/types.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/parse/types.rs
rename to crates/vectorless-compiler/src/parse/types.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/analysis/enhance.rs b/crates/vectorless-compiler/src/passes/analysis/enhance.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/analysis/enhance.rs
rename to crates/vectorless-compiler/src/passes/analysis/enhance.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/analysis/mod.rs b/crates/vectorless-compiler/src/passes/analysis/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/analysis/mod.rs
rename to crates/vectorless-compiler/src/passes/analysis/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/analysis/validate.rs b/crates/vectorless-compiler/src/passes/analysis/validate.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/analysis/validate.rs
rename to crates/vectorless-compiler/src/passes/analysis/validate.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/chain.rs b/crates/vectorless-compiler/src/passes/backend/chain.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/chain.rs
rename to crates/vectorless-compiler/src/passes/backend/chain.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/concept.rs b/crates/vectorless-compiler/src/passes/backend/concept.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/concept.rs
rename to crates/vectorless-compiler/src/passes/backend/concept.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/mod.rs b/crates/vectorless-compiler/src/passes/backend/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/mod.rs
rename to crates/vectorless-compiler/src/passes/backend/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/navigation.rs b/crates/vectorless-compiler/src/passes/backend/navigation.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/navigation.rs
rename to crates/vectorless-compiler/src/passes/backend/navigation.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/optimize.rs b/crates/vectorless-compiler/src/passes/backend/optimize.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/optimize.rs
rename to crates/vectorless-compiler/src/passes/backend/optimize.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/overlap.rs b/crates/vectorless-compiler/src/passes/backend/overlap.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/overlap.rs
rename to crates/vectorless-compiler/src/passes/backend/overlap.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/reasoning.rs b/crates/vectorless-compiler/src/passes/backend/reasoning.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/reasoning.rs
rename to crates/vectorless-compiler/src/passes/backend/reasoning.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/route.rs b/crates/vectorless-compiler/src/passes/backend/route.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/route.rs
rename to crates/vectorless-compiler/src/passes/backend/route.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/score.rs b/crates/vectorless-compiler/src/passes/backend/score.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/score.rs
rename to crates/vectorless-compiler/src/passes/backend/score.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/backend/verify.rs b/crates/vectorless-compiler/src/passes/backend/verify.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/backend/verify.rs
rename to crates/vectorless-compiler/src/passes/backend/verify.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/frontend/build.rs b/crates/vectorless-compiler/src/passes/frontend/build.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/frontend/build.rs
rename to crates/vectorless-compiler/src/passes/frontend/build.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/frontend/mod.rs b/crates/vectorless-compiler/src/passes/frontend/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/frontend/mod.rs
rename to crates/vectorless-compiler/src/passes/frontend/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/frontend/parse.rs b/crates/vectorless-compiler/src/passes/frontend/parse.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/frontend/parse.rs
rename to crates/vectorless-compiler/src/passes/frontend/parse.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/mod.rs b/crates/vectorless-compiler/src/passes/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/mod.rs
rename to crates/vectorless-compiler/src/passes/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/transform/enrich.rs b/crates/vectorless-compiler/src/passes/transform/enrich.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/transform/enrich.rs
rename to crates/vectorless-compiler/src/passes/transform/enrich.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/transform/mod.rs b/crates/vectorless-compiler/src/passes/transform/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/transform/mod.rs
rename to crates/vectorless-compiler/src/passes/transform/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/passes/transform/split.rs b/crates/vectorless-compiler/src/passes/transform/split.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/passes/transform/split.rs
rename to crates/vectorless-compiler/src/passes/transform/split.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/checkpoint.rs b/crates/vectorless-compiler/src/pipeline/checkpoint.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/checkpoint.rs
rename to crates/vectorless-compiler/src/pipeline/checkpoint.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/context.rs b/crates/vectorless-compiler/src/pipeline/context.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/context.rs
rename to crates/vectorless-compiler/src/pipeline/context.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/executor.rs b/crates/vectorless-compiler/src/pipeline/executor.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/executor.rs
rename to crates/vectorless-compiler/src/pipeline/executor.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/metrics.rs b/crates/vectorless-compiler/src/pipeline/metrics.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/metrics.rs
rename to crates/vectorless-compiler/src/pipeline/metrics.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/mod.rs b/crates/vectorless-compiler/src/pipeline/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/mod.rs
rename to crates/vectorless-compiler/src/pipeline/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/orchestrator.rs b/crates/vectorless-compiler/src/pipeline/orchestrator.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/orchestrator.rs
rename to crates/vectorless-compiler/src/pipeline/orchestrator.rs
diff --git a/vectorless-core/vectorless-compiler/src/pipeline/policy.rs b/crates/vectorless-compiler/src/pipeline/policy.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/pipeline/policy.rs
rename to crates/vectorless-compiler/src/pipeline/policy.rs
diff --git a/vectorless-core/vectorless-compiler/src/summary/full.rs b/crates/vectorless-compiler/src/summary/full.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/summary/full.rs
rename to crates/vectorless-compiler/src/summary/full.rs
diff --git a/vectorless-core/vectorless-compiler/src/summary/lazy.rs b/crates/vectorless-compiler/src/summary/lazy.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/summary/lazy.rs
rename to crates/vectorless-compiler/src/summary/lazy.rs
diff --git a/vectorless-core/vectorless-compiler/src/summary/mod.rs b/crates/vectorless-compiler/src/summary/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/summary/mod.rs
rename to crates/vectorless-compiler/src/summary/mod.rs
diff --git a/vectorless-core/vectorless-compiler/src/summary/selective.rs b/crates/vectorless-compiler/src/summary/selective.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/summary/selective.rs
rename to crates/vectorless-compiler/src/summary/selective.rs
diff --git a/vectorless-core/vectorless-compiler/src/summary/strategy.rs b/crates/vectorless-compiler/src/summary/strategy.rs
similarity index 100%
rename from vectorless-core/vectorless-compiler/src/summary/strategy.rs
rename to crates/vectorless-compiler/src/summary/strategy.rs
diff --git a/vectorless-core/vectorless-config/Cargo.toml b/crates/vectorless-config/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-config/Cargo.toml
rename to crates/vectorless-config/Cargo.toml
diff --git a/vectorless-core/vectorless-config/src/indexer.rs b/crates/vectorless-config/src/indexer.rs
similarity index 100%
rename from vectorless-core/vectorless-config/src/indexer.rs
rename to crates/vectorless-config/src/indexer.rs
diff --git a/vectorless-core/vectorless-config/src/lib.rs b/crates/vectorless-config/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-config/src/lib.rs
rename to crates/vectorless-config/src/lib.rs
diff --git a/vectorless-core/vectorless-config/src/llm_pool.rs b/crates/vectorless-config/src/llm_pool.rs
similarity index 100%
rename from vectorless-core/vectorless-config/src/llm_pool.rs
rename to crates/vectorless-config/src/llm_pool.rs
diff --git a/vectorless-core/vectorless-config/src/metrics.rs b/crates/vectorless-config/src/metrics.rs
similarity index 100%
rename from vectorless-core/vectorless-config/src/metrics.rs
rename to crates/vectorless-config/src/metrics.rs
diff --git a/vectorless-core/vectorless-config/src/storage.rs b/crates/vectorless-config/src/storage.rs
similarity index 100%
rename from vectorless-core/vectorless-config/src/storage.rs
rename to crates/vectorless-config/src/storage.rs
diff --git a/vectorless-core/vectorless-document/Cargo.toml b/crates/vectorless-document/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-document/Cargo.toml
rename to crates/vectorless-document/Cargo.toml
diff --git a/vectorless-core/vectorless-document/src/chain.rs b/crates/vectorless-document/src/chain.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/chain.rs
rename to crates/vectorless-document/src/chain.rs
diff --git a/vectorless-core/vectorless-document/src/evidence.rs b/crates/vectorless-document/src/evidence.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/evidence.rs
rename to crates/vectorless-document/src/evidence.rs
diff --git a/vectorless-core/vectorless-document/src/format.rs b/crates/vectorless-document/src/format.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/format.rs
rename to crates/vectorless-document/src/format.rs
diff --git a/vectorless-core/vectorless-document/src/lib.rs b/crates/vectorless-document/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/lib.rs
rename to crates/vectorless-document/src/lib.rs
diff --git a/vectorless-core/vectorless-document/src/navigation.rs b/crates/vectorless-document/src/navigation.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/navigation.rs
rename to crates/vectorless-document/src/navigation.rs
diff --git a/vectorless-core/vectorless-document/src/node.rs b/crates/vectorless-document/src/node.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/node.rs
rename to crates/vectorless-document/src/node.rs
diff --git a/vectorless-core/vectorless-document/src/overlap.rs b/crates/vectorless-document/src/overlap.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/overlap.rs
rename to crates/vectorless-document/src/overlap.rs
diff --git a/vectorless-core/vectorless-document/src/query_route.rs b/crates/vectorless-document/src/query_route.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/query_route.rs
rename to crates/vectorless-document/src/query_route.rs
diff --git a/vectorless-core/vectorless-document/src/reasoning.rs b/crates/vectorless-document/src/reasoning.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/reasoning.rs
rename to crates/vectorless-document/src/reasoning.rs
diff --git a/vectorless-core/vectorless-document/src/reference.rs b/crates/vectorless-document/src/reference.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/reference.rs
rename to crates/vectorless-document/src/reference.rs
diff --git a/vectorless-core/vectorless-document/src/serde_helpers.rs b/crates/vectorless-document/src/serde_helpers.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/serde_helpers.rs
rename to crates/vectorless-document/src/serde_helpers.rs
diff --git a/vectorless-core/vectorless-document/src/structure.rs b/crates/vectorless-document/src/structure.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/structure.rs
rename to crates/vectorless-document/src/structure.rs
diff --git a/vectorless-core/vectorless-document/src/toc.rs b/crates/vectorless-document/src/toc.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/toc.rs
rename to crates/vectorless-document/src/toc.rs
diff --git a/vectorless-core/vectorless-document/src/tree.rs b/crates/vectorless-document/src/tree.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/tree.rs
rename to crates/vectorless-document/src/tree.rs
diff --git a/vectorless-core/vectorless-document/src/understanding.rs b/crates/vectorless-document/src/understanding.rs
similarity index 100%
rename from vectorless-core/vectorless-document/src/understanding.rs
rename to crates/vectorless-document/src/understanding.rs
diff --git a/vectorless-core/vectorless-engine/Cargo.toml b/crates/vectorless-engine/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-engine/Cargo.toml
rename to crates/vectorless-engine/Cargo.toml
diff --git a/vectorless-core/vectorless-engine/src/builder.rs b/crates/vectorless-engine/src/builder.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/builder.rs
rename to crates/vectorless-engine/src/builder.rs
diff --git a/vectorless-core/vectorless-engine/src/compile_input.rs b/crates/vectorless-engine/src/compile_input.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/compile_input.rs
rename to crates/vectorless-engine/src/compile_input.rs
diff --git a/vectorless-core/vectorless-engine/src/compiled_document.rs b/crates/vectorless-engine/src/compiled_document.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/compiled_document.rs
rename to crates/vectorless-engine/src/compiled_document.rs
diff --git a/vectorless-core/vectorless-engine/src/engine.rs b/crates/vectorless-engine/src/engine.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/engine.rs
rename to crates/vectorless-engine/src/engine.rs
diff --git a/vectorless-core/vectorless-engine/src/indexer.rs b/crates/vectorless-engine/src/indexer.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/indexer.rs
rename to crates/vectorless-engine/src/indexer.rs
diff --git a/vectorless-core/vectorless-engine/src/lib.rs b/crates/vectorless-engine/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/lib.rs
rename to crates/vectorless-engine/src/lib.rs
diff --git a/vectorless-core/vectorless-engine/src/types.rs b/crates/vectorless-engine/src/types.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/types.rs
rename to crates/vectorless-engine/src/types.rs
diff --git a/vectorless-core/vectorless-engine/src/workspace.rs b/crates/vectorless-engine/src/workspace.rs
similarity index 100%
rename from vectorless-core/vectorless-engine/src/workspace.rs
rename to crates/vectorless-engine/src/workspace.rs
diff --git a/vectorless-core/vectorless-error/Cargo.toml b/crates/vectorless-error/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-error/Cargo.toml
rename to crates/vectorless-error/Cargo.toml
diff --git a/vectorless-core/vectorless-error/src/error.rs b/crates/vectorless-error/src/error.rs
similarity index 100%
rename from vectorless-core/vectorless-error/src/error.rs
rename to crates/vectorless-error/src/error.rs
diff --git a/vectorless-core/vectorless-error/src/lib.rs b/crates/vectorless-error/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-error/src/lib.rs
rename to crates/vectorless-error/src/lib.rs
diff --git a/vectorless-core/vectorless-events/Cargo.toml b/crates/vectorless-events/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-events/Cargo.toml
rename to crates/vectorless-events/Cargo.toml
diff --git a/vectorless-core/vectorless-events/src/emitter.rs b/crates/vectorless-events/src/emitter.rs
similarity index 100%
rename from vectorless-core/vectorless-events/src/emitter.rs
rename to crates/vectorless-events/src/emitter.rs
diff --git a/vectorless-core/vectorless-events/src/lib.rs b/crates/vectorless-events/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-events/src/lib.rs
rename to crates/vectorless-events/src/lib.rs
diff --git a/vectorless-core/vectorless-events/src/types.rs b/crates/vectorless-events/src/types.rs
similarity index 100%
rename from vectorless-core/vectorless-events/src/types.rs
rename to crates/vectorless-events/src/types.rs
diff --git a/vectorless-core/vectorless-graph/Cargo.toml b/crates/vectorless-graph/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-graph/Cargo.toml
rename to crates/vectorless-graph/Cargo.toml
diff --git a/vectorless-core/vectorless-graph/src/builder.rs b/crates/vectorless-graph/src/builder.rs
similarity index 100%
rename from vectorless-core/vectorless-graph/src/builder.rs
rename to crates/vectorless-graph/src/builder.rs
diff --git a/vectorless-core/vectorless-graph/src/config.rs b/crates/vectorless-graph/src/config.rs
similarity index 100%
rename from vectorless-core/vectorless-graph/src/config.rs
rename to crates/vectorless-graph/src/config.rs
diff --git a/vectorless-core/vectorless-graph/src/lib.rs b/crates/vectorless-graph/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-graph/src/lib.rs
rename to crates/vectorless-graph/src/lib.rs
diff --git a/vectorless-core/vectorless-graph/src/types.rs b/crates/vectorless-graph/src/types.rs
similarity index 100%
rename from vectorless-core/vectorless-graph/src/types.rs
rename to crates/vectorless-graph/src/types.rs
diff --git a/vectorless-core/vectorless-llm/Cargo.toml b/crates/vectorless-llm/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-llm/Cargo.toml
rename to crates/vectorless-llm/Cargo.toml
diff --git a/vectorless-core/vectorless-llm/src/client.rs b/crates/vectorless-llm/src/client.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/client.rs
rename to crates/vectorless-llm/src/client.rs
diff --git a/vectorless-core/vectorless-llm/src/config.rs b/crates/vectorless-llm/src/config.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/config.rs
rename to crates/vectorless-llm/src/config.rs
diff --git a/vectorless-core/vectorless-llm/src/error.rs b/crates/vectorless-llm/src/error.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/error.rs
rename to crates/vectorless-llm/src/error.rs
diff --git a/vectorless-core/vectorless-llm/src/executor.rs b/crates/vectorless-llm/src/executor.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/executor.rs
rename to crates/vectorless-llm/src/executor.rs
diff --git a/vectorless-core/vectorless-llm/src/fallback.rs b/crates/vectorless-llm/src/fallback.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/fallback.rs
rename to crates/vectorless-llm/src/fallback.rs
diff --git a/vectorless-core/vectorless-llm/src/lib.rs b/crates/vectorless-llm/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/lib.rs
rename to crates/vectorless-llm/src/lib.rs
diff --git a/vectorless-core/vectorless-llm/src/memo/mod.rs b/crates/vectorless-llm/src/memo/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/memo/mod.rs
rename to crates/vectorless-llm/src/memo/mod.rs
diff --git a/vectorless-core/vectorless-llm/src/memo/store.rs b/crates/vectorless-llm/src/memo/store.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/memo/store.rs
rename to crates/vectorless-llm/src/memo/store.rs
diff --git a/vectorless-core/vectorless-llm/src/memo/types.rs b/crates/vectorless-llm/src/memo/types.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/memo/types.rs
rename to crates/vectorless-llm/src/memo/types.rs
diff --git a/vectorless-core/vectorless-llm/src/pool.rs b/crates/vectorless-llm/src/pool.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/pool.rs
rename to crates/vectorless-llm/src/pool.rs
diff --git a/vectorless-core/vectorless-llm/src/throttle.rs b/crates/vectorless-llm/src/throttle.rs
similarity index 100%
rename from vectorless-core/vectorless-llm/src/throttle.rs
rename to crates/vectorless-llm/src/throttle.rs
diff --git a/vectorless-core/vectorless-metrics/Cargo.toml b/crates/vectorless-metrics/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-metrics/Cargo.toml
rename to crates/vectorless-metrics/Cargo.toml
diff --git a/vectorless-core/vectorless-metrics/src/hub.rs b/crates/vectorless-metrics/src/hub.rs
similarity index 100%
rename from vectorless-core/vectorless-metrics/src/hub.rs
rename to crates/vectorless-metrics/src/hub.rs
diff --git a/vectorless-core/vectorless-metrics/src/index.rs b/crates/vectorless-metrics/src/index.rs
similarity index 100%
rename from vectorless-core/vectorless-metrics/src/index.rs
rename to crates/vectorless-metrics/src/index.rs
diff --git a/vectorless-core/vectorless-metrics/src/lib.rs b/crates/vectorless-metrics/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-metrics/src/lib.rs
rename to crates/vectorless-metrics/src/lib.rs
diff --git a/vectorless-core/vectorless-metrics/src/llm.rs b/crates/vectorless-metrics/src/llm.rs
similarity index 100%
rename from vectorless-core/vectorless-metrics/src/llm.rs
rename to crates/vectorless-metrics/src/llm.rs
diff --git a/vectorless-core/vectorless-metrics/src/retrieval.rs b/crates/vectorless-metrics/src/retrieval.rs
similarity index 100%
rename from vectorless-core/vectorless-metrics/src/retrieval.rs
rename to crates/vectorless-metrics/src/retrieval.rs
diff --git a/vectorless-core/vectorless-primitives/Cargo.toml b/crates/vectorless-primitives/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-primitives/Cargo.toml
rename to crates/vectorless-primitives/Cargo.toml
diff --git a/vectorless-core/vectorless-primitives/src/lib.rs b/crates/vectorless-primitives/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/lib.rs
rename to crates/vectorless-primitives/src/lib.rs
diff --git a/vectorless-core/vectorless-primitives/src/navigator.rs b/crates/vectorless-primitives/src/navigator.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/navigator.rs
rename to crates/vectorless-primitives/src/navigator.rs
diff --git a/vectorless-core/vectorless-primitives/src/navigator_inspection.rs b/crates/vectorless-primitives/src/navigator_inspection.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/navigator_inspection.rs
rename to crates/vectorless-primitives/src/navigator_inspection.rs
diff --git a/vectorless-core/vectorless-primitives/src/navigator_search.rs b/crates/vectorless-primitives/src/navigator_search.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/navigator_search.rs
rename to crates/vectorless-primitives/src/navigator_search.rs
diff --git a/vectorless-core/vectorless-primitives/src/resolve.rs b/crates/vectorless-primitives/src/resolve.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/resolve.rs
rename to crates/vectorless-primitives/src/resolve.rs
diff --git a/vectorless-core/vectorless-primitives/src/subtree.rs b/crates/vectorless-primitives/src/subtree.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/subtree.rs
rename to crates/vectorless-primitives/src/subtree.rs
diff --git a/vectorless-core/vectorless-primitives/src/types.rs b/crates/vectorless-primitives/src/types.rs
similarity index 100%
rename from vectorless-core/vectorless-primitives/src/types.rs
rename to crates/vectorless-primitives/src/types.rs
diff --git a/vectorless-core/vectorless-py/Cargo.toml b/crates/vectorless-py/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-py/Cargo.toml
rename to crates/vectorless-py/Cargo.toml
diff --git a/vectorless-core/vectorless-py/src/config.rs b/crates/vectorless-py/src/config.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/config.rs
rename to crates/vectorless-py/src/config.rs
diff --git a/vectorless-core/vectorless-py/src/document.rs b/crates/vectorless-py/src/document.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/document.rs
rename to crates/vectorless-py/src/document.rs
diff --git a/vectorless-core/vectorless-py/src/engine.rs b/crates/vectorless-py/src/engine.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/engine.rs
rename to crates/vectorless-py/src/engine.rs
diff --git a/vectorless-core/vectorless-py/src/error.rs b/crates/vectorless-py/src/error.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/error.rs
rename to crates/vectorless-py/src/error.rs
diff --git a/vectorless-core/vectorless-py/src/graph.rs b/crates/vectorless-py/src/graph.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/graph.rs
rename to crates/vectorless-py/src/graph.rs
diff --git a/vectorless-core/vectorless-py/src/lib.rs b/crates/vectorless-py/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/lib.rs
rename to crates/vectorless-py/src/lib.rs
diff --git a/vectorless-core/vectorless-py/src/metrics.rs b/crates/vectorless-py/src/metrics.rs
similarity index 100%
rename from vectorless-core/vectorless-py/src/metrics.rs
rename to crates/vectorless-py/src/metrics.rs
diff --git a/vectorless-core/vectorless-scoring/Cargo.toml b/crates/vectorless-scoring/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-scoring/Cargo.toml
rename to crates/vectorless-scoring/Cargo.toml
diff --git a/vectorless-core/vectorless-scoring/src/bm25.rs b/crates/vectorless-scoring/src/bm25.rs
similarity index 100%
rename from vectorless-core/vectorless-scoring/src/bm25.rs
rename to crates/vectorless-scoring/src/bm25.rs
diff --git a/vectorless-core/vectorless-scoring/src/lib.rs b/crates/vectorless-scoring/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-scoring/src/lib.rs
rename to crates/vectorless-scoring/src/lib.rs
diff --git a/vectorless-core/vectorless-storage/Cargo.toml b/crates/vectorless-storage/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-storage/Cargo.toml
rename to crates/vectorless-storage/Cargo.toml
diff --git a/vectorless-core/vectorless-storage/src/backend/file.rs b/crates/vectorless-storage/src/backend/file.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/backend/file.rs
rename to crates/vectorless-storage/src/backend/file.rs
diff --git a/vectorless-core/vectorless-storage/src/backend/mod.rs b/crates/vectorless-storage/src/backend/mod.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/backend/mod.rs
rename to crates/vectorless-storage/src/backend/mod.rs
diff --git a/vectorless-core/vectorless-storage/src/backend/trait_def.rs b/crates/vectorless-storage/src/backend/trait_def.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/backend/trait_def.rs
rename to crates/vectorless-storage/src/backend/trait_def.rs
diff --git a/vectorless-core/vectorless-storage/src/cache.rs b/crates/vectorless-storage/src/cache.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/cache.rs
rename to crates/vectorless-storage/src/cache.rs
diff --git a/vectorless-core/vectorless-storage/src/codec.rs b/crates/vectorless-storage/src/codec.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/codec.rs
rename to crates/vectorless-storage/src/codec.rs
diff --git a/vectorless-core/vectorless-storage/src/lib.rs b/crates/vectorless-storage/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/lib.rs
rename to crates/vectorless-storage/src/lib.rs
diff --git a/vectorless-core/vectorless-storage/src/lock.rs b/crates/vectorless-storage/src/lock.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/lock.rs
rename to crates/vectorless-storage/src/lock.rs
diff --git a/vectorless-core/vectorless-storage/src/migration.rs b/crates/vectorless-storage/src/migration.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/migration.rs
rename to crates/vectorless-storage/src/migration.rs
diff --git a/vectorless-core/vectorless-storage/src/persistence.rs b/crates/vectorless-storage/src/persistence.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/persistence.rs
rename to crates/vectorless-storage/src/persistence.rs
diff --git a/vectorless-core/vectorless-storage/src/workspace.rs b/crates/vectorless-storage/src/workspace.rs
similarity index 100%
rename from vectorless-core/vectorless-storage/src/workspace.rs
rename to crates/vectorless-storage/src/workspace.rs
diff --git a/vectorless-core/vectorless-utils/Cargo.toml b/crates/vectorless-utils/Cargo.toml
similarity index 100%
rename from vectorless-core/vectorless-utils/Cargo.toml
rename to crates/vectorless-utils/Cargo.toml
diff --git a/vectorless-core/vectorless-utils/src/fingerprint.rs b/crates/vectorless-utils/src/fingerprint.rs
similarity index 100%
rename from vectorless-core/vectorless-utils/src/fingerprint.rs
rename to crates/vectorless-utils/src/fingerprint.rs
diff --git a/vectorless-core/vectorless-utils/src/lib.rs b/crates/vectorless-utils/src/lib.rs
similarity index 100%
rename from vectorless-core/vectorless-utils/src/lib.rs
rename to crates/vectorless-utils/src/lib.rs
diff --git a/vectorless-core/vectorless-utils/src/token.rs b/crates/vectorless-utils/src/token.rs
similarity index 100%
rename from vectorless-core/vectorless-utils/src/token.rs
rename to crates/vectorless-utils/src/token.rs
diff --git a/vectorless-core/vectorless-utils/src/validation.rs b/crates/vectorless-utils/src/validation.rs
similarity index 100%
rename from vectorless-core/vectorless-utils/src/validation.rs
rename to crates/vectorless-utils/src/validation.rs
diff --git a/pyproject.toml b/pyproject.toml
index e894c05..3620424 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,7 +68,7 @@ Documentation = "https://www.vectorless.dev/docs/intro"
 [tool.maturin]
 python-source = "."
 module-name = "vectorless._vectorless"
-manifest-path = "vectorless-core/vectorless-py/Cargo.toml"
+manifest-path = "crates/vectorless-py/Cargo.toml"
 features = ["pyo3/extension-module"]
 
 [tool.pytest.ini_options]
diff --git a/vectorless/ask/dispatcher.py b/vectorless/ask/dispatcher.py
index 94c5410..5553f49 100644
--- a/vectorless/ask/dispatcher.py
+++ b/vectorless/ask/dispatcher.py
@@ -1,7 +1,5 @@
 """Dispatcher — unified entry point for retrieval.
 
-Mirrors vectorless-core/vectorless-agent/src/dispatcher.rs.
-
 All queries go through dispatch():
 1. Query reasoning -> QueryAnalysis (via QueryAnalyzer)
 2. Scope resolution -> Specified | Workspace
diff --git a/vectorless/ask/orchestrator.py b/vectorless/ask/orchestrator.py
index 4d86000..b4201ed 100644
--- a/vectorless/ask/orchestrator.py
+++ b/vectorless/ask/orchestrator.py
@@ -1,7 +1,5 @@
 """Orchestrator agent — coordinates multi-document retrieval.
 
-Mirrors vectorless-core/vectorless-agent/src/orchestrator/.
-
 The Orchestrator is always the entry point for retrieval:
 - User specified doc_ids → skip_analysis=True → spawn Workers directly
 - Workspace (unspecified) → analyze DocCards → select docs → spawn Workers
diff --git a/vectorless/ask/prompts.py b/vectorless/ask/prompts.py
index 0086fed..90014e1 100644
--- a/vectorless/ask/prompts.py
+++ b/vectorless/ask/prompts.py
@@ -1,9 +1,5 @@
 """Prompt templates for the retrieval agent.
 
-Extracted from vectorless-core/vectorless-agent/src/prompts.rs,
-vectorless-core/vectorless-agent/src/worker/planning.rs, and
-vectorless-core/vectorless-agent/src/orchestrator/replan.rs.
-
 Templates:
 1. worker_navigation   — Worker nav loop, every round
 2. worker_dispatch     — Worker first round (when Orchestrator dispatches)
diff --git a/vectorless/ask/understand.py b/vectorless/ask/understand.py
index c24db91..8f6d29c 100644
--- a/vectorless/ask/understand.py
+++ b/vectorless/ask/understand.py
@@ -1,7 +1,5 @@
 """Query understanding — LLM-driven analysis of user queries.
 
-Mirrors vectorless-core/vectorless-query/src/understand.rs.
-
 This module is now a thin wrapper around the multi-stage QueryAnalyzer.
 Kept for backward compatibility — new code should use QueryAnalyzer directly.
 """
diff --git a/vectorless/rerank/synthesize.py b/vectorless/rerank/synthesize.py
index a1b18fe..b204f84 100644
--- a/vectorless/rerank/synthesize.py
+++ b/vectorless/rerank/synthesize.py
@@ -1,6 +1,5 @@
 """Evidence deduplication and answer formatting.
 
-Mirrors vectorless-core/vectorless-rerank/src/.
 Dedup is pure compute (no LLM). Answer formatting is intent-aware.
 
 The Rust rerank principle: "Find what you find, return what you find."