About This Wiki
高校生向けのやさしい解説
このページは「この wiki がどうやって作られて、どう使えばいいか」を説明する案内板です。書いている人が手で全部書いているのではなく、AI が複数のリポジトリの研究ノートを読んで自動でまとめています。だから、人間（pjdhiro）が承認した正本ではなく、いつでも作り直せる「閲覧用ビュー」だ——というのが大事なポイントです。
この wiki の成り立ち、仕組み、役割分担を説明するメタドキュメント。
プロジェクトデザイン論そのものの概要は プロジェクトデザイン を参照。
この wiki は何か
pd/knowledge/ および関連リポジトリの知識資産から、LLM が自動生成した compiled view（編集済み閲覧用ビュー）。元の資料を変更せず、読みやすく再構成し、概念間のリンクを付与したもの。
正本ではない。 正本は各リポの knowledge/ や evidence/ にある。この wiki は閲覧・探索・健全性チェックのためのレイヤーであり、いつでも全削除して再生成できる。
ソースとなるナレッジの所在
| リポジトリ | ディレクトリ | 内容 | compile 状況 |
|---|---|---|---|
| project-design | knowledge/concepts/ | 概念ノート CN-005〜008（信頼、測定、保持論点） | Step 1 済 → concepts/ |
| project-design | knowledge/research/ | 調査レポート群（trust, value, design-thinking 等） | Step 2 済 → keywords/, concepts/ |
| project-design | knowledge/meta/ | canonical-keywords.md, terminology-changelog.md 等 | wikilink 辞書として使用 |
| project-design | knowledge/schema/ | evidence-metadata.md（メタデータ体系定義） | 参照のみ |
| kesson-space | knowledge/ | concepts/CN-001〜004, expressions/, schema/, text/ | Step 3 完了 |
| awareness-space | knowledge/ | topics/four-layers, topics/survival-trust-axis | Step 3 完了 |
| creation-space | knowledge/ | five-stages-guide, glossary, schema/, domains/ (D01-D30) | Step 3 完了 |
参照しているが wiki に取り込んでいないもの
pjdhiro/_pages/pd/— 公開用 Markdown の正本。wiki とは独立techo/knowledge/— for-ai 用語集、pd 関連の対話記録。参考情報- 各リポの
transform/— 生成ルール・パイプライン。wiki の compile とは別系統
compile の仕組み
誰が何をするか
| 主体 | 役割 | 具体的な操作 |
|---|---|---|
| Claude Code CLI | compile 実行 | ソースを読み、wiki ページを生成・更新する |
| canonical-keywords.md | wikilink 辞書 | compile 後の後処理で、辞書の用語を初出のみ [[wikilink]] に変換 |
| Obsidian | 閲覧・探索 | 人間がグラフビュー、バックリンク、Dataview クエリで知識を探索する |
| pjdhiro（人間） | レビュー・判断 | review_state を「レビュー済み」に変更。理論の最終採否は人間の専権 |
compile フロー
knowledge/ (raw) ──LLM読み取り──▶ plain markdown 生成
│
▼
canonical-keywords.md 辞書
│
正規表現で初出のみ
[[wikilink]] 挿入
│
▼
wiki/*.md 出力
│
▼
log.md に記録
compile のステップ
| Step | 範囲 | 入力 | 出力 | 状況 |
|---|---|---|---|---|
| Step 1 | pd 内 同一ディレクトリ | knowledge/concepts/CN-*.md | concepts/ | 完了 |
| Step 2 | pd 内 cross-directory | knowledge/research/ | keywords/, concepts/, cross-refs/ | 完了 |
| Step 3 | cross-repo | ks, as, cs の knowledge | concepts/ 充実化 + keywords/ + cross-refs/ 拡充 | 完了（#53） |
front matter の読み方
各ページの冒頭にある YAML front matter がトレーサビリティを担保する。
title: "概念名" # ページタイトル
aliases: ["English", "略称"] # Obsidian の検索・リンク解決で使用
source: # ★ compile 元のファイル
- repo: "project-design"
path: "knowledge/concepts/CN-005_trust-hypothesis-inventory.md"
compiled: "2026-04-06" # 最後に compile した日
tags: [concept, trust] # Obsidian タグ
status: 探索的 | 暫定 | 正典 | LLM構成物 | 要改訂 # 内容の成熟度
review_state: 未レビュー | v2照合中 | v2照合済 | レビュー済み # 人間のレビュー状態
ocr_verified: true # (optional) 原典 PDF を OCR で検証済み
related_concepts: [...] # (optional) 関連概念リストstatus の意味
| 値 | 意味 |
|---|---|
探索的 | 調査途中。構造が定まっていない |
暫定 | 情報はまとまったが理論的位置付けが未確定 |
正典 | 学術文献の解説など、出典が確定しているもの |
LLM構成物 | LLM が構成したが pjdhiro が採用していない。参照は注意 |
要改訂 | 既存内容に不整合あり、書き直し待ち |
review_state の意味
| 値 | 意味 |
|---|---|
未レビュー | pjdhiro 未確認 |
v2照合中 | 理論 v2 系列との整合性を確認中 |
v2照合済 | 整合性確認済み |
レビュー済み | pjdhiro が内容を承認 |
ディレクトリ配置ルール
| ディレクトリ | 内容 | status の既定 |
|---|---|---|
concepts/ | PD 固有の概念定義（project-design 独自または ks との共有） | 暫定 or 正典 |
keywords/ | 複数論文をまたぐ索引ページ（人物、外部理論） | 暫定 |
sources/ | 学術論文・原典・公式文書の解説ページ | 正典 |
sources/pd/ | PD 固有の原典、または他に分類されない原典 | 暫定 or 正典 |
cross-refs/ | リポジトリ横断の接続情報・マップ・overview | 暫定 |
health/ | wiki-lint スキルの健全性レポート | 管理対象外 |
判断に迷うケース
- 人物ページ: 複数論文をまたぐ人物 →
keywords/, 個別論文の著者 →sources/ - PD 固有概念:
concepts/に置く（欠損、抱持、情動の構成 等） - LLM が構成した仮説:
status: LLM構成物でkeywords/に置く - 複数リポを横断する観点整理:
cross-refs/
alias 命名規則
- 英語名（Roman）→ 日本語別名 → 略称 の順に記載
- 例:
aliases: ["Annette Baier", "アネット・ベイアー", "Baier"]
tag 体系
- 構造タグ:
concept,keyword,person,cross-ref,source（ディレクトリ種別を示す。1ページに必ず1つ） - ドメインタグ:
trust,value,design-thinking,kesson,awareness-modelなど（テーマ別） - creation-space ドメインタグ:
D01〜D30（30ドメインに属する sources/keywords に付与） - メタタグ:
原典参照（PDF 由来）,原典解説（sources の解説ページ）
禁止: コンテンツ位置タグ
§1-先行研究 のような本文セクション名をタグ化してはならない（フィルタ精度が落ちる）。本文内の見出しで参照する。
Obsidian と LLM の分担
┌─────────────────────────────────────────────┐
│ LLM（Claude Code CLI）の領域 │
│ │
│ ・wiki ページの生成・更新 │
│ ・wikilink の挿入（辞書ベース後処理） │
│ ・health check（lint）の実行 │
│ ・log.md への記録 │
│ │
│ ※ knowledge/ の正本は読むだけ。変更しない │
└─────────────────────────────────────────────┘
▼ 出力
┌─────────────────────────────────────────────┐
│ Obsidian の領域 │
│ │
│ ・グラフビューで概念間の接続を可視化 │
│ ・バックリンクで逆方向の参照を発見 │
│ ・Dataview クエリで status や compiled で │
│ フィルタリング │
│ ・全文検索で知識を横断探索 │
│ │
│ ※ wiki ファイルを人間が手動編集する必要なし │
└─────────────────────────────────────────────┘
▼ 判断
┌─────────────────────────────────────────────┐
│ pjdhiro（人間）の領域 │
│ │
│ ・review_state の確定 │
│ ・理論の最終採否（しっくり感チェック） │
│ ・保持論点の解消 │
│ ・公開判定（develop → main マージ） │
└─────────────────────────────────────────────┘
health check（wiki-lint）
wiki の健全性を定期的にチェックするスキル。結果は health/ に出力される。
| チェック | 何を見るか | レポート |
|---|---|---|
| WL-1 CN divergence | 用語統一（Withhold→抱持）が全リポに反映されているか | cn-divergence-report |
| WL-2 用語統一 | canonical-keywords.md の禁止用語が wiki に残っていないか | WL-1 に統合 |
| WL-3 鮮度 | wiki の compiled 日 vs ソースの最終変更日 | freshness-report |
| WL-4 孤立ページ | どこからもリンクされていないページ | orphan-report |
| WL-5 source 実在 | front matter の source パスが実際に存在するか | WL-3 に統合 |
| WL-6 文字化け検出 | UTF-8 置換文字（U+FFFD）が wiki/*.md に含まれていないか | compile 時に検出 |
設計思想
Karpathy の LLM Knowledge Base パターン を参考に、既存のマルチリポ構成に追加レイヤーとして設計。
| Karpathy の概念 | この wiki での実装 |
|---|---|
| Raw Sources（不変） | 各リポの knowledge/, evidence/（変更なし） |
| Compiled Wiki（LLM 生成） | pd/wiki/（本ディレクトリ） |
| Schema（構造定義） | wiki-compile SKILL.md, canonical-keywords.md |
| Ingest | 各リポの knowledge を LLM が読み取る |
| Compile | wiki-compile スキルで markdown を生成 |
| Query & Enhance | Obsidian で閲覧・検索 |
| Lint & Maintain | wiki-lint スキルで health check |
設計原則
- 既存ファイル変更ゼロ — wiki は追加物。ソースを書き換えない
- 再生成可能 — wiki/ を全削除しても再 compile できる
- wikilink は冪等 — 辞書ベースの後処理。何度実行しても同じ結果
- 正本分離 — wiki は compiled view。正本は各リポの knowledge/evidence
Cross-Repo ソースの参照範囲
Step 3 で参照した各リポジトリの範囲。
| リポ | 参照パス | 用途 | wiki ページ |
|---|---|---|---|
| kesson-space | knowledge/schema/core-definitions.md | コア概念定義の正本 | 欠損, 欠損駆動思考, 抱持, 情動の構成 |
| kesson-space | knowledge/schema/glossary.md, container-mapping.md, hoji-matching-v2.md | 抱持の詳細構造 | 抱持 |
| kesson-space | knowledge/text/foundation/phase1-summary.md | 理論構造概要 | 欠損駆動思考, 欠損 |
| kesson-space | knowledge/text/clinical-psychology/ (7篇) | 臨床心理学との接続 | ネガティブケイパビリティ, 間主観性, 情動の構成, 内受容感覚 |
| kesson-space | knowledge/concepts/CN-001〜004 | ks 固有の概念ノート | 各 concepts に部分反映 |
| awareness-space | knowledge/topics/four-layers/ja/report.md | アウェアネスモデルの独自レポート | アウェアネスモデル, 内受容感覚 |
| awareness-space | knowledge/topics/survival-trust-axis/ja/report.md | 生存-信頼軸の独自レポート | 情動の構成, 間主観性 |
| creation-space | knowledge/five-stages-guide.md, glossary.md | 5段階モデル解説 | 創造の5段階モデル |
| creation-space | knowledge/schema/five-stages.md, academic-domains.md | 構造定義 | 創造の5段階モデル |
| creation-space | knowledge/domains/ (D01-D30) | 30ドメインの構造化レポート | creation-space-domains (cross-refs) |
不採用としたソース
- kdt (kesson-driven-thinking): アーカイブ済み。コンテンツは ks/cs に移行完了
- pjdhiro/_pages/pd/: 公開用正本。wiki compile 対象外
- as/concepts/CN-001,002: ks と同一起源（ks を正本とした）
- as/concepts/CN-005,006,007: pd と同一起源（Step 1 で pd を正本として compile 済み）
- cs/evidence/: 大容量生データ。cs/knowledge/ の構造化版を使用