DESIGN.md@stagesA

DESIGN.md@stages from wenyuchiou/awesome-agentic-ai-zh is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add wenyuchiou/awesome-agentic-ai-zh/stages/DESIGN.md@git:20261029.69ac45e

Pins git:20261029.69ac45e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
wenyuchiou/awesome-agentic-ai-zh
Path
stages/DESIGN.md
Versions recorded
21
Latest version
git:20261029.69ac45e, committed Oct 29, 2026
First version recorded
Aug 30, 2026
Size
75,644 bytes
Repository stars
8,548
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

# Stage 設計筆記

> 給 maintainer 的內部文件,不是讀者面向的內容。
>
> 為什麼是 8 個 stage、每個 stage 結構為什麼這樣切、動手練習 為什麼必跑、self-check 怎麼設計——這些設計決定的記錄。

---

## 全站唯一學習順序

- 共用基礎:`Stage 0 → Stage 1 → Stage 2`。
- Track A 建議順序:`A1 → A2 → Stage 5(只讀 Track A 核心 5.1–5.4)→ A3 → Stage 8`。
- Track B:`Stage 3 → Stage 4 → Stage 5 → Stage 6 → Stage 7 → Stage 7.5 → Stage 8`。
- Track A 做完 A3 就能開始 Capstone;Stage 8 建議完成,但不擋入場。

README、PROGRESS、CAPSTONE、章節頁首、章末下一站與路線圖必須使用同一順序。先改可存取的文字與測試,再重畫圖片;圖片不能成為唯一導航。

### 主 README 的固定閱讀形狀

- README 是入口,不是另一章教材。可見主線固定為「一句話定位 → 三個立即起點 → Track 選擇 → 完整文字路線 → 五條角色路線 → 五步學法 → 精選學習入口 → 貢獻/重要啟發/License」。圖片只整理關係,不能取代文字導航。
- 全站順序必須直接可見:共用 `Stage 0 → 1 → 2`;Track A 是 `A1 → A2 → Stage 5(5.1–5.4)→ A3 → Stage 8`;Track B 是 `Stage 3 → 4 → 5 → 6 → 7 → 7.5 → 8`。Stage 4 與 Stage 7 使用本文件固定的完整章名。
- README 不重複章節內的五層工程解釋、完整工具清單或易變的 project/練習數量。定位只說「學習路線圖 + 精選資源 + 小型示範」;八個正式 Stage 是 1–8,Stage 0 是可跳過的準備入口,Stage 7.5 是進階 reading map。
- Track、Stage、角色路線、Capstone、學習方法、10 個精選學習入口、五星優先順序、重要啟發與聯絡保持可見。10 個入口使用三個真正的 HTML rowgroup,`rowspan` 為 `3/3/4`;星等表示學習優先順序,不是 GitHub 排名。
- 只有本機下載、完整時程/Hub 說明、完整貢獻方式、貢獻者/引用使用四個預設關閉的 `<details markdown="1">`。不能用收合保留重複段落;重複內容要合併或移到專門頁面。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wenyuchiou/awesome-agentic-ai-zh/stages/DESIGN.md@sha256:dfe52d5f204256df

The line at the top of this page pins the label git:20261029.69ac45e, 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_i3ttm5rxcfnvtxcz.svg)](https://markdownregistry.com/a/art_i3ttm5rxcfnvtxcz)

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

Versions

The registry has recorded 21 versions of this file, between Aug 30, 2026 and Oct 29, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261029.69ac45e latest2026-10-29 69ac45e 75,644 BA view · diff
git:20261029.8dd4e502026-10-29 8dd4e50 74,415 BA view · diff
git:20261028.8f63d2a2026-10-28 8f63d2a 73,063 BA view · diff
git:20261026.571cb7b2026-10-26 571cb7b 72,411 BA view · diff
git:20261015.56059752026-10-15 5605975 72,025 BA view · diff
git:20261015.1bcb5de2026-10-15 1bcb5de 71,492 BA view · diff
git:20261015.44857492026-10-15 4485749 71,492 BA view · diff
git:20261013.7119be12026-10-13 7119be1 71,480 BA view · diff
git:20261002.a23fbb72026-10-02 a23fbb7 71,480 BA view · diff
git:20260914.c1d71ad2026-09-14 c1d71ad 71,480 BA view · diff
git:20260914.5d504ca2026-09-14 5d504ca 71,007 BA view · diff
git:20260913.6708b0f2026-09-13 6708b0f 71,358 BA view · diff
git:20260913.c134a842026-09-13 c134a84 71,301 BA view · diff
git:20260913.b97eb7a2026-09-13 b97eb7a 71,228 BA view · diff
git:20260910.ef22dfa2026-09-10 ef22dfa 69,324 BA view · diff
git:20260910.20dc3fb2026-09-10 20dc3fb 68,279 BA view · diff
git:20260831.07abf272026-08-31 07abf27 66,758 BA view · diff
git:20260831.a1ec9982026-08-31 a1ec998 65,929 BA view · diff
git:20260831.4a363392026-08-31 4a36339 64,830 BA view · diff
git:20260830.befbb322026-08-30 befbb32 63,927 BA view · diff
git:20260830.59f4a5c2026-08-30 59f4a5c 62,358 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 (75644 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

wenyuchiou/awesome-agentic-ai-zh · 8,548 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i3ttm5rxcfnvtxcz
GET https://markdownregistry.com/api/v1/resolve?ref=wenyuchiou/awesome-agentic-ai-zh/stages/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/dfe52d5f204256dfee0bc24ce25acec63277efa6bd7fe4aebafd1f99a19d7350

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 wenyuchiou/awesome-agentic-ai-zh

CLAUDE.md CLAUDE.md file
wenyuchiou/awesome-agentic-ai-zh · CLAUDE.md
git:20261008.491ceca · audit A · 8,548 stars
DESIGN.md@branches DESIGN.md file
wenyuchiou/awesome-agentic-ai-zh · branches/DESIGN.md
git:20261023.8bbdd43 · audit A · 8,548 stars
tool-calling-tutor SKILL.md skill
wenyuchiou/awesome-agentic-ai-zh · examples/stage-5/tool-calling-tutor/SKILL.md · Use when a tool-calling agent does not call a tool, sends wrong arguments, loops without stopping, or needs a function…
git:20260828.39e461d · audit A · 8,548 stars

Every file in wenyuchiou/awesome-agentic-ai-zh

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