DESIGN.md@docsA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

DESIGN.md@docs from antonailog/forge-skills is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add antonailog/forge-skills/docs/DESIGN.md@git:20260427.72938ed

Pins git:20260427.72938ed in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
antonailog/forge-skills
Path
docs/DESIGN.md
Versions recorded
5
Latest version
git:20260427.72938ed, committed Apr 27, 2026
First version recorded
Apr 24, 2026
Size
30,769 bytes
Repository stars
13
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

# Forge — 设计文档 (DESIGN.md)

**版本:** v2026.04.27-fupan-report-structure
**日期:** 2026-04-27
**状态:** 已确认

---

## 迭代历史摘要

### v2026.04.27-fupan-report-structure — Fupan 复盘报告结构优化

- 最终复盘不再生成“仪表盘速览”和“会话脉络”,阅读入口从图表概览改为短叙事 + 诊断 + 知识点。
- “工作叙事”必须是短段落,不再以阶段列表、精力分布或 token 图展示。
- Prompt 诊断去掉严重度颜色,避免批改感;每条只保留“表达问题”和“低关键词版 / 进阶版”表达优化。
- “行为诊断”承接原模式诊断和决策复盘,专注用户在 AI coding 协作中的低效行为、成因和修复建议。
- 知识拓展按单个知识点组织,并统一呈现“是什么 / 怎么用 / 延伸学习”。
- 每个展开知识模块顶部强尝试增加一张学习图,帮助用户把关键知识转成可回看的视觉记忆;若图片生成失败,用待生成占位和 prompt pack 保持阅读结构。
- Workbench 用户补充反馈成为最终内容的显式约束,用来校准调研重点、解释深度和 TLDR/SOP,而不是只作为提交备注展示。
- TLDR 移到全文最后,作为复习卡,只沉淀知识、表达优化和协作 SOP。

### v2026.04.25-fupan-workbench-polish — Fupan Workbench 阅读与队列体验优化

- 首页时间统一按中国上海时区语义呈现,并在顶部显示最近刷新时间。
- 已完成复盘不再停留在顶部任务队列;用户从历史复盘区回看结果。
- “表达待优化原话”改为阅读优先的 quote block,提升字号、行高和问题/建议说明可读性。
- 详情页左侧升级为“本篇目录 + 学到的知识 + 源文件”,目录支持点击跳转。
- 无待处理任务时隐藏空任务面板,让历史复盘直接成为首页主体。
- Markdown 图片支持点击放大,用于查看仪表盘、流程图和截图细节。
- 左侧“学到的知识”改为有编号的学习地图,降低大面积蓝色标签带来的视觉噪音。
- 最终复盘正文最后增加 TLDR,让用户读完后获得可记忆、可迁移的知识、表达优化和协作 SOP。

### v2026.04.24-fupan-workbench — Fupan Workbench 本地交互式复盘学习工作台

- 新增 Fupan Workbench 设计方向:**Local Knowledge Desk**。
- 新增首页工作台与复盘详情页设计规范。
- 新增学习知识点、学习深度选择、反馈提交、历史复盘列表、Markdown 阅读详情的组件规范。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add antonailog/forge-skills/docs/DESIGN.md@sha256:eac7a8c7ce902f80

The line at the top of this page pins the label git:20260427.72938ed, 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_7v2nen4i5lhq5czo.svg)](https://markdownregistry.com/a/art_7v2nen4i5lhq5czo)

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

Versions

The registry has recorded 5 versions of this file, between Apr 24, 2026 and Apr 27, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260427.72938ed latest2026-04-27 72938ed 30,769 BA view · diff
git:20260427.b843bc22026-04-27 b843bc2 30,681 BA view · diff
git:20260425.444bf7e2026-04-25 444bf7e 29,409 BA view · diff
git:20260424.f130cad2026-04-24 f130cad 25,604 BA view · diff
git:20260424.38b4c292026-04-24 38b4c29 25,598 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 (30769 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

antonailog/forge-skills · 13 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7v2nen4i5lhq5czo
GET https://markdownregistry.com/api/v1/resolve?ref=antonailog/forge-skills/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/eac7a8c7ce902f80083994d595e3f0ca7ca4cea74925240ea7559e1b693b5ff3

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 antonailog/forge-skills

forge SKILL.md skill
antonailog/forge-skills · SKILL.md · Forge 工作流总入口。只读检测项目状态,推荐下一步该用哪个 skill,自己不干活。触发方式:用户说"forge"、"下一步"、"接下来做什么"。
git:20261010.1c72700 · audit A · 13 stars
forge-deliver SKILL.md skill
antonailog/forge-skills · _archive/2026-07-04-forge-deliver-retired/SKILL.md · 端到端交付纯编排层:调用 forge-* 子 skill 从需求一路编排到发布和文档,.deliver/state.json 检查点,支持 --auto /…
git:20260704.cb84167 · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-design-lab SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design-lab/SKILL.md · 在真实 token、真实像素的 HTML 骨架上做页面与组件的设计决策:生成可点、可改、可存的设计工作台,按七层逐节点审查,保存即导出 token 与 CSS 并回写 DESIGN.md 的 token…
git:20261010.1c72700 · audit B · 13 stars
forge-design SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design/SKILL.md · 全栈设计规划:分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG,内置可检索设计规则库(UX 规则/配色/字体),三层 Token、forge-design-lab 工作台门禁(布局/比例/密度在真 token…
git:20261010.1c72700 · audit A · 13 stars
forge-eng SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-eng/SKILL.md · 工程实现主力:管理 ENGINEERING.md,完整/轻量两模式;worktree 会话隔离、分级 TDD、验证门(证据先于断言)、任务原子化 Wave 并行、独立…
git:20261010.1c72700 · audit A · 13 stars
forge-prd SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-prd/SKILL.md · 产品诊断与 PRD 迭代:诊断根因(设计缺陷/实现偏离/PRD 遗漏),必要时反驳需求,更新 PRD 并生成带异常态门禁的 Feature Spec。 触发方式:用户说"更新PRD"、"调整需求"、"迭代PRD"、"forge-prd"、描…
git:20261010.1c72700 · audit A · 13 stars
forge-review SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-review/SKILL.md · 上线前 PR 审查。分析当前分支与基础分支的 diff,检查 SQL 安全、竞态条件、 LLM 信任边界、枚举完整性等测试捕获不到的结构性问题。发现问题直接修复。 触发方式:用户说"review"、"审查代码"、"上线前检查"、"forge…
git:20261010.1c72700 · audit A · 13 stars
forge-ship SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-ship/SKILL.md · 发布上线:PR only(建 PR 即停)或 Full ship(合并 PR + 同步本地基础分支);测试失败不发布、不 force push,状态汇报严格区分提交/推送/合并/部署。 触发方式:用户说"ship"、"发布"、"合并上线"、…
git:20261010.1c72700 · audit A · 13 stars
forge-brainstorm SKILL.md skill
antonailog/forge-skills · skills/forge-brainstorm/SKILL.md · 通用头脑风暴:4 种模式(产品/内容/构建/探索)× 6 阶段,强制前提挑战和 2-3 方案,产出可跨会话续聊的思考文档;支持 Mermaid/图辅助判断。 触发方式:用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法…
git:20260717.95d1b1c · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · skills/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-design-impl SKILL.md skill
antonailog/forge-skills · skills/forge-design-impl/SKILL.md · 设计实现:把 DESIGN.md 转成代码,只改样式不改逻辑;CSS 优先、Token 驱动、反 AI 模板、原子提交,以真实截图和 CSS 断言验证。 触发方式:用户说"实现设计"、"forge-design-impl"、设计文档确认后需…
git:20261010.cef1ea2 · audit A · 13 stars

Every file in antonailog/forge-skills

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 7,989 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,712 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261007.65a1ab4 · audit A · 765 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 625 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 · 263 stars
DESIGN.md@docs DESIGN.md file
mobileaidev/ai-app-bridge · docs/DESIGN.md
git:20261012.3200529 · audit A · 227 stars
DESIGN.md@docs DESIGN.md file
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 187 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars

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