菜单
Detect stale + orphan MD files in docs/. Mechanical scan of git mtime + inbound links; classifies every doc into 5 buckets. Read-only — never moves or deletes. Complement to /doc-audit (content staleness vs existence staleness).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Baylight Authority Director Keisha Ramos. Generates construction updates, milestone announcements, development progress reports, and civic documents (deliverable filings, TIF reports, workforce agreements) for the $2.1B Baylight District project.
Phase 39.1 capability reviewer wrapper. Runs the deterministic editorial assertions against a compiled edition, surfaces blocking failures that should halt publish, and writes a markdown summary alongside the JSON.
Prepare all inputs for city-hall voice agents. Reads tracker, approvals, world summary, engine review, coverage ratings, previous log, canon, Mara directive. Writes pending decisions per voice.
Senior Photographer for The Cycle Pulse. Generates image prompts and photo selection for editions. Reads compiled edition + canon rules + institutions, produces 5-8 storyline-tied prompts.
Letters to the Editor desk agent for The Cycle Pulse. Writes citizen voice letters responding to cycle events. Use when producing letters section of an edition.
Close the feedback loop. Canonize to Supermemory, update world-data, write ratings to sheets, grade reporters, update criteria files, update newsroom memory. Type-aware — edition, interview, supplemental, dispatch all converge here.
| name | md-audit |
| description | Detect stale + orphan MD files in docs/. Mechanical scan of git mtime + inbound links; classifies every doc into 5 buckets. Read-only — never moves or deletes. Complement to /doc-audit (content staleness vs existence staleness). |
| version | 1.0 |
| updated | "2026-04-30T00:00:00.000Z" |
| tags | ["architecture","active"] |
| effort | low |
| disable-model-invocation | true |
node scripts/mdStalenessDetector.js # default 90/30
node scripts/mdStalenessDetector.js --stale-days 60 # tighter staleness
node scripts/mdStalenessDetector.js --active-days 14 # tighter active window
Writes report to output/md_audit_<YYYY-MM-DD>.md.
Walks docs/ (excludes docs/archive/, docs/drive-files/, docs/research/papers/). For each .md:
git log -1 --format=%ct — falls back to filesystem mtime if not in git.docs/**/*.md, .claude/**/*.md, CLAUDE.md, MEMORY.md, CONTEXT.md, SESSION_CONTEXT.md, README.md. Matches both wikilinks ([[engine/ROLLOUT_PLAN]]) and literal paths (docs/engine/ROLLOUT_PLAN.md).--active-days window (default 30).Then classifies each doc into one of five buckets (first-match-wins):
| Bucket | Rule |
|---|---|
reference-stable | frontmatter stable: true — explicitly durable |
fresh | not stale (≤ --stale-days) |
orphan-candidate | stale + zero inbound refs — strongest archive candidate |
stable-by-reference | stale + at least one active referrer — load-bearing dormant |
stale-but-linked | stale + inbound exists but no active referrer — human judgment |
/doc-audit — the sibling skill./doc-audit — content staleness audit on 7 named groups. Reads each doc, verifies claims against actual codebase state. Targeted + thorough./md-audit (this) — existence staleness across the whole tree. Catches orphans /doc-audit doesn't know about.Both are needed. /doc-audit checks whether the docs you decided to keep are still accurate. /md-audit finds the docs you forgot.
Plan file: docs/archive/plans/2026-04-21-md-audit-skill.md (S170, drafted research-build).
Phase 3 (gated archival via scripts/archiveStaleMd.js) intentionally not built — first run informs whether the classifier needs tuning before destructive action enters the loop.
stable: true on known durables.docs/plans/ — not excluded. Old completed plans archiving is a feature, not a bug.SCHEMA.md, STACK.md, SIMULATION_LEDGER.md, SPREADSHEET.md, reference/V3_ARCHITECTURE.md, reference/DEPLOY.md) are candidates for stable: true frontmatter after first review.After every run, append a row to [[../../docs/AUDITS]] Run history table:
/md-audit), findings (1-line summary — orphan count / stale count / fresh count), action taken (typically report only; archived N docs if Phase 3 fires), artifact path (output/md_audit_<DATE>.md).