diff --git a/README.md b/README.md
index 118cf23..df84f0d 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # HkEquityStrategies
 
+
+## QSL architecture role
+
+- **Layer**: `strategy-library`.
+- **Responsibility**: Hong Kong equity strategy implementation package.
+- **Owns**: HK strategy code, manifests, runtime adapters, live-readiness checks.
+- **Consumes**: QuantPlatformKit and validated HK snapshot artifacts.
+- **Must not**: own broker credentials or deployment switches.
+
 [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 613020e..9ed3a57 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # HkEquityStrategies
 
+
+## QSL 架构角色
+
+- **层级**：`策略库`。
+- **职责**：港股策略实现包。
+- **事实源/归属**：HK 策略代码、manifests、runtime adapters、live-readiness checks。
+- **消费对象**：QuantPlatformKit 和已验证 HK snapshot artifacts。
+- **禁止事项**：持有券商凭据或部署开关。
+
 [English README](README.md)
 
 > 投资有风险。本项目不构成投资建议，仅用于学习、研究和工程审阅。