AGENTS.mdA

AGENTS.md from iohub/yagent is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned

mdr add iohub/yagent/AGENTS.md@git:20261103.104f21a

Pins git:20261103.104f21a in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: AGENTS.md file
Repository: iohub/yagent
Path: AGENTS.md
Versions recorded: 9
Latest version: git:20261103.104f21a, committed Nov 3, 2026
First version recorded: Oct 22, 2026
Size: 51,551 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

# Yagent Agent 开发知识库

> **本文件是 Agent 理解仓库和进行开发的标准指南。** 只收两类句子：**会改变跨模块决策的判据**，
> 和**告诉读者去哪儿查的指针**。包内"这么做会静默坏在哪里"写在 `internal/**/AGENTS.md`（17 份，
> 导览在 `internal/AGENTS.md`），模块结构与文件计数由 `internal/blueprint` 每轮派生——
> 抄进任何文档就是第二份会漂走的事实。
> **编号是契约**：`§5.x`、`§6.x`、`§8.3`、`§9.3` 与 `§11` 的 46 条坑编号被 13 份嵌套文档共 25 处
> 指回，**重排或小节改号会让那些指针全部失效**。要瘦身就在小节内部删，不要动编号。
>
> 当前状态（核对 2026-10-24）：蓝图 R1–R6、结构化并发 C1–C6、停止/继续三层 A+B+C、配置连根拔 +
> 引导向导、MCP+技能接入 均已落地。**仍待办**：`[blueprint] export_path` 没有消费者（R8 导出层与
> `/blueprint` 入口未做，别写进 `docs/config-guide.md`）。`docs/` 下只有 `config-guide.md`、
> `skills-and-mcp-*` 与本文件的设计稿是活的，`ARCHITECTURE*.md` 已知过期；旧设计稿大多已删除，
> **引用前先确认文件存在**。文件末尾由 codeseek 自动维护的注入区块除外。

---

## 目录

1 概述 · 2 技术栈 · 3 知识分层与加载 · 4 Agent 角色 · 5 工具与执行面 · 6 系统架构 ·
7 配置 · 8 开发与构建 · 9 规范与不变量 · 10 Director 行为准则 · 11 坑索引

---

## 1. 项目概述

**Yagent** 是 Go 编写的多智能体 AI 编程助手，**Hub-and-Spoke** 架构：**Director 是唯一与用户
交互的 Agent**，负责分析、委派、评审；读写由专用子 Agent 完成。接口三套（TUI / HTTP+WS /
`--prompt`），代码引擎是 `codeseek`（Rust，git submodule，经 MCP stdio 调用，二进制 `go:embed` 分发）。

五条设计原则：**单一交互点**、**职责分离**（每个子 Agent 有明确权限：只读 / 可写 / 仅 Shell）、
**强制委派**（改文件必走 Coding，探索仓库必走 Repo，Director 自己只用只读工具）、
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add iohub/yagent/AGENTS.md@sha256:64d7a0df7fbd6b61

The line at the top of this page pins the label git:20261103.104f21a, 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](https://markdownregistry.com/badge/art_k4guueh6rrpmq7ga.svg)](https://markdownregistry.com/a/art_k4guueh6rrpmq7ga)

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

Versions

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

version	committed	commit	size	audit
git:20261103.104f21a latest	2026-11-03	104f21a	51,551 B	A	view · diff
git:20261026.e51eca4	2026-10-26	e51eca4	51,369 B	A	view · diff
git:20261026.7381d71	2026-10-26	7381d71	51,350 B	A	view · diff
git:20261025.f3f1715	2026-10-25	f3f1715	50,968 B	A	view · diff
git:20261024.9b44441	2026-10-24	9b44441	50,881 B	A	view · diff
git:20261023.dd5a6e4	2026-10-23	dd5a6e4	134,654 B	A	view · diff
git:20261023.914b4e1	2026-10-23	914b4e1	134,569 B	A	view · diff
git:20261023.34d2295	2026-10-23	34d2295	134,239 B	A	view · diff
git:20261022.53411ac	2026-10-22	53411ac	129,527 B	A	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 (51551 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

iohub/yagent · 31 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k4guueh6rrpmq7ga
GET https://markdownregistry.com/api/v1/resolve?ref=iohub/yagent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/64d7a0df7fbd6b6131e7c2439cf1f2cd1be55383be6a4a0e2a3b39320d65fbdb

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.