タグ分類法 — Wiki タグ用の統制された語彙

wiki全体でタグの一貫性を強制し、統制された語彙にタグを正規化しています。

始める前に

1. 設定を解決する — llm-wiki/SKILL.md の設定解決プロトコルに従う（CWD から .env → ~/.obsidian-wiki/config → プロンプト設定をたどる）。これにより OBSIDIAN_VAULT_PATH が得られます
2. $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md を読む — これが正規のタグリストです
3. index.md を読む — wikiのスコープを理解します

分類ファイル

正規のタグ語彙は $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md に存在します。以下を定義します：

• 正規タグ — 使用すべきタグ
• エイリアス — 正規形にマップされるべき一般的な代替案
• ルール — ページあたり最大5タグ、小文字/ハイフン区切り、狭いものより広いものを優先
• 移行ガイド — 既知の不整合のための具体的な名前変更

タグ付けする前に必ずこのファイルを読んでください。 これが真実の源です。

予約されたシステムタグ

visibility/ は特別なルールを持つ予約タググループです。これらのタグはドメインやタイプタグではなく、分類法語彙とは別に管理されます：

タグ	目的
visibility/public	明示的に公開 — すべてのモードで表示（タグなしと同じ）
visibility/internal	チームのみ — フィルター済みクエリ/エクスポートモードで除外
visibility/pii	機密データ — フィルター済みクエリ/エクスポートモードで除外

visibility/ タグのルール：

• 5タグ制限にカウントされない
• ページあたり最大1つの visibility/ タグのみ
• コンテンツが明らかに公開の場合は完全に省略 — タグ不要
• 単にコンテンツが技術的だという理由で visibility/internal を追加しない；本当にチーム制限の知識の場合のみ使用
• タグ監査を実行する際、visibility/ タグ使用を別途報告 — 不明または非正規タグとしてフラグを立てないでください

タグを正規化する際は、visibility/ タグはそのまま — エイリアスマッピングの対象ではありません。

モード1：タグ監査

ユーザーがタグの現在の状態を確認したいとき：

ステップ1：すべてのページをスキャン

Glob: $VAULT_PATH/**/*.md (_archives/, .obsidian/, _meta/ を除く)
抽出：YAML frontmatterからtags フィールド

ステップ2：タグ頻度テーブルを作成

見つかった各タグについて、それを使用しているページ数をカウントします。フラグを立てます：

• 不明なタグ — 分類法の正規リストにない
• エイリアスタグ — 正規形の代わりにエイリアスを使用（例：react の代わりに nextjs）
• 過度にタグ付けされたページ — 5タグ以上あるページ
• タグなしページ — タグがないか空のタグフィールド

ステップ3：報告

## タグ監査レポート

### サマリー

- 合計ユニークタグ数：47
- 使用された正規タグ：32
- 見つかった非正規タグ：15
- タグ制限を超えるページ（5）：3
- タグなしページ：2

### 見つかった非正規タグ

| 現在のタグ | → 正規タグ | 影響を受けるページ |
| ----------- | ----------- | -------------- |
| `nextjs`    | `react`     | 4              |
| `next-js`   | `react`     | 2              |
| `robotics`  | `ml`        | 1              |
| `windows98` | `retro`     | 3              |

### 不明なタグ（分類法にない）

| タグ          | ページ | 推奨事項                   |
| ------------ | ----- | -------------------------------- |
| `flutter`    | 1     | フレームワークの下に分類法に追加 |
| `kubernetes` | 2     | DevOpsの下に分類法に追加     |

### タグ制限を超えるページ

| ページ                   | タグ数 | タグ                 |
| ---------------------- | --------- | -------------------- |
| `entities/jane-doe.md` | 8         | ai, ml, founder, ... |

モード2：タグ正規化

ユーザーがタグを修正したいとき：

ステップ1：監査を実行（上記）

ステップ2：修正を適用

非正規タグがあるページごと：

1. ページを読む
2. エイリアスタグを分類法の正規形で置き換える
3. ページに5タグ以上ある場合、どのタグを削除するかを提案（最も具体的/関連性の高いものを保持）
4. 更新された frontmatter を書き込む

例：

# 修正前
tags: [nextjs, ai, ml-engineer, windows98, creative-coding, game, 8-bit, portfolio]

# 修正後
tags: [react, ai, ml, retro, generative-art]

ステップ3：不明なものを処理

分類法にないタグで、エイリアスでもないもの：

• タグが2ページ以上で使用されている場合、分類法に追加することを提案
• タグが1ページでのみ使用されている場合、最も近い正規タグで置き換えることを提案
• 不明なタグへの変更を行う前に、ユーザーに確認を取る

ステップ4：分類法を更新

新しい正規タグが合意された場合、_meta/taxonomy.md の正しいセクションに追加します。

モード3：新しいページへのタグ付け

wiki ページを作成し、タグを選択する必要があるとき：

1. _meta/taxonomy.md を読む
2. ページを最適に説明する最大5つのタグを選択：
   • 1～2 ドメインタグ（どの主題分野か）
   • 1 タイプタグ（何の種類か）
   • 0～1 プロジェクトタグ（プロジェクト固有の場合）
   • 0～1 追加の説明タグ
3. 正規タグのみを使用 — エイリアスは使用しない
4. 既存のタグが当てはまらない場合、分類法に追加する価値があるかを確認

モード4：新しいタグを追加

ユーザーが語彙にタグを追加したいとき：

1. 既存のタグがすでにコンセプトをカバーしているかを確認（該当する場合は提案）
2. 本当に新しい場合、どのセクション（ドメイン、タイプ、プロジェクト）に属するかを判断
3. _meta/taxonomy.md に以下を含めて追加：
   • 正規タグ名
   • 何に使用されるか
   • リダイレクトするエイリアス

タグ操作後

log.md に追加：

- [TIMESTAMP] TAG_AUDIT tags_normalized=N unknown_tags=M pages_modified=P

または正規化の場合：

- [TIMESTAMP] TAG_NORMALIZE tags_renamed=N pages_modified=M new_tags_added=P

hot.md — $OBSIDIAN_VAULT_PATH/hot.md を読む（wiki-ingest のテンプレートから不足している場合は作成）。最近のアクティビティを1行の要約で更新 — 例：「タグ監査：28ページ全体で14タグを正規化；2つの新しい正規タグを追加。」最後の3つの操作を保持します。updated タイムスタンプを更新します。