SuperRAN: Instructions file for Claude Code

CLAUDE.md

SuperRAN CLAUDE.md is an instructions file for Claude Code from TianLin0509/SuperRAN. It costs 37,402 tokens per session, scanned A, original, MIT.

Repository guidance for SuperRAN, a service that exposes wireless-channel calculations and physical measurements to AI agents through MCP. MCP is a standard way for AI tools to call software functions.

In plain words
What is it for?
Developing or testing wireless simulations, ray tracing, link-level calculations, calibration, interference scenarios, and MCP integration.
Why use it?
It records the required environment, the boundary with ChannelHub, and which tests to run after changing different parts of the wireless system.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md.

This is TianLin0509/SuperRAN's own configuration. It tells Claude Code how to work on SuperRAN itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything SuperRAN configures →

Reuse

Borrowing it

Nothing to install: this file belongs to TianLin0509/SuperRAN. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/TianLin0509/SuperRAN/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/TianLin0509/SuperRAN

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for SuperRAN CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/tianlin0509/superran/claude-md.svg)](https://agentmods.dev/instructions/tianlin0509/superran/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/tianlin0509/superran/claude-md"><img src="https://agentmods.dev/badge/instructions/tianlin0509/superran/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 37,402 This file is loaded in full into every session.
When invoked 37,402 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.37402 $0.37402
Opus 5 $0.18701 $0.18701
Sonnet 5 $0.07480 $0.07480
Haiku 4.5 $0.03740 $0.03740

Measured today against content hash d91e1e3fb821, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

SuperRAN CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 1,766 lines

How it starts

The opening of the file, as written. The whole thing — 1,766 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SuperRAN 开发规范

Agent 协作入口(先读这里)

SuperRAN 由一位维护者(无线通信工程师)主导,Agent 是执行者不是决策者。 所有协作规则在 .agents/ 目录,开工前必读,不要按聊天里粘贴的 prompt 工作

  • 实现任务:.agents/AUTHOR.md
  • 独立审核:.agents/MERGER.md
  • 需要几个 Reviewer:.agents/RISK.md(按文件路径查表,不许自己估)
  • 推送与建 PR:.agents/SYNC.md(只在维护者明确说“同步 GitHub”时执行)
  • 仿真设计、数据生成或性能结论:skills/channel-sim/SKILL.md

三条铁律:一个提交只动一个物理机制审核发现的物理 bug,修复时必须补一条 “revert 掉就会变红”的测试并入 tests/test_physics_invariants.py不许静默降级, 用了工程近似要写进报告的“没证明什么”。

报告统一用 python scripts/make_agent_report.py <report.json> 生成,字段照抄 .agents/report.example.json不要手写 HTML。看当前状态用 python scripts/superran_board.py

develop 是唯一主线,主工作区就是 C:\Vibe\Wireless\SuperRAN;并行任务用 git worktree add 建到 C:\Vibe\Worktrees\SuperRAN\<任务>禁止再 clone 一份。 Agent 默认不 push、不建 PR、不合并远端。

skills/superran-lead/skills/superran-member-task/ 是已废弃的多人「组长-组员」 流程(含 FORMAL/REHEARSAL 模式、Fork 推送等),不要再按它们工作,一律以 .agents/ 为准。

与人交流采用“双层表达”:保留准确技术术语,同时紧跟一句白话解释;关键物理概念再给 一个贴近当前任务的小例子。例子只帮助理解,不能冒充代码事实、测试证据或性能结论。 首次使用缩写时展开全称;实现前用“我理解为……,不等于……”复述边界。专家已明确 理解时不要反复教学。

项目定位

SuperRAN 是独立维护、独立演进的 Agent 式无线仿真平台。信道轴序、 TDD 互易、预编码、功率约束、RBG/TBS、链路自适应和 KPI 都以 SuperRAN 本仓的合同为准。统计信道生成、CDL/TDL 表、NR 载波/TDD、参考序列、 阵列、LMMSE 与几何 S/N/I 均由 src/superran first-party 实现;运行时不得 搜索、导入或修改 MSG-Platform / ChannelHub 源码树。

channelhub.py 只保留为历史 Python API 的兼容门面,实际实现固定指向 native.py。历史环境变量 SUPERRAN_CHANNELHUB 被有意忽略,不能改变生成字节。 Sionna RT 只能作为显式 direct optional adapter 接入;不可用时硬报告, 不得退回另一个仓库。QuaDRiGa 路线已于 2026-09-04 明确不做并从代码与文档中删除 (需要 MATLAB/Octave 运行时,成本与收益不成比例);要空间一致性就按 38.901 §7.6.3 自己实现一个子集。

默认信道是 CDLinternal_sim)。sionna_rt 是本仓自己的直连适配层 (src/superran/sionna_rt.py),装了 sionna-rt 才可用,必须在配置里显式写 source: sionna_rt 才会走。引擎清单恒为这两条。

环境

  • Python ≥ 3.10,需要 numpy / scipy / pydantic v2 / pyyaml / structlog / mcp
  • 射线追踪需 pip install sionna-rt(连带 mitsuba + drjit,约 300 MB); direct adapter 已实现,但本地 OSM 资产、材料标定与多端口垂直相位仍须按报告边界验证

测试

python tests/test_e2e.py                    # 端到端
python tests/test_mcp_server.py             # MCP 全链路
python tests/test_raytracing.py             # 射线追踪与决策层
python tests/test_linklevel.py              # 谱效、可信度、物理层、IRC
python tests/test_gates.py                  # 校准、标准表、三道门、统计判决
python tests/test_results.py                # 外部算法结果契约、预注册
python tests/test_linkadapt.py              # 链路自适应、吞吐、并行生成
python tests/test_mumimo.py                 # MU-MIMO、单码字、RBG 粒度
python tests/test_system.py                 # 系统级仿真(单路径;容量=full_buffer 话务)
python tests/test_scheduler_p0.py           # 调度资源账本、频选、MU 评分与 Finalizer
python tests/test_srs_resource.py           # PCI 模3、4 CS、2T4R 双腿与全局周期容量
python tests/test_srs_waveform.py           # RE级波形、解扩、CFO/时偏与UL IoT证据
python tests/test_interference.py           # IoT、预设、说明书、算法页、文档计数
python tests/test_csi_aging.py              # CSI 时延、SRS 跳频、真实/估计视角
python tests/test_rng.py                    # 随机数分流、重复实验、CRN、置信区间
python tests/test_sysscenes.py              # 系统场景预设与成对受控性
python tests/test_power_control.py          # EBF/PEBF/NEBF 与逐 RB 功率耦合
python tests/test_physics_contract_extensions.py # 快照时钟、SRS测量口径与场景资产合同
python tests/test_physics_invariants.py     # 极化、子阵、SRS/LMMSE 物理不变量
python tests/test_channel_generation_contract.py # first-party 信道生成合同与最小网格
python tests/test_native_independence.py       # 外部根/导入阻断、v1/v2互易、35工具
python tests/test_developer_guide.py         # 开发者文档覆盖、离线结构与漂移检查
python tests/test_carrier.py                 # 载波栅格、Type-0 边界、本地 TDD 合同
python tests/test_company_256t.py            # 256T 阵列与码本
python tests/test_system_sim_tool.py          # sr_system_sim 行为级(硬失败路径)
python tests/test_benchmarks.py               # 预注册经典通信基准与 provenance

Read the full file on GitHub · 1,766 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +331 lines · +7,906 tokens per session d91e1e3fb821
  2. 2d ago Changed · +8 lines · +206 tokens per session 0bb627715198
  3. 3d ago Changed · +970 lines · +20,911 tokens per session df99d0843a57
  4. 7d ago First seen · 457 lines · 8,379 tokens per session scan A a4bdcb56b8cd

Subscribe to this mod's changes

SuperRAN CLAUDE.md is an instructions file published in the GitHub repository TianLin0509/SuperRAN (2 stars, last pushed yesterday), licensed MIT. It adds 37,402 tokens to every session, about $0.1870 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens