DESIGN.md@backend/agentA
DESIGN.md@backend/agent from symansun/doops is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add symansun/doops/backend/agent/DESIGN.md@git:20261011.9423fe8Pins git:20261011.9423fe8 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- symansun/doops
- Path
backend/agent/DESIGN.md- Versions recorded
- 4
- Latest version
- git:20261011.9423fe8, committed Oct 11, 2026
- First version recorded
- Jul 18, 2026
- Size
- 4,870 bytes
- Repository stars
- 51
- 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
# doops-agent 设计
本文描述边缘 `doops-agent` 的当前职责。自然语言发布的完整 Agent 原生边界见
[`NATURAL_LANGUAGE_DEPLOYMENT.md`](../docs/NATURAL_LANGUAGE_DEPLOYMENT.md)。
## 定位
`doops-agent` 是部署在目标节点或集群中的执行网关和 doagent ACP 适配器。它暴露
WebSocket/MCP 工具、管理工作区和确定性资源边界,并把自然语言或结构化任务交给
doagent 原生 Agent 引擎。
doops-agent 不是 Agent 框架。上下文、规划、多 Agent、Skill 选择和工具调用都由
doagent 提供。
```mermaid
flowchart LR
CLIENT["CLI / Gateway"]
EDGE["doops-agent"]
ACP["doagent ACP HTTP"]
ENGINE["doagent\n多 Agent / Skill / 工具"]
WS["session workspace"]
TARGET["Host / Cluster / External systems"]
CLIENT -->|"WS / MCP"| EDGE
EDGE -->|"session/new / setMode / prompt"| ACP
ACP --> ENGINE
EDGE <--> WS
ENGINE <--> WS
ENGINE <--> TARGET
```
## 两类入口
| 入口 | 用途 | 执行者 |
| :--- | :--- | :--- |
| 确定性工具 | 明确的 shell、文件、工作区、节点信息等原子操作 | doops-agent |
| `doops_agent_prompt` | 需要现场观察、推理、Skill 或多 Agent 协作的任务 | doagent |
两类入口是独立能力,不互相充当失败 fallback。确定性工具失败时返回真实错误;Agent
任务失败时返回 doagent 或工具的真实错误。doops-agent 不把失败命令自动改写成另一条
执行路径。
## doagent 会话适配
doops-agent 通过本地 ACP HTTP 调用 `/usr/local/bin/do-agent`:
1. 首次请求调用 `session/new`,将 cwd 绑定到当前 session 工作区,并设置
`permissionMode=auto`;DoOps 的每轮 `allowedTools` 才是工具边界。
…Read the whole file at its exact version.
How to install
mdr add symansun/doops/backend/agent/DESIGN.md@sha256:be7e4bd1375383f4The line at the top of this page pins the label git:20261011.9423fe8, 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_7grabfmql4kb4ub7)
3 badge image fetches in 30 days. What the badge shows.
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry
Then ask it: what changed in symansun/doops/backend/agent/DESIGN.md since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.
Got a copy of DESIGN.md from somewhere else? Ask it: where did my DESIGN.md come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.
Versions
The registry has recorded 4 versions of this file, between Jul 18, 2026 and Oct 11, 2026, about one every 28 days.
Watch this file (sign in, one email per new version)
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261011.9423fe8 latest | 2026-10-11 | 9423fe8 | 4,870 B | A | view · diff |
| git:20260718.93d9cc4 | 2026-07-18 | 93d9cc4 | 4,385 B | A | view · diff |
| git:20260718.01f7ba6 | 2026-07-18 | 01f7ba6 | 4,442 B | A | view · diff |
| git:20260718.532f55a | 2026-07-18 | 532f55a | 4,337 B | A | view |
Installed this file, say at DESIGN.md? Drop it here to learn which saved version you have and what changed since. Your browser works out its SHA-256 fingerprint and sends only that; the file itself never leaves your computer.
Or paste its contents
Your agent can run this same check on the agent markdown files you have installed, up to 50 in one ask. Add the registry once:
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry
Then ask it to check the files you have installed. No key and no account.
From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.
sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies
In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.
sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies
No sha256sum on your machine? shasum -a 256 prints the same lines.
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (4870 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
symansun/doops · 51 stars · license MIT · pushed 2026-11-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_7grabfmql4kb4ub7 GET https://markdownregistry.com/api/v1/resolve?ref=symansun/doops/backend/agent/DESIGN.md GET https://markdownregistry.com/api/v1/blob/be7e4bd1375383f450e3fb9c85d1c3a497a5d42129d9a126d09243e60eb080c6
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: what DESIGN.md is and how agents use it · which agent file does what.