maintain

name	maintain
description	Vault の健全性チェックを実行する。リンク切れ検出・孤立ノート検出・統合候補提案を行う。
disable-model-invocation	true

Vault メンテナンス

Obsidian Vault の健全性を包括的にチェックし、問題を修復する。

Vault パス

~/Documents/Zettelkasten

チェック項目

リンク切れ検出

全ノートの [[wikilink]] を走査し、リンク先ファイルが存在しないものを検出する。

function check_broken_links(vault_path):
  all_notes = set(list_all_note_names(vault_path))
  broken = []
  for note in list_all_notes(vault_path):
    content = read(note)
    for link in extract_wikilinks(content):
      if link not in all_notes:
        broken.append({source: note, target: link})
  return broken

孤立ノート検出

他のどのノートからも wikilink されていないノートを検出する。Structured Notes の索引ページは除外する。

function check_orphans(vault_path):
  all_notes = list_all_note_names(vault_path)
  linked = set()
  for note in list_all_notes(vault_path):
    for link in extract_wikilinks(read(note)):
      linked.add(link)
  orphans = [n for n in all_notes if n not in linked and not is_structured_note(n)]
  return orphans

未統合 Fleeting Notes

01-Fleeting-Notes/ 内のノートを一覧し、Permanent Note への統合を提案する。同一タグの Fleeting Notes が複数ある場合にグループ化する。

frontmatter 整合性

全ノートの frontmatter を検証する:

• type フィールドがディレクトリと一致するか（00-Literature-Notes/ 内なら type: literature）
• created フィールドが ISO 8601 形式か
• title フィールドが存在するか

pre-commit hook 設置状況

Vault の .git/hooks/pre-commit にリンク切れ検出フックが設置されているか確認する。未設置の場合はセットアップ対象として報告する。

手順

1. Vault が存在するか確認する。存在しない場合はその旨を報告する
2. Pre-commit hook が未設置なら ${CLAUDE_PLUGIN_DIR}/assets/note-format.md の「Pre-commit Hook セットアップ」に従って設置する
3. 上記すべてのチェックを実行する
4. 結果をまとめて報告する
5. 修復可能な問題（壊れたリンクの削除、frontmatter 修正）はユーザーの承認を得て修復する
6. 修復後は git add + git commit する