AGENTS.md@internal/blueprintA
AGENTS.md@internal/blueprint from iohub/yagent is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add iohub/yagent/internal/blueprint/AGENTS.md@git:20261026.9762922Pins git:20261026.9762922 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- iohub/yagent
- Path
internal/blueprint/AGENTS.md- Versions recorded
- 7
- Latest version
- git:20261026.9762922, committed Oct 26, 2026
- First version recorded
- Oct 21, 2026
- Size
- 10,544 bytes
- Repository stars
- 31
- License
- Apache-2.0
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
# internal/blueprint — 仓库蓝图 > 范围：本目录内不可派生的约束。（原 `docs/repo-blueprint-design.md` v4 + §21 实施记录已不存在， > 蓝图的规格由本文件持有。）全局摘要见仓库根 `AGENTS.md` §6.4。 > 注意：`section.go:1-11` 的包文档还写着"本包只做 R1 的骨架"，与 R1–R6 已落地不符——那是注释过期， > 不是功能缺失。 ## 边界 蓝图的**存储与算法层**：零 LLM 扫描器派生结构事实、把 `agent_exit.blueprint[]` 提交的散文折成 原子条目落盘、渲染常驻索引。不负责装配与开关（`internal/app` + `config.BlueprintEnabled()`）、 不负责 prompt 与委派、`read_blueprint` 工具本体在 `internal/tools`。 ## 硬约束 **1. 叶子包。** 只准 import 标准库 + `util` + `projectid`，由 `scripts/check_blueprint_leaf.sh` 守。 仓库读数（gitinfo）与 token 计数器（tokenutil）由装配层**做成参数传进来**： `RepoToken`（`derive.go:47-51`）、`CountTokens`（`index.go:37-39`）、Git 三项（`fold.go:60-61`）。 启用判据**不在本包**，本包也不读环境变量（`section.go:9`，I8）。 **2. 派生的不落盘，落盘的不派生。** front-matter 的计数由 Render 从正文重算（`doc.go:29-30,106-110`）； derived 段不在 `AssertedSections`（`section.go:30-39`）；模块边界由扫描器定，**模型不许造模块** （`fold.go:246-249`）。结构层不落盘 ⇒ 模型没有任何途径写坏它。 **3. fold 是确定性纯函数。** `Merge` 不碰文件系统（`fold.go:101`）；幂等靠"短 ID 由内容派生 + 段内按 `(where, claim)` 稳定排序 + 同 `module+field` 非空才覆盖"（`merge.go:12-17`，I20）。 排序漂走的后果不只是"字节变了"，还会让 provider 端前缀缓存与人类 review 同时失效。 **4. 正文逐字没变就不算一次 fold（NoOp）**（`fold.go:160-166`），`Commit` 把"全被拒收"也归 NoOp …
Read the whole file at its exact version.
How to install
mdr add iohub/yagent/internal/blueprint/AGENTS.md@sha256:c7a9aa28217f1f31The line at the top of this page pins the label git:20261026.9762922, 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.
[](https://markdownregistry.com/a/art_ygk75r6vne3msy4t)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 7 versions of this file, between Oct 21, 2026 and Oct 26, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261026.9762922 latest | 2026-10-26 | 9762922 | 10,544 B | A | view · diff |
| git:20261026.4294f0b | 2026-10-26 | 4294f0b | 10,523 B | A | view · diff |
| git:20261026.7abd946 | 2026-10-26 | 7abd946 | 10,469 B | A | view · diff |
| git:20261024.9b44441 | 2026-10-24 | 9b44441 | 10,379 B | A | view · diff |
| git:20261023.dd5a6e4 | 2026-10-23 | dd5a6e4 | 6,279 B | A | view · diff |
| git:20261022.53411ac | 2026-10-22 | 53411ac | 6,205 B | A | view · diff |
| git:20261021.9f5bf87 | 2026-10-21 | 9f5bf87 | 6,097 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (10544 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
iohub/yagent · 31 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ygk75r6vne3msy4t GET https://markdownregistry.com/api/v1/resolve?ref=iohub/yagent/internal/blueprint/AGENTS.md GET https://markdownregistry.com/api/v1/blob/c7a9aa28217f1f312faa81f292064b90a8fbb248a7d8ab301d1f4de522e65c19
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.