DESIGN.mdA

DESIGN.md from qihangzhang-272/asl-harness is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add qihangzhang-272/asl-harness/DESIGN.md@git:20261013.5c6f5aa

Pins git:20261013.5c6f5aa in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
qihangzhang-272/asl-harness
Path
DESIGN.md
Versions recorded
1
Latest version
git:20261013.5c6f5aa, committed Oct 13, 2026
Size
2,724 bytes
Repository stars
5
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

# ASL Workspace 视觉约定

2026-10-13。适用于本机与跨平台桌面工作台;用户已授权参考 Apple/Google 校准审美。首轮先统一颜色与关键流程,整体操作直觉由后续用户反馈继续校准。

## 方向

浅色中性表面、清楚的文字层级、单一蓝色操作强调。页面属于任务型工具(Operate):先让资料、关系和状态易读,再表达品牌。保持已有导航、业务内容、React/CSS 与 Lucide 图标。

Taste 参数按桌面任务场景收敛为设计变化 3、动效 2、信息密度 5。系统字体承载全部界面;不添加展示字体、连续动画或装饰玻璃层。

## 颜色角色

| 角色 | 值 | 用途 |
|---|---|---|
| 画布 | `#f5f5f7` | 主工作区底色 |
| 内容表面 | `#ffffff` | 内容、表单与浮层 |
| 次级表面 | `#f0f1f3` | 侧栏、工具区 |
| 主文字 | `#1d1d1f` | 标题、正文、主要标签 |
| 次级文字 | `#51545b` | 用途、辅助说明 |
| 辅助文字 | `#62666f` | 来源、时间、数量 |
| 操作蓝 | `#2e66ce` | 主操作、选中与焦点 |
| 操作深蓝 | `#245bc2` | 悬停、强调文字 |
| 选中底色 | `#eaf0fb` | 蓝色关联状态 |
| 边框/分隔 | `#d3d5d9`/`#e7e8eb` | 结构分隔 |
| 成功 | `#21684b`/`#eaf6ee` | 核对通过;同时保留文字标签 |
| 警告 | `#805312`/`#fff7e6` | 待处理与冲突;同时提供恢复操作 |
| 错误 | `#a93632`/`#fdf0ef` | 失败与完整诊断入口 |

复用已有 CSS 变量,不增设第二套主题系统。蓝色用于行动与选中;大面积背景保持中性。浮层用轻阴影表达层级,普通内容以边框或间距组织。

## 可读性与操作

- 正文及辅助文字对比度至少 4.5:1;焦点、重要图形与控件识别至少 3:1。
- 标题保持适度字号,表单使用原生语义和持续可见的焦点。
- 画板全图用于看关系,原始大小用于读文字;缩放和复位不改业务文档。
- 冲突先解释阻断原因,再提供现有范围/位置选择;所有路径继续走原有核心预检。
- 动效只表示状态,尊重减少动态效果设置。状态同时使用文字和图标,不仅依赖颜色。

## 参考与边界

- [Apple HIG:Color](https://developer.apple.com/design/human-interface-guidelines/color):克制强调、一致语义、可读性与非颜色线索。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add qihangzhang-272/asl-harness/DESIGN.md@sha256:cd2f829cf09e2f04

The line at the top of this page pins the label git:20261013.5c6f5aa, 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_euuejmjlxxdob44y.svg)](https://markdownregistry.com/a/art_euuejmjlxxdob44y)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 13, 2026.

versioncommittedcommitsizeaudit
git:20261013.5c6f5aa latest2026-10-13 5c6f5aa 2,724 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 (2724 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

qihangzhang-272/asl-harness · 5 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_euuejmjlxxdob44y
GET https://markdownregistry.com/api/v1/resolve?ref=qihangzhang-272/asl-harness/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/cd2f829cf09e2f04847dfbf5c5243ed0897a4ee8fbfdacc05e1a74f552ba024c

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 qihangzhang-272/asl-harness

AGENTS.md AGENTS.md file
qihangzhang-272/asl-harness · AGENTS.md
git:20261022.68eb31e · audit A · 5 stars
product-analysis SKILL.md skill
qihangzhang-272/asl-harness · examples/personal-environment/skills/product-analysis/SKILL.md · 结合材料解释一个产品是什么、为什么重要以及仍有哪些不确定性
git:20260830.50a3176 · audit A · 5 stars
source-research SKILL.md skill
qihangzhang-272/asl-harness · examples/personal-environment/skills/source-research/SKILL.md · 从可追溯来源形成一份结构清楚的事实材料包
git:20260830.50a3176 · audit A · 5 stars
asl-environment SKILL.md skill
qihangzhang-272/asl-harness · plugins/asl-environment-host/skills/asl-environment/SKILL.md · 当用户要初始化、检查、维护或演化 ASL Environment,接入外部能力,修改 Skill 或 Mode,刷新能力地图,切换宿主投影,或导出 DeepSeek Agent Preset 时使用
git:20261002.fdd1d20 · audit A · 5 stars

Every file in qihangzhang-272/asl-harness

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20261104.2ff2d3b · audit A · 140,694 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261105.56517dd · audit A · 111,624 stars
DESIGN.md DESIGN.md file
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
git:20260721.d7d1027 · audit A · 106,186 stars
DESIGN.md DESIGN.md file
tt-a1i/archify · DESIGN.md · A precise, vivid technical instrument for trustworthy interactive architecture maps.
git:20260817.a0bc059 · audit A · 94,561 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 80,701 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20261102.a500029 · audit A · 53,286 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,587 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261105.74b7c70 · audit A · 24,407 stars

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