diff --git a/core/wren-core/wren-example/README.md b/core/wren-core/wren-example/README.md
index ca5939393f..578c16f735 100644
--- a/core/wren-core/wren-example/README.md
+++ b/core/wren-core/wren-example/README.md
@@ -16,4 +16,4 @@ cargo run --example datafusion-apply
 
 ## Single Process
 - [`datafusion-apply.rs`](examples/datafusion-apply.rs): Apply an Modeling Definition Language(MDL) to a DataFusion to query local CSV files
-- [`plan_to_sql.rs`](examples/plan_to-sql.rs): Apply an Modeling Definition Language(MDL) to generate SQL from Datafusion `Expr` and `LogicalPlan`
\ No newline at end of file
+- [`plan-sql.rs`](examples/plan-sql.rs): Apply an Modeling Definition Language(MDL) to generate SQL from Datafusion `Expr` and `LogicalPlan`
\ No newline at end of file
diff --git a/core/wren/README.md b/core/wren/README.md
index f7f47009d9..d1999323d9 100644
--- a/core/wren/README.md
+++ b/core/wren/README.md
@@ -116,7 +116,7 @@ wren cube query --cube revenue --measures total --time-dimension "order_date:mon
 
 The translator produces `DATE_TRUNC` / `GROUP BY` / `WHERE` clauses for you and
 runs them through the same engine path as `wren --sql`. See the
-[Cube guide](../../docs/core/guides/modeling/cube.md) for full YAML structure
+[Cube guide](../../docs/core/guides/cubes.md) for full YAML structure
 and the [CLI reference](../../docs/core/reference/cli.md#wren-cube--pre-aggregation-queries) for all
 flags.
 
diff --git a/docs/core/README.md b/docs/core/README.md
index 7bb120d8d1..3a67d89eed 100644
--- a/docs/core/README.md
+++ b/docs/core/README.md
@@ -12,20 +12,20 @@ Changes merged to `main` are automatically synced to the doc website via GitHub
 
 - [Installation](get_started/installation.md) — agent-driven or manual CLI install
 - [Quickstart](get_started/quickstart.md) — try the bundled `jaffle_shop` demo
-- [Connect Your Database](get_started/connect.md)
+- [Connect Your Database](guides/connect.md)
 
 ## Concepts
 
 - [What is Context?](concepts/what_is_context.md)
 - [What is MDL?](concepts/what_is_mdl.md)
 - [Benefits for LLMs](concepts/benefits_llm.md)
-- [Architecture](concepts/architecture.md)
+- [Architecture](reference/architecture.md)
 
 ## Guides
 
 - [Data Modeling Overview](guides/modeling/overview.md)
 - [Wren Project Structure](guides/modeling/wren_project.md)
-- [Models](guides/modeling/model.md)
+- [Models](guides/model.md)
 - [Relations](guides/modeling/relation.md)
 - [Views](guides/modeling/view.md)
 - [Memory](guides/memory.md)