Merge branch 'master' into fix/stats

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: e0909c7924fcb9a8b29b3a3426c847e9ca7f4dfb
-architecture.zh.md: b35088aa2a00623eacb2d53b19c86d9c192cd1d0
+architecture.md: bd14a0645c13f9831f57e1966b53b82bd691dbb7
+architecture.zh.md: fd449382d7989c6874e8e8cc04096976fe920418

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
 

docs/architecture.zh.md

@@ -4,7 +4,7 @@
 
 改动 `packages/` 下的任何内容之前，请先阅读本文。本文假定你已了解 Cordis；如果尚未了解，请先阅读[入门](cordis-primer.md)或[教程](cordis-tutorial/index.md)。
 
-仓库很大；请借助 agent（智能体）来探索它。
+建议使用 agent（智能体）探索代码库并理解其架构。
 
 ## Cordis