DESIGN.md@agent-pluginA
DESIGN.md@agent-plugin from labs21-dev/agents-stack is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add labs21-dev/agents-stack/agent-plugin/DESIGN.md@git:20260918.f8cebc6Pins git:20260918.f8cebc6 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- labs21-dev/agents-stack
- Path
agent-plugin/DESIGN.md- Versions recorded
- 2
- Latest version
- git:20260918.f8cebc6, committed Sep 18, 2026
- First version recorded
- Sep 15, 2026
- Size
- 20,946 bytes
- Repository stars
- 27
- License
- none declared
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
# Design — agent-plugin > 狀態：設計稿 v0.2（2026-09-12），供實作前審閱。 > 定位：給本地 agent 用的能力型 skills pack，不是單一 mega-skill。 > 2026-09-16：4.6 `agent-memory` 已對齊 markdown 協定，不再使用 SQLite / vector。 ## 0. 目標與邊界 ### 目標 - 提供八個開箱即用的本地 agent 能力： 1. `generate-image` 2. `generate-video` 3. `read-image` 4. `read-video` 5. `read-audio` 6. `agent-memory` 7. `generate-text` 8. `generate-audio` - 每個能力都是獨立 skill，可單獨安裝、單獨觸發、單獨升級。 - 共用一套 runtime adapter 與 storage schema，避免七份重複邏輯。 - **Phase 1 provider 明確鎖定 OpenRouter**，先完成 image / video / audio endpoint 對接，再開放其他 provider。 - 支援三種部署形態： 1. **Skills-only**：只放 `SKILL.md`，agent 直接讀。 2. **Plugin pack**：包成 `.codex-plugin` / marketplace entry。 3. **MCP server**：把能力暴露成 tools，給支援 MCP 的 agent 使用。 ### 非目標 - 不綁定任何單一 agent runtime。 - 不把所有能力塞進一個巨型 prompt。 - 不預設必須上雲。預設 local-first，雲端只是 adapter。 - 不做通用 agent framework，只做「能力 + 檔案 + 狀態」的最小可交付層。 ## 1. 設計原則 1. **能力獨立，基礎共用** - 七個 skill 各自獨立，方便單獨觸發。 - storage / provider / policy 共用，避免重複。 2. **Local-first** - 媒體讀取、記憶優先使用本地工具。 - 只有需要更強生成或理解時，才經 provider adapter 呼叫雲端。 3. **可驗收輸出** - 每個 skill 都有固定輸出契約。 - 生成類輸出檔案 + metadata。 - 理解類輸出結構化觀察 + 引用。 4. **可替換 provider** …
Read the whole file at its exact version.
How to install
mdr add labs21-dev/agents-stack/agent-plugin/DESIGN.md@sha256:32da48d36da09564The line at the top of this page pins the label git:20260918.f8cebc6, 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.
[](https://markdownregistry.com/a/art_bj2rjh54xhugbgh3)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Sep 15, 2026 and Sep 18, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260918.f8cebc6 latest | 2026-09-18 | f8cebc6 | 20,946 B | A | view · diff |
| git:20260915.ee027f0 | 2026-09-15 | ee027f0 | 19,604 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (20946 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
labs21-dev/agents-stack · 27 stars · license none declared · pushed 2026-09-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_bj2rjh54xhugbgh3 GET https://markdownregistry.com/api/v1/resolve?ref=labs21-dev/agents-stack/agent-plugin/DESIGN.md GET https://markdownregistry.com/api/v1/blob/32da48d36da09564e3fac65bf35a112986644a5f329e4cc49f3e88de011f2919
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.