From 64cf6080263b548bc7955d2c44303a438a411e5f Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Sun, 28 Jun 2026 03:37:13 +0800
Subject: [PATCH] docs: add English stubs for research plan and free source
 setup

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/free_source_setup.md       | 15 +++++++++++++++
 docs/free_source_setup.zh-CN.md |  2 ++
 docs/research_plan.md           | 17 +++++++++++++++++
 docs/research_plan.zh-CN.md     |  2 ++
 4 files changed, 36 insertions(+)
 create mode 100644 docs/free_source_setup.md
 create mode 100644 docs/research_plan.md

diff --git a/docs/free_source_setup.md b/docs/free_source_setup.md
new file mode 100644
index 0000000..7473d27
--- /dev/null
+++ b/docs/free_source_setup.md
@@ -0,0 +1,15 @@
+# Free data source setup
+
+[简体中文](free_source_setup.zh-CN.md)
+
+## Shipped files
+
+- `config/free_rss_feeds.csv`: official RSS feeds that need no account.
+- `config/core_us_equity_aliases.csv`: core US equity watchlist aliases.
+- `data/live/political_watchlist.csv`: initial watchlist for the live publish path.
+- `data/live/source_items.csv`: latest raw text pulled by the scheduled RSS pipeline.
+- `data/live/source_events.csv`: events extracted deterministically from `source_items.csv`.
+- `data/live/political_events.csv`: stable Advisor input, refreshed by RSS/source pipeline or maintained after manual review.
+- `data/live/source_tracker.csv`: merged watchlist and event tracker.
+
+See the Chinese setup note for cron wiring, refresh commands, and operator checks.
diff --git a/docs/free_source_setup.zh-CN.md b/docs/free_source_setup.zh-CN.md
index dea4825..7c5e272 100644
--- a/docs/free_source_setup.zh-CN.md
+++ b/docs/free_source_setup.zh-CN.md
@@ -1,5 +1,7 @@
 # 免费数据源配置
 
+[English](free_source_setup.md)
+
 ## 已落地文件
 
 - `config/free_rss_feeds.csv`：无需账号的官方 RSS 源。
diff --git a/docs/research_plan.md b/docs/research_plan.md
new file mode 100644
index 0000000..e55e25a
--- /dev/null
+++ b/docs/research_plan.md
@@ -0,0 +1,17 @@
+# Political event tracking research plan
+
+[简体中文](research_plan.zh-CN.md)
+
+## Goal
+
+Test whether public figure position disclosures, official public mentions, policy
+funding events, and short-to-medium-term US equity returns show a reproducible
+relationship.
+
+Working hypothesis:
+
+1. Signals appear first in public holdings or trade disclosures.
+2. They surface next in official speeches, announcements, White House materials, or media leads.
+3. Market reaction shows up later in price action, earnings, government procurement, or analyst events.
+
+See the Chinese plan for data sources, evaluation windows, and milestone checklist.
diff --git a/docs/research_plan.zh-CN.md b/docs/research_plan.zh-CN.md
index aea7bd6..22ca41e 100644
--- a/docs/research_plan.zh-CN.md
+++ b/docs/research_plan.zh-CN.md
@@ -1,5 +1,7 @@
 # 政治事件追踪研究计划
 
+[English](research_plan.md)
+
 ## 目标
 
 验证公开人物持仓披露、官方公开点名、政策资金事件与美股短中期收益之间是否存在可复现关系。