メニュー
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).
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/pnils08/GodWorld --skill md-auditコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Close a GodWorld external-lane session (Grok) cleanly: inventory work, land authorized commits if needed, rewrite only NEXT[grok] in SESSION_CONTEXT.md, commit that handoff path-specifically, report git stack / push status. Use when the user says session end, close session, handoff, wrap up, done for now, or runs /session-end. Not the Claude Code session-end skill (no PIN bump, no ROLLOUT sweep, no sessionEndMechanical.js).
Deputy Mayor Brenda Okoro's office. Generates operational statements on West Oakland Stabilization Fund, Community Development, and Economic Development (Osei-portfolio coverage). Carries Mayor's-office operational reality — not political framing.
Oakland Police Chief Rafael Montez. Generates public safety statements, OARI implementation responses, and crime data communications. Professional, measured, data-driven.
SKILL.md を表示中
SOC 職業分類に基づく
| 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 [[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).