knowledge-index-guard
Skill0 starsChanged 4 months agoMITView on GitHub
<TARGET>/assets/knowledge の索引（<TARGET>/assets/knowledge-base.md）が実体と一致し broken link=0 であることを保証する。トリガー語彙: ナレッジ索引, knowledge index, 索引ガード, index guard, broken link チェック, knowledge-base 整合性, 索引 drift
In this repository46 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- a11y-standardsSkill
- a11y-static-gateSkill
- adversarial-refute-voteSkill
- antigravity-buildSkill
- architecture-parity-gateSkill
- ci-required-check-installerSkill
- codex-buildSkill
- codex-imagegenSkill
- codex-spark-delegateSkill
- commit-convention-gateSkill
- commit-msg-quality-scoreSkill
- consumer-finding-ledgerSkill
- context-bloat-trackerSkill
- coverage-floor-lockSkill
- destructive-env-guardSkill
- dev-standardsSkill
- eval-dataset-buildSkill
- eval-regression-guardSkill
- fanout-verify-synthSkill
- gate-forgeSkill
- hallucination-rate-meterSkill
- harness-kpi-ledgerSkill
- judge-rubric-voteSkill
- knowledge-citation-coverageSkill
- knowledge-dedup-scanSkill
- live-state-verify-guardSkill
- maker-checker-relaySkill
- memory-distillSkill
- mistake-rule-distillSkill
- oneshotSkill
- prompt-ab-evalSkill
- report-shapeSkill
- retry-failure-classifierSkill
- review-finding-reproSkill
- rule-dedup-scanSkill
- rule-promote-auditSkill
- rule-promotion-extractSkill
- secret-scan-hardeningSkill
- self-heal-ciSkill
- session-length-compact-auditSkill
- startSkill
- subagent-usage-analyzerSkill
- task-success-rate-trackSkill
- token-codegen-gateSkill
- trigger-vocab-dedupSkill
The file
Files
ナレッジ索引ガード（knowledge-index-guard）
Harness Ladder H3（ブロッキング検証）。
<KNOWLEDGE_DIR>/の実体と索引<TARGET>/assets/knowledge-base.mdの AUTO-INDEX 区画が一致し、相対リンク切れ 0 であることを決定論ゲートで保証する。 2026-06-11 整合性監査で機械生成に切替済（手動 index はカバー率 24.5%・リンク切れ 26% まで腐敗していた）。本 skill はその生成物が drift していないことを継続検証する。
目的
- 索引の drift（ナレッジ追加/削除/リネーム後に索引を再生成し忘れた状態）を機械的に検出する
- 索引内の相対リンク切れ（存在しないファイルへの参照）を 0 に保つ
- 自己申告禁止（原則 P1）: 「索引は最新のはず」で済ませず、
--checkで実体と突き合わせる
実行手順
- リポジトリルートで決定論 --check を実走する（下記）
- exit 0 → 索引は健全。何もしない
- exit 1 → drift or broken link あり。原因に応じて対処:
- drift（AUTO-INDEX が実体と不一致）→
python3 scripts/regenerate-knowledge-index.pyで再生成しコミット - broken link（実体消失）→ 参照元を修正、または欠落ファイルを復元してから再生成
- drift（AUTO-INDEX が実体と不一致）→
- 再生成後にもう一度 --check を実走し exit 0 を確認してから完了とする
決定論 --check
python3 scripts/regenerate-knowledge-index.py --check- exit 0:
<TARGET>/assets/knowledge-base.mdの AUTO-INDEX が<KNOWLEDGE_DIR>/の実体と完全一致し、索引内の相対リンクが全て存在する（broken=0）= 達成 - exit 1: AUTO-INDEX が drift している or broken link>0 = 未達（要再生成/修正）
--checkは読取専用でありファイルを一切書き換えない。書込は無引数実行（python3 scripts/regenerate-knowledge-index.py）のみが行う
参照
- 生成/検証スクリプト:
scripts/regenerate-knowledge-index.py - 索引本体:
<TARGET>/assets/knowledge-base.md（AUTO-INDEX マーカー内は手動編集禁止） - 月次レビュー C 項でも同スクリプトの broken links: 0 を確認する（
harness-review（本バンドル外））
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.