briefbound-adr SKILL.md skillA
briefbound-adr from ccdawn/codex-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ccdawn/codex-skills/briefbound-adr@git:20260929.20085bbPins git:20260929.20085bb in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ccdawn/codex-skills
- Path
skills/engineering/briefbound-adr/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260929.20085bb, committed Sep 29, 2026
- Size
- 4,281 bytes
- Repository stars
- 6
- License
- MIT
Use when the user asks to record a settled architecture or technology decision as an ADR（写 ADR、记录决策、技术选型定案存档）, or a "why" trail is needed for a chosen design, an old decision must be superseded, or new work conflicts with a prior decision; do not use for options still under discussion, project status snapshots, or README writing.
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
# Briefbound ADR 决策记录 ## 目标 把已拍板的架构/技术决策落成可追溯的 ADR：为什么这么定、放弃过哪些选项、带来什么后果。MADR 风格（背景、决策、备选方案、后果）＋状态流转与决策债务提示，让未来维护者读到"当时为什么"，而不是只有"现在是什么"。 ## Briefbound task contract - Context Boundary: 定案决策及其动机、被否选项、相关会话结论与 git diff、项目 ADR 目录约定（默认 `docs/adr/`）；不重做方案设计。 - Output Contract: 单条 ADR（编号、状态、日期、背景、决策、备选方案、后果）+ 索引更新 + 状态流转记录 + Route Out。 - Allowed Action: 直接写 `docs/adr/`（或项目约定目录）下的 markdown；读 git diff、会话与既有文档取证；不改业务代码。 - Success Evidence: 决策、背景、备选、后果四要素齐备且可溯源；索引计数与条目一致；superseded 条目互链新旧。 - Stop Condition: 方案未拍板、事实源不足无法还原动机、或用户要的是状态盘点而非决策留痕。 - Route Out: 未拍板讨论回 `briefbound-planning`；状态快照归 `briefbound-project-memory`；验证后残留 `briefbound-development-cleanup`；`briefbound-router` 或 BLOCKED。 ## 统一调用契约 - 只处理 Briefbound task contract 范围；不匹配回 `briefbound-router` 或更具体 owner，复合任务不吞其他 owner。 - 用户可见内容默认中文、保留技术字面量；Route Out 仅以 Briefbound task contract 为准；有自然闸门（需用户裁决、批准或被阻塞）时末行 `下一步建议: <一个具体动作>`，否则声明继续已授权工作。 ## 激活闸门 任一：用户要求记录决策或写 ADR；技术选型刚定案要存档；"为什么这么设计"需要留痕；要 supersede 旧决策；新工作与已接受决策冲突需梳理。排除：仍在讨论未拍板（回 `briefbound-planning` 或 `briefbound-router`）、项目状态盘点（`briefbound-project-memory`）、契约设计本身（`briefbound-api-contract`）。 ## 记录方法 …
Read the whole file at its exact version.
How to install
mdr add ccdawn/codex-skills/briefbound-adr@sha256:878d16af779138e9The line at the top of this page pins the label git:20260929.20085bb, 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_yn6pmg2mt3cxyxdt)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 29, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4281 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
ccdawn/codex-skills · 6 stars · license MIT · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yn6pmg2mt3cxyxdt GET https://markdownregistry.com/api/v1/resolve?ref=ccdawn/codex-skills/briefbound-adr GET https://markdownregistry.com/api/v1/blob/878d16af779138e9b5d6ab9df163ce3a42f63680ee50a0b4c7e20688a4a129af
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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.