diff --git a/README.md b/README.md
index fb98432..c4e9918 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # HkEquitySnapshotPipelines
 
+
+## QSL architecture role
+
+- **Layer**: `pipeline`.
+- **Responsibility**: Hong Kong equity snapshot and evidence pipeline.
+- **Owns**: HK snapshot artifacts, manifests, readiness reports.
+- **Consumes**: HkEquityStrategies metadata and upstream market inputs.
+- **Must not**: place broker orders or infer live suitability from sample builds.
+
 [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 0fa2667..0a585ff 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # HkEquitySnapshotPipelines
 
+
+## QSL 架构角色
+
+- **层级**：`快照/证据流水线`。
+- **职责**：港股快照与证据流水线。
+- **事实源/归属**：HK snapshot artifacts、manifests、readiness reports。
+- **消费对象**：HkEquityStrategies 元数据和上游市场输入。
+- **禁止事项**：下券商订单或从样例构建推断 live suitability。
+
 [English README](README.md)
 
 > 投资有风险。本项目不构成投资建议，仅用于学习、研究和工程审阅。