# Wiki Conventions(既存 vault 規約の吸収レイヤー)
Navigation: [[index]] | [[overview]]
> [!important] wiki-ingest / wiki-query / wiki-lint / save / autoresearch を実行する前に必ずこのファイルを読むこと。
> claude-obsidian 標準のページ形式は、この vault の既存規約(`papers/`・`research/`・`structures/` で確立済み)に合わせて以下のとおり**上書き**する。標準と矛盾する箇所は**このファイルが優先**する。
---
## 1. 言語
- すべて**日本語・常体(だ・である調)**で書く。
- 箇条書きは体言止め可。
- 技術用語・コード識別子・固有名詞は原語のまま。
## 2. frontmatter(全 wiki ページ共通)
標準スキーマ(`type` / `title` / `created` / `updated` / `status` / `related` / `sources`)を維持しつつ、既存規約の `date` と日付タグを**必ず併記**する。flat YAML のみ(ネスト禁止)。
```yaml
---
type: source # source|entity|concept|question|comparison|meta
title: "人間可読タイトル"
date: 2026-06-02 18:46 # 既存規約(必須): 作成日時 YYYY-MM-DD HH:mm
created: 2026-06-02 # wiki 標準: YYYY-MM-DD
updated: 2026-06-02 # wiki 標準: 編集のたびに更新
aliases: [] # 既存規約: 別名(検索・バックリンク用)
tags:
- 2026/06/02 # 既存規約(必須・最優先): 日付タグを先頭に
- source # type タグ(source|entity|concept...)
- <domain-tag> # 任意: distributed, aiops 等
status: seed # seed|developing|mature|evergreen
related: []
sources: [] # "[[.raw/...]]" または "[[ソース要約]]"
---
```
ルール:
1. `tags` の**先頭は必ず日付タグ `YYYY/MM/DD`**。続けて type タグ、domain タグ。
2. `date`(時刻付き)と `created`/`updated`(日付のみ)は両方持つ。`updated` は編集ごとに更新。
3. wikilink を YAML に書くときは必ずクォート: `"[[Page Name]]"`。
4. リストは `- item` 形式(インライン `[a,b]` 禁止)。
## 3. type 固有フィールド
```yaml
# source
source_type: paper # article|video|podcast|paper|book|transcript|data
author: ""
date_published: YYYY-MM-DD
url: ""
confidence: high # high|medium|low
key_claims: []
# entity
entity_type: person # person|organization|product|repository|place|dataset
role: ""
first_mentioned: "[[ソース要約]]"
# concept
complexity: intermediate # basic|intermediate|advanced
domain: ""
```
## 4. ファイル名
| 種別 | パス | 命名 | 例 |
|---|---|---|---|
| source | `wiki/sources/` | **既存規約に合わせ `YYYY__SOURCE__Title.md`**(`route` の slug 出力でなくこちらを優先) | `2026__MLSys2026__Amin Vahdat Keynote - The Architecture of Intelligence.md` |
| entity | `wiki/entities/` | 原名(大文字・スペース保持。`route entity` の出力どおり) | `Amin Vahdat.md` |
| concept | `wiki/concepts/` | 原名(`structures/` の MOC 名と揃える) | `異常検知.md` |
- ファイル名のセパレータは既存どおりアンダースコア 2 つ `__`、スペースは保持、禁則文字(`/` `:` 等)は空白で囲む。
- entity / concept を原名にするのは、既存 `structures/*.MOC.md` 内の `[[異常検知]]` 等と名前空間を一致させ、相互リンクを成立させるため。
## 5. 出典(provenance)厳格性
- 既存の会議ノート規約を踏襲。すべての claim はソースに遡及可能であること。
- 出典の優先度: **Slides > Official Page > Transcript**。
- source ページの `key_claims` と本文の主張には、必ず `(Source: [[...]])` か `sources:` への対応を持たせる。
- 矛盾は黙って上書きせず `> [!contradiction]` callout で両ページに明示。
## 6. 既存資産との橋渡し(一方向参照の原則)
- wiki ページから既存 `papers/`・`research/`・`structures/*.MOC.md` へは `[[...]]` で**一方向参照**してよい。
- **既存ファイル(papers/・research/・structures/・notes/)は wiki-ingest で書き換えない**。MOC への逆リンク追記は**人間が承認したときのみ** 1 件単位で行う。
- concept ページは関連する `structures/*.MOC.md` を参照し、発見性を担保する。役割の違い: MOC=人間がキュレートする読み筋、concept=LLM が新規ソースから積み上げる定義・関係の集約(重複は許容)。
## 7. ページ構成・分量
- 標準テンプレ(`$PLUGIN/_templates/{source,concept,entity}.md`)の見出し構成をベースに、本文は日本語常体。
- 1 ページ 100〜300 行を上限。超えたら分割。
## 8. concept ページの必須セクション(横断的知見・未解決の問い)
concept ページは定義と関連リンクの集約にとどまらず、**複数ソースを並べて初めて見える知見**と**次に調べるべき問い**を蓄積する場とする。各 concept は以下の見出しを持つ(日本語常体)。`## 横断的知見` と `## 未解決の問い` の 2 節は**必須**で、空でも見出しを置いて育てていく。
```markdown
## 定義
[この概念が何か。常体・現在形・1 段落。出典付き。]
## 横断的知見
- 複数のソースを並べて初めて見える観察を箇条書きで蓄積する。
- **単一ソースだけで言える事実は書かない**(それは定義や source ページに書く)。2 つ以上のソースの突き合わせで見えた観察だけを残す。
- 各項目は根拠を `(Source: [[A]], [[B]])` で明示。矛盾なら `> [!contradiction]` を併記してよい。
## 未解決の問い
- 次に調べるべき問いを箇条書きで蓄積する作業リスト。
- 解決したら本節から落とし、知見になったものは横断的知見へ、独立に答える価値があれば `wiki/questions/` へ昇格させる。
## 関連
- 関連 source / entity への wikilink、関連 `structures/*.MOC.md` への一方向参照(§6)。
## 出典
-
```
更新ルール(全 ingest skill 共通):
1. **新しいソースが ingest されるたびに、触れた concept の上記 2 節を必ず更新する**。`wiki-ingest` / `wiki-ingest-paper` / `autoresearch` のいずれも対象。
2. ingest で concept に触れたら、(1) **横断的知見**に新ソースと既存ソースの突き合わせで見えた観察を追記し、(2) **未解決の問い**に新たな問いを追加し、解決済みの問いを落とす。
3. 1 ソース目から育て始める(横断的知見は 2 ソース目以降に増えるのが普通だが、定義時点で見えた問いは未解決の問いに入れておく)。
4. 既存項目は黙って上書きしない。積み増しが原則(§6 と同じ)。