From c29e6bceda2c21ecde20ee53efdc297adafa8cbc Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Mon, 6 Jul 2026 19:01:09 +0800
Subject: [PATCH] docs: clarify QSL architecture role

Co-Authored-By: Codex <noreply@openai.com>
---
 README.md       | 9 +++++++++
 README.zh-CN.md | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 1f1941f..9ca3e1b 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # MarketSignalSources
 
+
+## QSL architecture role
+
+- **Layer**: `strategy-library`.
+- **Responsibility**: artifact-first market signal source builders.
+- **Owns**: market signal bundles and handoff artifacts.
+- **Consumes**: public/market inputs and downstream strategy consumers.
+- **Must not**: submit orders or mutate platform runtime settings.
+
 Artifact-first market signal source builders for QuantStrategyLab strategy platforms.
 
 ## Installation
diff --git a/README.zh-CN.md b/README.zh-CN.md
index f74c053..54fe061 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,5 +1,14 @@
 # MarketSignalSources
 
+
+## QSL 架构角色
+
+- **层级**：`策略库`。
+- **职责**：artifact-first 市场信号源构建器。
+- **事实源/归属**：market signal bundles 与 handoff artifacts。
+- **消费对象**：公开/市场输入和下游策略消费者。
+- **禁止事项**：下单或修改平台 runtime settings。
+
 QuantStrategyLab 策略平台的市场信号源构建工具包，采用 artifact-first 设计。
 
 ## 安装