DESIGN.md@docsA

DESIGN.md@docs from baixinghao/intent-gate is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add baixinghao/intent-gate/docs/DESIGN.md@git:20261013.89f945f

Pins git:20261013.89f945f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
baixinghao/intent-gate
Path
docs/DESIGN.md
Versions recorded
4
Latest version
git:20261013.89f945f, committed Oct 13, 2026
First version recorded
Aug 10, 2026
Size
15,590 bytes
Repository stars
3
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

# 意图对齐子系统设计

> 定位:**群体意图对齐引擎**。需求分析的确定性能力下沉为 MCP 工具,
> 意图断层按「代码实证 → AI 公示推断 → 人工拍板」三级漏斗消解。
> 红蓝对抗评审与调度永远留在宿主 agent 层,不进本 MCP;
> 钉钉传输层(群通道 + 阻塞闸门)剥离为姊妹篇 intent-gate-service(独立 MCP 服务)。
>
> 认识论地基(意图置信度为什么可行)见
> [../README.md](../README.md)「意图置信度从哪来」一节——
> **置信度是图的属性,不是模型的属性**:本文档的一切机械门禁都是该命题的工程化。

## 1. 背景与边界

### 1.1 为什么做 MCP 而不是 agent 二开

- agent 是入口,入口抢不过 Claude Code 等宿主;MCP 是插座,谁都能插。
- 意图对齐、置信度门禁这类 harness 能力要推广,唯一出路是可插拔形态。

### 1.2 分工铁律

| 留在本 MCP(轻量、确定性) | 留在宿主/应用层 |
|---|---|
| 型态判定、歧义点扫描、图表规范、lint、DDL 提取 | 多轮问答对话编排 |
| 意图断层的登记/落盘/对账(对话框兜底通道) | 红蓝对抗评审、findings 冲突裁决 |
| 闸门生命周期文件(checklist / alignment-log 供货) | owner 路由与任务分派 |

| 剥离到姊妹篇 intent-gate-service(重、可选) |
|---|
| 钉钉出站/入站(群通道传输层)、阻塞式决策闸门 ask_human |

- 🔴 红蓝对抗不做进本 MCP。烧 token 是次要原因;根本原因是蓝军有效性依赖
  **信息节食**(独立 session、信息不对称),同一进程内做评审会把对抗退化成自查。
  v0.2.0 起以**插件可选 skill**(`skills/red-blue-review/`)形态随插件分发:
  纯 playbook(检查项/findings 模板/熔断规则),调度与裁决永远在宿主层,
  机械基线复用 `lint_summary`,不新增任何 MCP 工具。
- 🔴 钉钉交互剥离的原因:**卡用户**(ask_human 阻塞等人工,客户端超时配置
  不当即炸)+ **太重**(fastapi/uvicorn/cryptography/httpx 全是钉钉依赖)。
  两个服务用 `.harness/requests/{需求名}/_review/` 文件契约衔接:
  intent-gate-service 复用 intent_gate 的 `register_question`/`file_inbound_reply`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add baixinghao/intent-gate/docs/DESIGN.md@sha256:2e0eed2c28a50de5

The line at the top of this page pins the label git:20261013.89f945f, 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_ldesdwsxyouyp37f.svg)](https://markdownregistry.com/a/art_ldesdwsxyouyp37f)

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

Versions

The registry has recorded 4 versions of this file, between Aug 10, 2026 and Oct 13, 2026, about one every 22 days.

versioncommittedcommitsizeaudit
git:20261013.89f945f latest2026-10-13 89f945f 15,590 BA view · diff
git:20260814.1b713332026-08-14 1b71333 15,276 BA view · diff
git:20260812.54dc0632026-08-12 54dc063 14,208 BA view · diff
git:20260810.84c9c1e2026-08-10 84c9c1e 14,207 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 (15590 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

baixinghao/intent-gate · 3 stars · license MIT · pushed 2026-10-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ldesdwsxyouyp37f
GET https://markdownregistry.com/api/v1/resolve?ref=baixinghao/intent-gate/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/2e0eed2c28a50de5c78b315b9d4c13ce57ec08c9fb623a94f543d4886c41e1bf

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 baixinghao/intent-gate

contract-coding SKILL.md skill
baixinghao/intent-gate · skills/contract-coding/SKILL.md · Use when implementing or modifying code for a requirement (实现需求/编码/写代码/开工) that has an intent-gate contract…
git:20261014.5d8eed4 · audit A · 3 stars
red-blue-review SKILL.md skill
baixinghao/intent-gate · skills/red-blue-review/SKILL.md · Use when the user asks for 红蓝对抗 / 蓝军评审 / 对抗评审 / 需求评审 (adversarial review of a requirement analysis), when the user asks…
git:20260810.957fd09 · audit A · 3 stars
requirement-alignment SKILL.md skill
baixinghao/intent-gate · skills/requirement-alignment/SKILL.md · Use when analyzing a requirement/PRD (分析需求/解析需求/解析PRD/分析PRD), building state machines (画状态机), sequence diagrams (时序图)…
git:20261013.89f945f · audit A · 3 stars
using-intent-gate SKILL.md skill
baixinghao/intent-gate · skills/using-intent-gate/SKILL.md · Use when analyzing requirements/PRDs, resolving business-rule ambiguity or conflicting requirements, making…
git:20261025.e05a450 · audit A · 3 stars

Every file in baixinghao/intent-gate

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 8,636 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,786 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261102.9ddec3e · audit A · 816 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 614 stars
DESIGN.md@docs DESIGN.md file
vintlin/skill-flow · docs/DESIGN.md · A compact macOS operations workspace built from layered neutral surfaces, user-selectable accents, reusable group…
beta · audit A · 264 stars
DESIGN.md@docs DESIGN.md file
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 139 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars
DESIGN.md@docs DESIGN.md file
viy1204/recruiting-copilot · docs/DESIGN.md
git:20261104.ada520e · audit A · 109 stars

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