diff --git a/README.md b/README.md
index 8e52087..0cd80eb 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # CnEquityStrategies
 
+
+## QSL architecture role
+
+- **Layer**: `strategy-library`.
+- **Responsibility**: A-share strategy implementation package.
+- **Owns**: runtime-enabled strategy code, manifests, catalog metadata.
+- **Consumes**: QuantPlatformKit and validated snapshot artifacts.
+- **Must not**: connect to brokers or deploy live services.
+
 [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 dca6f43..cd5430e 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # CnEquityStrategies
 
+
+## QSL 架构角色
+
+- **层级**：`策略库`。
+- **职责**：A 股策略实现包。
+- **事实源/归属**：runtime-enabled 策略代码、manifests、catalog metadata。
+- **消费对象**：QuantPlatformKit 和已验证快照 artifacts。
+- **禁止事项**：连接券商或部署 live 服务。
+
 [English README](README.md)
 
 > 投资有风险。本项目不构成投资建议，仅用于学习、研究和工程审阅。