MobileVC CLAUDE.md

MobileVC CLAUDE.md is an instructions file for coding agents from JayCRL/MobileVC. It costs 684 tokens per session, scanned A, original, MIT.

A Chinese-language CLAUDE.md instruction file for MobileVC, covering its backend, Flutter mobile app, build process, deployment, and rules for coordinating changes between the two sides. Flutter is a toolkit for building mobile applications.

In plain words
What is it for?
Use it when changing MobileVC's Go backend, Flutter app, notifications, WebSocket communication, session handling, runtime, or backend-to-mobile protocols.
Why use it?
It helps agents avoid inconsistent backend and mobile changes and lists the required checks, restart steps, deployment process, and protected core modules.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/jaycrl/mobilevc/claude-md
Clone the repo
git clone --depth 1 https://github.com/JayCRL/MobileVC

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 MobileVC CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jaycrl/mobilevc/claude-md.svg)](https://agentmods.dev/instructions/jaycrl/mobilevc/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/jaycrl/mobilevc/claude-md"><img src="https://agentmods.dev/badge/instructions/jaycrl/mobilevc/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 684 This file is loaded in full into every session.
When invoked 684 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.00684 $0.00684
Opus 5 $0.00342 $0.00342
Sonnet 5 $0.00137 $0.00137
Haiku 4.5 $0.00068 $0.00068

Measured 4d ago against content hash 7a11edf88c03, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

MobileVC 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 4d ago.

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 · 69 lines

What it actually says

MobileVC 项目规则

代码改动与编译

后端改动流程

  1. 在项目根目录执行编译:go build -o server ./cmd/server
  2. 停止旧进程:pkill -f './server'
  3. 启动新进程(必须带完整环境变量):
AUTH_TOKEN="test-token-12345" \
APNS_AUTH_KEY_PATH="/Users/wust_lh/AuthKey_UUZWBMP5Z5.p8" \
APNS_KEY_ID="UUZWBMP5Z5" \
APNS_TEAM_ID="4YFXZ5X5YJ" \
APNS_TOPIC="com.justprove.mobilevc" \
APNS_PRODUCTION="false" \
nohup ./server > server.log 2>&1 &
  1. 验证启动成功:检查 server.log 确认看到 APNs service readyReady: addr=:8001

Flutter 改动流程

  1. 编译检查
  2. 打包上传 iOS OTA:调用 /ios-ota-deploy skill 或直接执行 source ~/.zshrc && mobilevc-ota
  3. 详细流程参考 memory 中的 ios_ota_build_workflow.md

改动范围原则

  • 只改动后端 → 只重启后端
  • 只改动 Flutter → 只打包上传 iOS
  • 同时改动两端 → 分别执行各自的流程

核心稳定区

以下模块是与 Claude 交互的核心逻辑,改动前必须:

  1. 先查 memory 和 CONTEXT.md
  2. 理解现有实现
  3. 不确定时先问用户

核心模块

  • internal/session/ - 会话管理和控制器状态
  • internal/runner/ - 命令执行和 Claude 交互
  • internal/ws/ - WebSocket 处理和协议通信
  • internal/runtime/ - 运行时管理

前后端对接规则

涉及 Flutter 端与后端对接的功能改动时

  1. 必须读两端的代码
  2. 理解对接方式(协议、数据结构、事件流)
  3. 确保改动后两端协议一致

代码理解原则

当不知道具体的代码逻辑时

  • 必须先问用户
  • 不要想当然或猜测实现
  • 先读代码理解现有逻辑,不确定时再问

Git 提交规则

  • 可以自动 commit 到本地仓库
  • push 到 GitHub 远程仓库前必须经过用户确认
  • 提交时排除 .claude/worktrees/ 等环境噪音

遇到不确定的情况

  • 代码逻辑不清楚 → 先问用户
  • 改动方案有多种选择 → 先问用户
  • 编译/启动失败 → 报告错误,等待用户指示
  • 涉及核心稳定区 → 先查 memory,不确定时问用户
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. 4d ago First seen · 69 lines · 684 tokens per session scan A 7a11edf88c03

Subscribe to this mod's changes

MobileVC CLAUDE.md is an instructions file published in the GitHub repository JayCRL/MobileVC (209 stars, last pushed 2mo ago), licensed MIT. It adds 684 tokens to every session, about $0.0034 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-30.