decision-log SKILL.md skillA
decision-log from ninjasln-labs/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ninjasln-labs/agent-skills/decision-log@v1.1.0Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ninjasln-labs/agent-skills
- Path
decision-log/SKILL.md- Versions recorded
- 4
- Latest version
- v1.1.0, committed Sep 29, 2026
- First version recorded
- Aug 16, 2026
- Size
- 6,996 bytes
- Repository stars
- 3
- License
- none declared
记录或检索架构决策记录（ADR）——Nygard 模板（背景/决策/后果），带 proposed/accepted/superseded/rejected 状态机，写入 docs/decisions/NNN-slug.md 并更新索引表； 若项目保有交接存储，则在其中留一条引用行。当阶段内发生语义裁定或用户说 「记录裁定」「写进决策日志」「ADR」或要查「决策 X 的现状」时使用。不适用于： 撰写会话交接本身——交接存储只引用 ADR 编号、绝不复制正文。.
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
# Decision Log（ADR 记录/查询） ## 定位 阶段内任何**语义裁定/拍板/设计裁决** → 当阶段写成 ADR（Nygard 模板），集中进 `docs/decisions/`，让「决策 X 的现状」可查询：status + 历史链（superseded 不删除）。 ## 何时使用 - 用户说「记录裁定」「这个决策写进决策日志」「ADR」 - 阶段内发生语义裁定（审计裁定、拍板项、设计裁决）——**当阶段记，不攒批** - 查询：「决策 X 的现状」「这个决定后来改了吗」 ## 触发纪律 每次语义裁定后 3 分钟内完成记录。拿不准是否够格 → 记（轻量；比漏记好——历史链靠它）。 ## 最短真实样例 **前置：** 阶段内刚发生一条裁定（如「S1.1 审计裁定：C8 按 A 案落地」）；`docs/decisions/` 已存在。 **调用：** `记录裁定：审计项 C8 裁定走 A 案，理由是测试面覆盖不足，来源 §4.1 审计报告` **产出摘录：** ```markdown # 004 — C8 按 A 案落地（来源：§4.1 审计报告） - Status: accepted - Date: 2026-09-29 ## Decision - C8 采用 A 案；B 案（逐条改写）不采用——测试面覆盖不足 ``` **完成判据：** `docs/decisions/004-*.md` 存在且含 status/date/相关；`docs/decisions/000-decision-log.md` 索引已加一行（#004）。 ## 失败闭集 - **`docs/decisions/` 不存在**：本项目未建决策目录 → 只报告「无 `docs/decisions/`，未写入」并停；**不自主建目录**（建/迁存储须用户显式调用）。 - **索引缺失（`000-decision-log.md` 不在）**：先补索引表头再写 ADR，并在产出里注明「索引为本次新建」。 - **项目根/路径不明确**：问一句「项目根在哪」；不猜路径乱写。 - **拿不准是否够格记 ADR**：记（轻量）；宁多勿漏——历史链靠连续。 ## 错法 → 改法 | 错法 | 后果 | 改法 | |---|---|---| | 裁定发生了但不记录（「等有空」） | 历史链断，查询返回空 | 当阶段记，3 分钟内 | | 把 ADR 全文复制进 `.handoff/`（手改真源） | 双源漂移 | 存储只引用 ADR 编号，不复制内容 | | 被 superseded 后删除旧 ADR | 链断，无法追溯 | 旧文件保留，状态改 superseded | | 编号跳号或覆盖旧文件 | 引用悬空 | 索引最大号 +1，只追加 | …
Read the whole file at its exact version.
How to install
mdr add ninjasln-labs/agent-skills/decision-log@sha256:40e9ab475ec08c34The line at the top of this page pins the label v1.1.0, 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_icuzhl5w545abdpv)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 16, 2026 and Sep 29, 2026, about one every 15 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.0 latest | 2026-09-29 | 0febb7a | 6,996 B | A | view · diff |
| v1.0.7 | 2026-09-22 | 75c75c0 | 5,033 B | A | view · diff |
| v1.0.0 | 2026-09-18 | cbc6719 | 4,036 B | A | view · diff |
| git:20260816.abe0a4a | 2026-08-16 | abe0a4a | 3,976 B | A | view |
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 (6996 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
ninjasln-labs/agent-skills · 3 stars · license none declared · pushed 2026-10-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_icuzhl5w545abdpv GET https://markdownregistry.com/api/v1/resolve?ref=ninjasln-labs/agent-skills/decision-log GET https://markdownregistry.com/api/v1/blob/40e9ab475ec08c3424dc59314c0182a915dc1b25fa2119116c4853fda4b22ab2
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.
More from ninjasln-labs/agent-skills
Every file in ninjasln-labs/agent-skills