jsonld-knowledge-graphlisted

# JSON-LD Knowledge Graph `graph.jsonld` を `llms.txt` の隣に置いて、project の concept-level architecture を schema.org JSON-LD triples として encode する skill。LLM が prose だけでは引き出しにくい entity 間の関係（matrix / hierarchy / phase-binding）を triple として citation 可能にする。 ## When to Use 以下を **すべて** 満たす project に適用する: - 安定した concept-level 構造を持つ - 例: matrix（4 Quadrants × N ADRs）、ordered hierarchy（prohibition-strength 3 levels）、phase-skill binding（6:6 bijective）、layered architecture（3 memory layers） - 構造が **release を跨いで安定**（vX.Y.Z bump で entity が増減しない） - LLM に当該関係を訊いた時に **prose だけでは答が出にくい / 誤答する** 経験的証拠がある - すでに `llms.txt` + `llms-full.txt`（Answer.AI 標準）を持っている ## When NOT to Use 以下のいずれかに該当する場合は **適用しない**: - 単一目的の linear project（matrix / hierarchy 構造がない） - 内部構造が release ごとに churn する（graph が編集負債になる） - `llms-full.txt` の prose Q&A で関係問題が既に十分答えられる - 「LLM citation 向上を狙いたい」だけで具体的な entity 関係問題がない（GEO 目的なら llms-txt-writer の方が direct） `graph.jsonld` は prose の代替ではなく **補完**。prose で表現しきれない構造があるとき、その構造をやっと拾える。 ## file-level 構造との関係（正本） `graph.jsonld` は **concept 層だけ** を保存する。file-level 構造（「X はどのファイルに住むか」「誰が誰を呼ぶか」）は保存せず、問いのたびにコードから導出する: | | file-level（導出、保存しない） | graph.jsonld（保存） | |---|---|---| | **対象** | ファイル / モジュール / call 関係 | 概念 / エンティティ | | **答える質問** | 「X はどのファイルに住んでいるか」「誰が Y を呼ぶか」 | 「X とは何か、X と Y はどう関係するか」 | | **源** | コードそのもの — Claude Code の LSP tool（`workspaceSymbol` / `findReferences` / `incomingCalls`）、`grimp` 等の import グラフ | JSON-LD triples（手で書く） | | **主読者** | 作業中の agent | AI search engine + LLM が