AGENTS.md@docsA

AGENTS.md@docs from bluechonk/modelmux is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add bluechonk/modelmux/docs/AGENTS.md@git:20261105.36a6b70

Pins git:20261105.36a6b70 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
bluechonk/modelmux
Path
docs/AGENTS.md
Versions recorded
3
Latest version
git:20261105.36a6b70, committed Nov 5, 2026
First version recorded
Nov 2, 2026
Size
6,232 bytes
Repository stars
11
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# docs/AGENTS.md —— 文档标准

本文件定义本仓库文档的分层、事实归属、写作规则与审稿清单。根 [AGENTS.md](../AGENTS.md)
只保留落点与登记红线;代码注释规范见 [MODULE-COMMENTS.md](./MODULE-COMMENTS.md) 与
[CODE-COMMENTS.md](./CODE-COMMENTS.md)。

## 1. 分层:一个事实一个家

每类事实只有一个 home;其他地方只写一句话摘要 + 相对链接,不复述细节。

| 层 | 位置 | 职责 | 不放什么 |
| --- | --- | --- | --- |
| 常驻规则 | 根 `AGENTS.md` | 每个会话都必须进上下文的红线,每条 1–3 行 | 教程、完整清单、实测记录、能从链接读到的细节 |
| 文档标准 | `docs/AGENTS.md` | 分层、归属、写作与审稿规则 | 具体契约(→ 各规范文档) |
| 索引 | `docs/README.md` | 每份文档一句话用途 + 链接 | 状态注解、实现细节、重复规则 |
| 契约与规范 | `docs/CONTRACT-TS.md` 等 | 当前设计、接口、命令形态、存储 / 日志 / Web 规则 | 变更史、设计取舍(→ 设计依据文档)、进度 |
| 设计依据 | `docs/ACCOUNT-CIRCUIT.md` 等 | 为什么这样做、放弃了什么、实测证据;规则收敛后指向 owning doc | 重复的现行规则 |
| 渠道协议 | `docs/channels/<cid>/PROTOCOL.md` | 上游协议事实与证据等级 | 共享层规则、实现细节 |
| 状态快照 | `docs/PROGRESS.md` | 当前版本、渠道状态、已知边界 | 契约条文 |
| 门面 | 根 `README.md` | 项目是什么、怎么开始、去哪找文档 | 详细交互规则、契约细节 |
| 流程 | `.agents/skills/<name>/SKILL.md` | 多步操作流程与验收清单 | 单点事实(→ `docs/`) |

## 2. 写作规则

1. **只写当前状态**:历史、变更过程、为什么改,属于 git / PR / 设计依据文档;正文不写
   「以前是……现在改为……」或「本次修改」。
2. **一个事实一个家**:同一条规则出现第二遍就是漂移源。保留最靠近该事实的文档,其他位置
   写一句摘要 + 链接。
3. **索引只写用途**:`docs/README.md` 的表格行是一句话导航,不写「已实施 / 已收敛 / 待实施」。
   设计依据文档顶部允许一行状态(是否已收敛、收敛到哪里);当前能力与进度统一看
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bluechonk/modelmux/docs/AGENTS.md@sha256:14d5d7a999804ef7

The line at the top of this page pins the label git:20261105.36a6b70, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fy3zg7cmazna7er6.svg)](https://markdownregistry.com/a/art_fy3zg7cmazna7er6)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Nov 2, 2026 and Nov 5, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261105.36a6b70 latest2026-11-05 36a6b70 6,232 BA view · diff
git:20261103.dcfe9522026-11-03 dcfe952 6,165 BA view · diff
git:20261102.d2bbb082026-11-02 d2bbb08 5,872 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (6232 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bluechonk/modelmux · 11 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fy3zg7cmazna7er6
GET https://markdownregistry.com/api/v1/resolve?ref=bluechonk/modelmux/docs/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/14d5d7a999804ef7c290c60522ac84a0f6fc58ff4525dcf56e4561eea9eeb568

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from bluechonk/modelmux

claude-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/claude-mx-test/SKILL.md · 用 Claude Code 对 modelmux(mx)网关做端到端测试(Anthropic Messages 协议,/v1/messages + count_tokens)。适用于:用 claude 测 mx、claude code…
git:20261107.0bf381d · audit B · 11 stars
codex-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/codex-mx-test/SKILL.md · 用 Codex CLI 对 modelmux(mx)网关做端到端测试(OpenAI Responses 协议,/v1/responses)。适用于:用 codex 测 mx、codex 接入 modelmux、验证…
git:20261107.0bf381d · audit B · 11 stars
dsh-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/dsh-mx-test/SKILL.md · 用 dsh(DeepSeek Harness)ACP 协议对 modelmux(mx)网关做端到端模型测试。适用于:用 dsh 测 mx、dsh 接入 modelmux、网关端到端验收、换 harness 复测模型、dsh…
git:20261106.f07736d · audit B · 11 stars
log-triage SKILL.md skill
bluechonk/modelmux · .agents/skills/log-triage/SKILL.md · modelmux 的日志排查与故障分诊流程。只要用户问“为什么这么慢 / 为什么失败 / 超时 / 卡住 / 网关挂了 / 日志在哪 / 怎么排查 / 看下日志”,或提到 request id、慢请求、502/503、stale…
git:20261106.f07736d · audit A · 11 stars
mx-cli SKILL.md skill
bluechonk/modelmux · .agents/skills/mx-cli/SKILL.md · modelmux 的 mx CLI 使用手册。用户要运行/查询/配置 mx(启动、重启、状态、模型、登录、账号池、额度、日志、Web 控制台、path),或不确定动词与渠道参数的顺序、该用 mx model list 还是 mx…
git:20261107.bc11d30 · audit B · 11 stars
repo-sync SKILL.md skill
bluechonk/modelmux · .agents/skills/repo-sync/SKILL.md · modelmux 仓库的收尾与同步流程:把一轮代码改动同步到 docs 文档、规划进度与 commit 历史,并在需要上线时走完分支 → PR → CI → squash merge → 删分支的闭环。用户说「收尾」「同步文档」「更新…
git:20261105.29cf971 · audit A · 11 stars
zcode-session-archaeology SKILL.md skill
bluechonk/modelmux · .agents/skills/zcode-session-archaeology/SKILL.md · 按 session id 或项目路径还原另一个 ZCode 会话做了什么(模型、轮次、工具调用、错误、最终结论、产物),用于多会话并行改同一个项目时的对齐、排查与收尾。当用户提到「另一个会话」「session_xxx /…
git:20261025.1f96581 · audit A · 11 stars
AGENTS.md AGENTS.md file
bluechonk/modelmux · AGENTS.md
git:20261107.bd0e3d9 · audit A · 11 stars
AGENTS.md@packages/core/channels/catpaw AGENTS.md file
bluechonk/modelmux · packages/core/channels/catpaw/AGENTS.md
git:20261019.f7f08e1 · audit A · 11 stars

Every file in bluechonk/modelmux

Other files named AGENTS.md@docs

AGENTS.md@docs AGENTS.md file
heygen-com/hyperframes · docs/AGENTS.md
git:20260804.da35679 · audit A · 80,701 stars
AGENTS.md@docs AGENTS.md file
code-yeongyu/oh-my-openagent · docs/AGENTS.md
git:20261024.784ea6a · audit A · 70,763 stars
AGENTS.md@docs AGENTS.md file
yeachan-heo/oh-my-claudecode · docs/AGENTS.md
git:20260311.fc226e7 · audit A · 40,624 stars
AGENTS.md@docs AGENTS.md file
nocobase/nocobase · docs/AGENTS.md
git:20261018.90e5a99 · audit A · 24,860 stars
AGENTS.md@docs AGENTS.md file
nyldn/claude-octopus · docs/AGENTS.md
git:20260830.f9b8c92 · audit A · 4,409 stars
AGENTS.md@docs AGENTS.md file
atomicstrata/llm-wiki-compiler · docs/AGENTS.md
git:20260615.c4df988 · audit A · 2,245 stars
AGENTS.md@docs AGENTS.md file
borghei/claude-skills · docs/AGENTS.md
git:20260321.efcc8a3 · audit A · 1,075 stars
AGENTS.md@docs AGENTS.md file
jasonxudeveloper/nino · docs/AGENTS.md
git:20261101.f97b4dc · audit A · 653 stars

Browse by kind, by grade A, or by owner.