diff --git a/docs/architecture.i18n.yaml b/docs/architecture.i18n.yaml
index e85c549fd6..aa257d67e3 100644
--- a/docs/architecture.i18n.yaml
+++ b/docs/architecture.i18n.yaml
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write docs/architecture.md
-architecture.md: b9ab65679e1cd9b8ee7d072fa28f619917fc53dd
-architecture.zh.md: 39a7012df1f7ffe611af038a93dc12c01fab1c4a
+architecture.md: 2b225db9a7fdae42f8dadd52e848fb522a53e956
+architecture.zh.md: 7366f140be1c37b3cd436bd2794b0bee3ca5694c
diff --git a/docs/architecture.md b/docs/architecture.md
index b9ab65679e..2b225db9a7 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -4,7 +4,7 @@ English | [中文](architecture.zh.md)
 
 Read this before changing anything under `packages/`. It assumes you know Cordis; if you do not, start with the [primer](cordis-primer.md) or the [tutorial](cordis-tutorial/index.md).
 
-The repository is large; use an agent to explore it.
+We recommend using an agent to explore the codebase and understand its architecture.
 
 ## Cordis
 
diff --git a/docs/architecture.zh.md b/docs/architecture.zh.md
index 39a7012df1..7366f140be 100644
--- a/docs/architecture.zh.md
+++ b/docs/architecture.zh.md
@@ -4,7 +4,7 @@
 
 改动 `packages/` 下的任何内容之前，请先阅读本文。本文假定你已了解 Cordis；如果尚未了解，请先阅读[入门](cordis-primer.md)或[教程](cordis-tutorial/index.md)。
 
-仓库很大；请借助 agent（智能体）来探索它。
+建议使用 agent（智能体）探索代码库并理解其架构。
 
 ## Cordis