一键在 Manus 中运行任何 Skill

adr-ref-guard

星标2

分支0

更新时间2026年4月23日 19:25

Quick advisory scan of markdown files for stale references to superseded/deprecated ADRs. Lightweight check — use the adr skill for full consistency audits.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

musingfox

musingfox/cc-plugins

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

ADR Reference Guard

Check markdown files for references to superseded or deprecated ADRs. Advisory only — never auto-replace.

When to Use

This is a manual check skill — invoke it when you want to audit ADR references:

Before a PR review, to catch stale ADR references
After an ADR supersession, to find docs that reference the old ADR
When the user asks to verify ADR references are current

This skill does NOT auto-activate on Write/Edit operations.

Detection Patterns

Scan the content being written/edited for:

ADR-NNNN or ADR NNNN (any digit count)
Markdown links: [...](path/to/NNNN-*.md)
Phrases: "as decided in ADR", "per ADR", "see ADR", "according to ADR", "defined in ADR"

Workflow

Extract references: Identify all ADR numbers referenced in the content
Locate ADR directory: Use Glob to find {docs/decisions,docs/adr,adr,decisions}/[0-9][0-9][0-9][0-9]-*.md
Find ADR files: For each referenced number, Glob for NNNN-*.md in the ADR directory
Check status: Read each referenced ADR file, parse YAML frontmatter status field
Warn if needed:
- If status starts with superseded by: warn with the replacement ADR
- If status is deprecated: warn about relevance
- If status is proposed or accepted: no warning needed

Warning Format

Present warnings after the write/edit operation completes. Include the file being edited:

ADR Reference Warning (in docs/setup.md):
- ADR-0003 (Use PostgreSQL) is superseded by ADR-0007 (Use SQLite).
  Consider updating the reference to ADR-0007.
- ADR-0005 (Legacy Auth) is deprecated.
  Verify this reference is still relevant.

Constraints

Never auto-replace references. Only inform the user.
Never block the write/edit operation. Present the warning after completion.
If multiple ADRs are referenced and some are current, only warn about the stale ones.
If multiple stale references found, suggest running ADR consistency check for a full audit.

同仓库更多 Skills

同仓库

init

musingfox/cc-plugins

Interactively create `.obsidian.yaml` and install starter templates (task / doc / adr) for this project. Triggers via `/obw:init` or when another obw skill reports missing config.

2026-07-102

jot

musingfox/cc-plugins

Unified entry point for Obsidian daily-note captures and long-form notes. Triggers on "記一下 / log / 紀錄 / capture this / 寫到 journal" (→ cap mode) and "建立筆記 / new note / 寫一份筆記 / create a note on" (→ note mode). Also via `/obw:jot`. Requires `.obsidian.yaml`.

2026-07-102

musingfox/cc-plugins

Obsidian Workspace PM — tasks, documents, and ADRs in your Obsidian vault. Triggers on task/doc/ADR lifecycle requests ("add a task", "create an ADR", "archive X", "list in-progress tasks", "refresh dashboard") and via `/obw:pm`. Requires `.obsidian.yaml` with a `pm.project` section.

2026-07-102

viz-render

musingfox/cc-plugins

Render markdown or Mermaid content as formatted HTML in the browser. Triggers when the user asks to view, render, or preview a document as HTML; when the user asks to visualize, diagram, chart, or draw architecture, flows, sequence/class/state/ER diagrams; when resolving plan files from ~/.claude/plans/; or proactively when about to output a table with 4+ rows or 3+ columns, a structured comparison, an audit, a feature matrix, or any formatted content exceeding ~50 lines in the terminal.

2026-07-092

pi-dispatch

musingfox/cc-plugins

Offload dispatch to cheap/fast omp models via pi-agent.sh — name-addressed sub-agent verbs (start/send/poll/peek/ls/stop/watch) over background omp workers with idempotent poll, worktree isolation, and distilled reports. Main loads this to write the offload usage it embeds in a builder brief.

2026-07-072

agent-browser

musingfox/cc-plugins

Use for live browser automation via the agent-browser CLI — open URLs, snapshot pages, click/fill/screenshot, inspect elements, scrape or read web pages. Ref-based workflow for AI agents. Not for writing Playwright test files (use playwright or web-test).

2026-05-102

ADR Reference Guard

Check markdown files for references to superseded or deprecated ADRs. Advisory only — never auto-replace.

When to Use

This is a manual check skill — invoke it when you want to audit ADR references:

Before a PR review, to catch stale ADR references

After an ADR supersession, to find docs that reference the old ADR

When the user asks to verify ADR references are current

This skill does NOT auto-activate on Write/Edit operations.

Detection Patterns

Scan the content being written/edited for:

ADR-NNNN or ADR NNNN (any digit count)

Markdown links: [...](path/to/NNNN-*.md)

Phrases: "as decided in ADR", "per ADR", "see ADR", "according to ADR", "defined in ADR"

Workflow

Extract references: Identify all ADR numbers referenced in the content

Locate ADR directory: Use Glob to find {docs/decisions,docs/adr,adr,decisions}/[0-9][0-9][0-9][0-9]-*.md

Find ADR files: For each referenced number, Glob for NNNN-*.md in the ADR directory

Check status: Read each referenced ADR file, parse YAML frontmatter status field

Warn if needed:

If status starts with superseded by: warn with the replacement ADR
If status is deprecated: warn about relevance
If status is proposed or accepted: no warning needed

Warning Format

Present warnings after the write/edit operation completes. Include the file being edited:

ADR Reference Warning (in docs/setup.md): - ADR-0003 (Use PostgreSQL) is superseded by ADR-0007 (Use SQLite). Consider updating the reference to ADR-0007. - ADR-0005 (Legacy Auth) is deprecated. Verify this reference is still relevant.

Constraints

Never auto-replace references. Only inform the user.

Never block the write/edit operation. Present the warning after completion.

If multiple ADRs are referenced and some are current, only warn about the stale ones.

If multiple stale references found, suggest running ADR consistency check for a full audit.

name	adr-ref-guard
description	Quick advisory scan of markdown files for stale references to superseded/deprecated ADRs. Lightweight check — use the adr skill for full consistency audits.