diff --git a/README.md b/README.md
index 30a4fca..4d92f4a 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # UsEquityStrategies
 
+
+## QSL architecture role
+
+- **Layer**: `strategy-library`.
+- **Responsibility**: US equity strategy implementation package.
+- **Owns**: runtime-enabled US strategy code, manifests, execution metadata.
+- **Consumes**: QuantPlatformKit and validated US snapshot artifacts.
+- **Must not**: own broker credentials or deployment settings.
+
 [Chinese README](README.zh-CN.md)
 
 > Investing involves risk. This project does not provide investment advice and is for education, research, and engineering review only.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index e8023c3..9c63684 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # UsEquityStrategies
 
+
+## QSL 架构角色
+
+- **层级**：`策略库`。
+- **职责**：美股策略实现包。
+- **事实源/归属**：runtime-enabled 美股策略代码、manifests、execution metadata。
+- **消费对象**：QuantPlatformKit 和已验证 US snapshot artifacts。
+- **禁止事项**：持有券商凭据或部署设置。
+
 [English README](README.md)
 
 > 投资有风险。本项目不构成投资建议，仅用于学习、研究和工程审阅。