Archive historical superpowers docs

Author: Pigbibi

docs/superpowers/README.md

@@ -0,0 +1,26 @@
+# Historical agent plans and research notes
+
+This directory is an archive of March 2026 agent-generated implementation plans and research designs. These files are useful for understanding why earlier IBKR research and runtime changes were attempted, but they are **not** the current source of truth for strategy behavior or live deployment settings.
+
+Current docs live here instead:
+
+- Strategy logic, cadence, universes, and research/backtest notes: [`UsEquityStrategies`](https://github.com/QuantStrategyLab/UsEquityStrategies)
+- IBKR runtime, Gateway connectivity, env vars, and deployment wiring: [`InteractiveBrokersPlatform` README](../../README.md)
+- Cross-platform matrix and live-switch runbooks: [`QuantPlatformKit`](https://github.com/QuantStrategyLab/QuantPlatformKit/tree/main/docs)
+- Snapshot artifact generation and publishing: [`UsEquitySnapshotPipelines`](https://github.com/QuantStrategyLab/UsEquitySnapshotPipelines)
+
+Do not treat wording like "current default", "live", "production", "daily", "monthly", or "quarterly" inside the archived files as current state. Those phrases describe the state or assumption at the time the file was written.
+
+## Archived plans
+
+- [`plans/2026-03-26-qqq-variant-backtest-and-ib-loop-fix.md`](plans/2026-03-26-qqq-variant-backtest-and-ib-loop-fix.md): IB event-loop fix plus early QQQ variant backtest plan.
+- [`plans/2026-03-26-voo-xlk-smh-rotation-research-implementation.md`](plans/2026-03-26-voo-xlk-smh-rotation-research-implementation.md): VOO / XLK / SMH rotation research implementation plan.
+- [`plans/2026-03-26-rebalance-frequency-weighting-research-implementation.md`](plans/2026-03-26-rebalance-frequency-weighting-research-implementation.md): rebalance frequency and weighting research implementation plan.
+- [`plans/2026-03-26-lightweight-rotation-optimization-implementation.md`](plans/2026-03-26-lightweight-rotation-optimization-implementation.md): lightweight rotation optimization research implementation plan.
+- [`plans/2026-03-28-remove-execution-lock.md`](plans/2026-03-28-remove-execution-lock.md): historical plan for removing the GCS-backed execution lock.
+
+## Archived specs
+
+- [`specs/2026-03-26-qqq-variant-backtest-design.md`](specs/2026-03-26-qqq-variant-backtest-design.md): early QQQ variant backtest and IB event-loop design.
+- [`specs/2026-03-26-voo-xlk-smh-rotation-research-design.md`](specs/2026-03-26-voo-xlk-smh-rotation-research-design.md): VOO / XLK / SMH rotation research design.
+- [`specs/2026-03-26-rebalance-frequency-weighting-research-design.md`](specs/2026-03-26-rebalance-frequency-weighting-research-design.md): rebalance frequency and weighting research design.

docs/superpowers/plans/2026-03-26-lightweight-rotation-optimization-implementation.md

@@ -1,5 +1,7 @@
 # Lightweight Rotation Optimization Implementation Plan
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
 **Goal:** 在不改变统一总池结构的前提下，为 `VOO + XLK + SMH` 研究版增加少量轻规则实验，并比较是否能改善长期表现而不过拟合。

docs/superpowers/plans/2026-03-26-qqq-variant-backtest-and-ib-loop-fix.md

@@ -1,5 +1,7 @@
 # QQQ Variant Backtest And IB Loop Fix Implementation Plan
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
 **Goal:** 修复 Python 3.13 在线程中缺少 event loop 导致的 IB 连接失败，并新增独立回测脚本比较原策略与两类引入 QQQ 的方案。

docs/superpowers/plans/2026-03-26-rebalance-frequency-weighting-research-implementation.md

@@ -1,5 +1,7 @@
 # Rebalance Frequency and Weighting Research Implementation Plan
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
 **Goal:** 为统一总池 `VOO + XLK + SMH` 研究版增加“调仓频率 + Top N + 仓位分配”实验，并跑出可比较的回测结果。

docs/superpowers/plans/2026-03-26-voo-xlk-smh-rotation-research-implementation.md

@@ -1,5 +1,7 @@
 # VOO XLK SMH Rotation Research Implementation Plan
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
 **Goal:** 扩展研究脚本，比较旧版非科技池、当前 `QQQ` 版，以及 `VOO + XLK + SMH` 结构版，并输出可直接用于决策的回测结果。

docs/superpowers/plans/2026-03-28-remove-execution-lock.md

@@ -1,5 +1,7 @@
 # Remove Execution Lock Implementation Plan
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
 **Goal:** Remove the optional GCS-backed execution lock and keep only the existing in-memory daily guard.

docs/superpowers/specs/2026-03-26-qqq-variant-backtest-design.md

@@ -1,5 +1,7 @@
 # InteractiveBrokersPlatform QQQ Variant Backtest And IB Event Loop Fix Design
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 ## 背景
 
 当前仓库实现的是“全球非科技板块季度轮动 + 每日金丝雀应急”，README 明确把它定义为科技仓位的互补策略，而不是覆盖科技牛市的主策略。

docs/superpowers/specs/2026-03-26-rebalance-frequency-weighting-research-design.md

@@ -1,5 +1,7 @@
 # Rebalance Frequency and Weighting Research Design
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 ## 1. 背景
 
 当前默认研究基线已经切到统一总池 `VOO + XLK + SMH` 版本，规则是：

docs/superpowers/specs/2026-03-26-voo-xlk-smh-rotation-research-design.md

@@ -1,5 +1,7 @@
 # VOO XLK SMH Rotation Research Design
 
+> Historical note: this file is an agent planning/research archive from March 2026. It is not the current source of truth for strategy logic, cadence, live runtime configuration, or deployment state. Use `docs/superpowers/README.md` for the archive index and current documentation pointers.
+
 ## 1. 背景
 
 当前实盘默认版本已经把 `QQQ` 纳入轮动池，作为“稳健但不完全排除科技”的方案。