vault-management

Obsidian Vault の管理

Obsidian vault を開発者向けナレッジベースおよび自動作業ジャーナルとして管理します。

使用するタイミング

次の場合にこのスキルを有効にします。

• ユーザーがノートの操作（追加、検索、更新、インポート、リンク、アーカイブ）を依頼した場合
• vault に保存するプロジェクトドキュメントを扱う場合
• コミット、タスク、Claude Code コンポーネントを自動記録する場合
• ユーザーがノート、ドキュメント、ナレッジベースについて質問した場合
• vault 内の情報を整理または検索する場合

Vault の構造

~/guerra_vault/
├── projects/              # Project-specific documentation
├── technologies/          # Technology knowledge (Laravel, React, etc.)
├── claude-code/           # Claude Code components
│   ├── agents/
│   ├── hooks/
│   ├── skills/
│   └── tools/
├── ideas/                 # Feature ideas and experiments
├── personal/              # Career and learning goals
├── todo/                  # Tasks and checklists
├── references/            # Bookmarks, snippets, cheatsheets
├── journal/               # Auto-captured events
│   ├── commits/           # Git commit documentation
│   ├── tasks/             # Completed task summaries
│   └── creations/         # Component creation logs
└── _archive/              # Archived notes

Frontmatter の標準

すべてのノートに、次の YAML frontmatter を必ず含めてください。

---
title: "Note Title"
description: "Brief description of the content"
tags: [tag1, tag2, category]
related: [[path/to/related-note]]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

ルール：

• title：内容を表し、メイン見出しと一致するタイトル
• description：内容を説明する1文
• tags：カテゴリをタグとして必ず含める
• related：Wikiリンク形式で記述し、関連するノートがあれば追加する
• created：作成時に一度だけ設定する
• updated：ノートを変更するたびに更新する

使用可能なコマンド

コマンド	目的
/obsidian-vault:init	vault の設定と構造をセットアップする
/obsidian-vault:add <category> <title>	新しいノートを作成する
/obsidian-vault:search <query>	タイトル、内容、タグからノートを検索する
/obsidian-vault:update <note>	ノートの frontmatter を編集するか、内容を追記する
/obsidian-vault:import <file>	frontmatter を付けて外部ファイルをインポートする
/obsidian-vault:list [category]	ノートを一覧表示する。カテゴリで絞り込むことも可能
/obsidian-vault:tags [--stats]	タグと使用統計を表示する
/obsidian-vault:link <note1> <note2>	双方向の関連リンクを作成する
/obsidian-vault:archive <note>	ノートをアーカイブに移動する

自動記録の動作

このプラグインは次の内容を自動的に記録します。

Git コミット

• journal/commits/YYYY-MM-DD-<slug>.md を作成する
• コミットメッセージ、日付、プロジェクト、ブランチ、変更ファイルを含める
• 「What」と「Why」のプレースホルダーセクションを含める（コンテキストに合わせて記入）

タスクの完了

• journal/tasks/YYYY-MM-DD-<slug>.md を作成する
• サブエージェントの要約を記録する
• 要約、実施内容、決定事項を含める

Claude Code コンポーネント

• claude-code/<type>s/<name>.md を作成する
• エージェント、フック、スキル、ツールを記録する
• journal/creations/ にも記録する

ベストプラクティス

ノートの作成

1. 適切なカテゴリを選択します
2. 内容が分かるタイトルを付けます
3. 関連するタグをすぐに追加します
4. 明らかな関連ノートがあればリンクします

ノートの更新

1. updated の日付を更新します（スクリプトによって自動的に行われます）
2. 関連性が見つかったら、新しい関連リンクを追加します
3. 説明を最新の状態に保ちます

検索

1. 広く検索し、--title、--content、または --tag で絞り込みます
2. --category を使って特定の領域に絞り込みます
3. 追加のコンテキストを得るため、関連ノートを確認します

整理

1. カテゴリ内で一貫した命名規則を使います
2. 削除するのではなく、アーカイブします
3. 双方向リンクを維持します

ワークフローとの統合

機能の完了後

機能や修正を完了したとき：

1. コミットが記録されていることを確認します
2. プロジェクトドキュメントを追加または更新します
3. 新しいノートをプロジェクトの README にリンクします

技術を学ぶとき

1. technologies/ にノートを作成します
2. その技術を使用するプロジェクトにリンクします
3. 必要に応じてコードスニペットを追加します

アイデアや実験の場合

1. ideas/ から始めます
2. 実装を開始したら projects/ に移動します
3. 取りやめた場合はアーカイブします

追加リソース

参考ファイル

• references/frontmatter-spec.md - frontmatter の詳細な仕様

設定

• 設定ファイル：~/.claude/obsidian-vault.json
• Vault のパス：~/guerra_vault