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.

Install it, pinned
mdr add symansun/doops/backend/agent/DESIGN.md@git:20261011.9423fe8

Pins 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

The exact contents, by fingerprint
mdr add symansun/doops/backend/agent/DESIGN.md@sha256:be7e4bd1375383f4

The 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.

Badge

mdr badge

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

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

Ask from your agent
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)

versioncommittedcommitsizeaudit
git:20261011.9423fe8 latest2026-10-11 9423fe8 4,870 BA view · diff
git:20260718.93d9cc42026-07-18 93d9cc4 4,385 BA view · diff
git:20260718.01f7ba62026-07-18 01f7ba6 4,442 BA view · diff
git:20260718.532f55a2026-07-18 532f55a 4,337 BA view
Check a whole project

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

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 (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

GitHub

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.

More from symansun/doops

AGENTS.md AGENTS.md file
symansun/doops · AGENTS.md
git:20261118.7f0ac6b · audit A · 51 stars
DESIGN.md DESIGN.md file
symansun/doops · DESIGN.md
git:20261111.6a9adf3 · audit A · 51 stars
distill SKILL.md skill
symansun/doops · backend/agent/skills/distill/SKILL.md · 日志精炼和输出蒸馏专家
git:20261108.7e0598d · audit A · 51 stars
dosql SKILL.md skill
symansun/doops · backend/agent/skills/dosql/SKILL.md · DoSql 数据库变更控制助手。用于通过 doagent/CLI 对 MySQL、PostgreSQL、MongoDB 执行受控查询、变更计划、迁移脚本生成、多环境迁移和审计留痕。
git:20261118.a59c478 · audit A · 51 stars
doweb-agent SKILL.md skill
symansun/doops · backend/agent/skills/doweb/SKILL.md · DoWeb 网站发布与运维助手。用于通过 doagent 管理 Nginx 站点发布、TLS、反向代理、静态资源部署、站点健康检查、日志巡检和回滚。
git:20261119.5e6327d · audit A · 51 stars
image-build SKILL.md skill
symansun/doops · backend/agent/skills/image-build/SKILL.md · 按项目约定准备容器镜像构建配置并核对构建产物
git:20261114.cb96913 · audit A · 51 stars
k8s SKILL.md skill
symansun/doops · backend/agent/skills/k8s/SKILL.md · 用 doops 结构化工具读 Kubernetes/Helm 状态并管理 Helm release
git:20261116.55df739 · audit A · 51 stars
shell SKILL.md skill
symansun/doops · backend/agent/skills/shell/SKILL.md · 进入当前 target 的宿主机,或把结构化工具未覆盖的操作交给受审计的 exec
git:20261116.55df739 · audit A · 51 stars
doops-server SKILL.md skill
symansun/doops · backend/skills/SKILL.md · 用 doops 通过 doops-gateway 连接和操作主动注册的 doops-agent 节点。
git:20261118.a59c478 · audit A · 51 stars

Every file in symansun/doops

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