architecture-decision-record SKILL.md skillA

architecture-decision-record from jimyag/dotfiles is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jimyag/dotfiles/architecture-decision-record@git:20260905.751659e

Pins git:20260905.751659e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jimyag/dotfiles
Path
skills/architecture-decision-record/SKILL.md
Versions recorded
3
Latest version
git:20260905.751659e, committed Sep 5, 2026
First version recorded
Aug 10, 2026
Size
2,154 bytes
Repository stars
11
License
MIT

已有具体技术决策,需要判断是否记录 ADR,或创建、更新、替代 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

# 架构决策记录

记录已经有足够上下文的决策,不替代前期架构探索。

## 是否值得记录

满足以下任意两项时,默认建议写 ADR:

1. 有多个认真考虑过的备选方案
2. 接受了真实且非平凡的成本
3. 决策不容易回滚或会约束未来设计
4. 只看代码无法理解为什么没有选择另一个方案

单点 bugfix、机械迁移、命名样式调整、沿用既有约定,或尚未形成选择时不写 ADR。理由较轻时放进 PR 正文、设计文档或代码注释。

## 评估模式

```text
结论:建议写 ADR / 不建议写 ADR
满足标准:<编号>
依据:<真实备选、约束和代价>
建议标题:<如适用>
```

## 创建流程

1. 收集决策背景、驱动因素、真实备选、最终选择、正负影响及 issue/PR/代码证据。
2. 检查仓库现有 ADR 目录和格式;有现行约定时优先沿用。
3. 默认路径为 `docs/adr/NNNN-<slug>.md`,编号取现有最大值加一,slug 使用小写短横线。
4. 使用 [ADR 模板](assets/adr-template.md),删除不适用的占位内容,不虚构备选或验证结果。
5. 检查新决策是否明确替代旧 ADR。范围只是补充或局部扩展时不要标记替代。
6. 创建后复读事实、状态、链接、负面影响和替代关系。

## 更新与替代

已接受 ADR 应保留历史。只有新决策明确反转或替换旧选择时,才把旧 ADR 状态更新为:

```yaml
status: 被 ADR-NNNN 替代
```

标题相似或治理范围重叠只算候选,不足以自动替代。证据模糊时报告候选并保持旧文件不变。

## 写作约束

- 一个 ADR 只记录一个决策
- 只写真实考虑过的方案
- `负面影响` 必须写明接受的成本
- 语言保持事实性,不写宣传口吻
- 信息缺失时明确记录 gap

## 输出

```text
ADR: <path / 未创建>
标题:<标题>
状态:<状态>
替代记录:无 / ADR-NNNN
已知缺口:<缺口>
验证:<检查>
```

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jimyag/dotfiles/architecture-decision-record@sha256:e3170e233a69a084

The line at the top of this page pins the label git:20260905.751659e, 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_yzn4s7mdx2enycfq.svg)](https://markdownregistry.com/a/art_yzn4s7mdx2enycfq)

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

Versions

The registry has recorded 3 versions of this file, between Aug 10, 2026 and Sep 5, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20260905.751659e latest2026-09-05 751659e 2,154 BA view · diff
git:20260812.c55b6ba2026-08-12 c55b6ba 2,291 BA view · diff
git:20260810.2f916d12026-08-10 2f916d1 4,305 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2154 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

jimyag/dotfiles · 11 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yzn4s7mdx2enycfq
GET https://markdownregistry.com/api/v1/resolve?ref=jimyag/dotfiles/architecture-decision-record
GET https://markdownregistry.com/api/v1/blob/e3170e233a69a0848aa705d849ea547e6e0a1f2b05565d51a3a2ad7184a617cc

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 jimyag/dotfiles

absorb-skill SKILL.md skill
jimyag/dotfiles · skills/absorb-skill/SKILL.md · 用户想从外部技能生态寻找、比较可复用的 Agent Skill,或要求把外部 Skill、项目资料或历史经验中的可复用内容吸收到已有 Skill 时使用;对照来源与目标后修改目标…
git:20261019.0e15234 · audit B · 11 stars
agent-health SKILL.md skill
jimyag/dotfiles · skills/agent-health/SKILL.md · 在审计 AGENTS/CLAUDE 指令、MCP、hooks、工具权限、验证入口、跨工作流配置漂移,或技能库的规范、可移植性、触发重叠、上下文加载、脚本和评测时使用;不用于创建技能,不因普通任务涉及配置就触发。
git:20261019.0e15234 · audit B · 11 stars
brainstorming SKILL.md skill
jimyag/dotfiles · skills/brainstorming/SKILL.md · 在目标、范围或成功标准不清,存在接近的实现方案,或高成本假设可能导致返工时使用;用户要求拷问、追问或 grill 方案时也使用。适用于实现前澄清需求、挑战隐含前提并收敛到一个推荐方案;不用于已经明确的小改动。
git:20261015.bb74506 · audit A · 11 stars
codecov-coverage SKILL.md skill
jimyag/dotfiles · skills/codecov-coverage/SKILL.md · 在需要查询 Codecov 仓库、PR、提交、patch 或文件覆盖率,比较覆盖率变化,或诊断 codecov/project、codecov/patch 等覆盖率检查失败时使用。
git:20260905.751659e · audit A · 11 stars
frontend-design-review SKILL.md skill
jimyag/dotfiles · skills/frontend-design-review/SKILL.md · 在确定或审查前端页面、落地页、作品集和重新设计的视觉方向时使用;区分只读审查、方向建议和已授权实现,并用真实截图或渲染验证视觉结论。不用于纯业务逻辑、状态管理或已经有明确设计稿的机械实现。
git:20261015.b377f6b · audit A · 11 stars
gh-stack SKILL.md skill
jimyag/dotfiles · skills/gh-stack/SKILL.md · 使用 gh-stack GitHub CLI 扩展管理堆叠分支和拉取请求。适用于创建、推送、变基、同步、切换、查看、重组或合并相互依赖的 PR 链及堆叠差异。
v0.0.9 · audit A · 11 stars
linux-performance-analysis SKILL.md skill
jimyag/dotfiles · skills/linux-performance-analysis/SKILL.md · 诊断 Linux 主机或容器的缓慢、高负载、资源压力及网络性能异常,定位瓶颈与触发进程;不用于普通命令语法查询。
git:20260905.751659e · audit A · 11 stars
loop-on-ci SKILL.md skill
jimyag/dotfiles · skills/loop-on-ci/SKILL.md · 在已有 GitHub PR 需要持续观察 Actions 检查、读取失败作业日志、修复问题、重新运行并跟到全部检查变绿时使用。适用于围绕同一个 PR 反复验证,而不是一次性状态查询。
git:20261015.b377f6b · audit A · 11 stars
pull-request SKILL.md skill
jimyag/dotfiles · skills/pull-request/SKILL.md · 创建 GitHub PR、更新标题或正文、填写 PR 模板,或准备人工发布内容时使用;不用于代码审查和 CI 修复。
git:20260919.361331b · audit A · 11 stars
requesting-code-review SKILL.md skill
jimyag/dotfiles · skills/requesting-code-review/SKILL.md · 用户要求审查当前代码差异或 PR 时使用,默认只读;不用于处理已收到的评审意见。
git:20261019.0e15234 · audit A · 11 stars
runtime-verification SKILL.md skill
jimyag/dotfiles · skills/runtime-verification/SKILL.md · 在提交或交付非平凡代码改动前,需要确认改动在真实运行面上按预期工作时使用;通过 CLI、接口、界面、公开包入口或代理行为驱动改动路径并留存证据。只改测试、文档或无运行面的类型声明时不触发;定位缺陷使用…
git:20261015.2c8093f · audit A · 11 stars
shared-memory SKILL.md skill
jimyag/dotfiles · skills/shared-memory/SKILL.md · 在新增、更新、更正、删除、同步或检索持久记忆时使用;包括用户要求记住或忘记、Agent 保存原生记忆及跨 Agent 复用,统一维护本地共享目录和格式。
git:20261018.2baf6d4 · audit A · 11 stars

Every file in jimyag/dotfiles

Other files named architecture-decision-record

architecture-decision-record SKILL.md skill
mohitagw15856/pm-claude-skills · exports/openclaw/architecture-decision-record/SKILL.md · Create an Architecture Decision Record (ADR) for any technical decision. Use when asked to document a technical…
git:20260714.d9455b5 · audit A · 1,475 stars
architecture-decision-record SKILL.md skill
mohitagw15856/pm-claude-skills · i18n/es/skills/architecture-decision-record/SKILL.md · Crea un Registro de Decisión de Arquitectura (ADR) para cualquier decisión técnica. Úsalo cuando necesites documentar…
git:20261011.3fb211c · audit A · 1,475 stars
architecture-decision-record SKILL.md skill
yonatangross/orchestkit · src/skills/architecture-decision-record/SKILL.md · ADR templates in the Nygard format with context, decision, consequences, and alternatives. Use when writing ADRs…
v2.0.0 · audit A · 296 stars
architecture-decision-record SKILL.md skill
yonatangross/orchestkit · plugins/ork/skills/architecture-decision-record/SKILL.md · ADR templates in the Nygard format with context, decision, consequences, and alternatives. Use when writing ADRs…
v2.0.0 · audit A · 296 stars
architecture-decision-record SKILL.md skill
stijnman/grok-custom-skills · .grok/skills/architecture-decision-record/SKILL.md · Document a significant technical decision with its context, alternatives, consequences, and status. Use for…
v1.0.0 · audit A · 13 stars
architecture-decision-record SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/executive/architecture-decision-record/SKILL.md · Drafts an architecture or design decision record (ADR) from the discussion notes, design review minutes, chat threads…
git:20260917.f14a4fb · audit A · 9 stars
architecture-decision-record SKILL.md skill
fattain-naime/engineering-docs · skills/architecture-decision-record/SKILL.md · Create a standalone Architecture Decision Record (ADR) for a single significant architectural decision. Captures…
git:20260717.2f82174 · audit A · 6 stars

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