CEX Monthly Secondary Orchestrator
Run one pipeline to build a complete monthly secondary-market report pack. Use strict month scope only (first day to last day of target month), never annual aggregation. Public-facing output is the default target. Do not expose internal production scaffolding in正文.
If the request also includes the RWA Night Desk website, report archive, Sites deployment, or subscriber notification, hand the validated monthly output to $rwa-report-site-orchestrator. Do not stop after producing the local Markdown and charts.
Quick Start
python3 ~/.claude/skills/cex-monthly-secondary-orchestrator/scripts/run_cex_monthly_orchestrator.py \
--month 2026-02 \
--outdir ./reports/2026-02/secondary_orchestrated
V2 Polish Pass (Recommended)
After orchestration, apply the current approved house style:
python3 ~/.claude/skills/cex-monthly-secondary-orchestrator/scripts/apply_v2_polish.py \
--report-dir ./reports/2026-02/secondary_orchestrated
This pass applies:
- Light-theme redraw for Deribit calendar-month funding chart.
- USD-normalized redraw for Deribit OI chart only when the snapshot is within 48 hours of target month-end.
- Donut redraw for DeFi TVL single-month share chart.
- 100% stacked-bar redraw for outside-top10 breadth chart.
- Report markdown cleanup (removes standalone Derivatives Risk block and NFT figure line when present, strips Chinese smart quotes).
Writing Contract
Before writing, rewriting, or quality-checking the public monthly report, read:
- monthly-paragraph-contract.md
This contract is mandatory. It defines what each paragraph should do, which metric must support it, when to show or hide charts, and how to handle missing data. Do not rely on hardcoded Python prose when a paragraph needs editorial judgment.
What It Coordinates
- Binance-style Figure 2 top coin performance skill.
- Binance-style Figure 3 DeFi TVL share skill.
- Binance-style Figure 4 NFT volume skill (data retained; display may be removed by polish pass).
- Binance-style Figure 6 outside-top10 share skill.
- Deribit monthly metrics skill.
- Core yuque-style monthly report generator.
Module Calls
Run a single module when only one dataset needs refresh or diagnosis:
python3 ~/.claude/skills/cex-monthly-secondary-orchestrator/scripts/run_monthly_module.py \
--module derivatives \
--month 2026-02 \
--outdir /tmp/monthly-modules/deribit
Supported aliases are top-assets, defi, nft, concentration, derivatives, and core. Use run_monthly_module.py --describe for the machine-readable source registry. The single-module CLI and full orchestrator share monthly_module_registry.py; see module-routing.md.
Output
orchestrated_secondary_report.mdorchestrator_manifest.csvmonthly_manifest.json(coverage status, source gaps, hashes, strict-month audit)validation.jsoncharts/*.pngpackages/*(sub-skill raw outputs)orchestrated_secondary_report_coinbase_style_text.md(if generated in workspace flow)
Generation is fail-closed for required modules. Figure 2 always uses --exact-history; NFT missing months are not converted to zero; rolling/current exchange snapshots are rejected as historical month data. Run the validator before publishing:
python3 ~/.claude/skills/cex-monthly-secondary-orchestrator/scripts/validate_monthly_output.py \
--dir ./reports/2026-02/secondary_orchestrated \
--month 2026-02
Public Writing Standard
- The monthly page should read like an exchange or broker publication, not like an analyst notebook.
- Do not emit sections such as methodology, data availability, references, chart indexes, or execution status in the public page.
- Do not label sections by chart number.
- Prefer 6 to 9 substantive sections total.
- Every section should pair a chart with a short judgment paragraph.
- Stablecoin opportunity content should be included only when it helps explain capital allocation behavior, and must stay compact.
- Use institutional tone: conclusion-first, evidence-backed, no overclaim wording.
- Paragraphs must follow
monthly-paragraph-contract.md: each paragraph should have one job (what changed,why it matters, orwhat to watch next). - Preferred section order:
Key Takeaways宏观代理与市场状态交易所流量与资金活跃度主流资产表现与市场广度衍生品仓位温度情绪与波动定价下月交易框架(基准情景)
References
- See benchmark-frame.md
- See metric-routing.md
- See module-routing.md
- See v2-house-style.md
- See monthly-paragraph-contract.md