---
title: "commonplace"
url: "https://claudemods.dev/ja/builds/commonplace-2ee8a8"
source: "https://github.com/noopz/commonplace"
source_type: "github"
repo: "https://github.com/noopz/commonplace"
author: "noopz"
author_handle: "noopz"
stars: 11
category: "ワークフロー・CI"
categories: ["workflow"]
tags: ["hooks", "knowledge-base", "obsidian", "omanalysis", "skills", "wiki"]
permission_level: 3
scan_complete: false
install: "claude plugin marketplace add noopz/commonplace\nclaude plugin install commonplace"
added: "2026-10-05T00:53:20.513Z"
updated: "2026-11-17T06:27:51Z"
locale: "ja"
content_locale: "ja"
---

# commonplace

任意のフォルダーを LLM が管理するナレッジベースに変えます。commonplace book の伝統と、[Karpathy](https://x.com/karpathy/status/1899559051789553968) が LLM を個人 wiki の管理に使う方法に着想を得ています。

## Description

Obsidian vault でも普通のフォルダーでも、どのディレクトリでも使えます。Obsidian は必須ではありません。`[[wikilink]]` Markdown を使うなら、閲覧に適したブラウザーというだけです。

## できること

- **wiki-init**：初めて commonplace をフォルダーに向ける → `.wiki/` を足場として作り、初期ドメインを発見
- **wiki-ingest**：論文、記事、URL を共有 → 構造化された vault ノート + concepts + MOC リンク
- **wiki-query**：研究上の質問をする → wikilink 付きで回答し、新しいつながりをファイルに戻す
- **wiki-lint**：「vault の状態は？」と尋ねる → 読み取り専用のヘルスレポート
- **autoimprove**：「vault を改善」→ スコアで制御するループが修正を選び、実行し、再評価して繰り返す
- **wiki-compile**：原典の論文から実際の定義を使って概念スタブを埋める
- **wiki-supersede**：後継に置き換えられたエンティティを引退させ、live→historical の再構成を反映
- **wiki-domain**：スコープ規則付きの研究ドメインを作成または管理
- **wiki-deep-link**：ローカル埋め込み（Ollama）で隠れた概念のつながりを見つける
- **paper-analyzer**：スマートな PDF 抽出とマルチエージェントレビューで論文を深く分析

## 仕組み

スキルは自然な会話から自動的に起動します。スラッシュコマンドを入力する必要はありません。話しかければ、適切なスキルが起動します。

## インストール

```bash
git clone https://github.com/noopz/commonplace
cd commonplace
npm install

# vault を指定する
npx tsx scripts/init.ts --vault /path/to/your/vault
```

## 依存関係

- `gray-matter` — YAML frontmatter の解析
- `glob` — ファイルパターンの照合
- `pdfjs-dist` — PDF テキストの抽出
- `tsx` — TypeScript の実行

## Install

```
claude plugin marketplace add noopz/commonplace
claude plugin install commonplace
```

## Original README

# commonplace

A Claude Code plugin that turns any folder into an LLM-maintained knowledge base. Inspired by the commonplace book tradition and [Karpathy's approach](https://x.com/karpathy/status/1899559051789553968) to using LLMs for personal wiki management.

Works on any directory — Obsidian vault, plain folder, whatever. Obsidian is not required; it's just a good browser for `[[wikilink]]` markdown if you use it.

## What it does

- **wiki-init**: Point commonplace at a folder for the first time → scaffold `.wiki/`, discover initial domains
- **wiki-ingest**: Share a paper, article, or URL → structured vault note + concepts + MOC links
- **wiki-query**: Ask research questions → answers with wikilinks + novel connections filed back
- **wiki-lint**: Ask "how's the vault?" → read-only health report
- **autoimprove**: "improve the vault" → score-gated loop that picks fixes, executes, re-scores, repeats
- **wiki-compile**: Fill concept stubs with real definitions from source papers
- **wiki-supersede**: Retire an entity replaced by a successor, propagate the live→historical reframing
- **wiki-domain**: Create or manage research domains with scope rules
- **wiki-deep-link**: Find hidden concept connections via local embeddings (Ollama)
- **paper-analyzer**: Deep paper analysis with smart PDF extraction and multi-agent review

## How it works

Skills auto-trigger from natural conversation. You never type slash commands — just chat and the right skill activates.

## Skill interactions

```
                        ┌─────────────┐
                        │  wiki-init  │  (one-time setup)
                        └──────┬──────┘
                               │ writes .vault-path
                               ▼
            ┌──────────────────────────────────────┐
            │            (vault is active)         │
            └──────────────────────────────────────┘
                               │
            ┌──────────────────┼──────────────────────────┐
            │                  │                          │
            ▼                  ▼                          ▼
     ┌────────────┐    ┌─────────────┐            ┌──────────────┐
     │ wiki-domain│    │ wiki-ingest │ ◀───┐      │  wiki-query  │
     └────────────┘    └──────┬──────┘     │      └──────┬───────┘
       (new domain             │ paper?    │             │ pivot Q
        when ingest             │ ─yes──▶ paper-analyzer  │ "how does
        finds none)             │           (returns      │  this relate
                                │            analysis)    │  to X?")
                                ▼                        │
                        ┌──────────────┐                 │ ◀────┘
                        │ supersession │   (post-ingest pivot
                        │  declared in │    auto-fires wiki-query)
                        │   body? ──yes┼─▶ wiki-supersede
                        └──────┬───────┘
                               │ no
                               ▼
                       ┌────────────────┐
                       │ post-write hook│
                       │  (deterministic)│
                       └──────┬─────────┘
                              │ dispatches
              ┌───────────────┼─────────────────┐
              ▼               ▼                 ▼
      wiki-moc-updater  wiki-impact-checker  wiki-cross-domain-linker
                                  │
                                  └─ supersession candidate ──▶ wiki-supersede

  Read-only path:                    Autonomous-write path:
  ┌──────────────┐                   ┌──────────────┐
  │  wiki-lint   │ ◀── if fixes ──▶ │ autoimprove  │
  │  (diagnose)  │     wanted        │ (score loop) │
  └──────────────┘                   └──────┬───────┘
                                            │ dispatches per round
                          ┌─────────────────┼────────────────┬──────────────────┐
                          ▼                 ▼                ▼                  ▼
                   wiki-linter      wiki-pruner      wiki-moc-updater   wiki-deep-linker
                                   (refuses retired                       (semantic
                                    → wiki-supersede)                      candidates)
                                            │
                                            ▼
                                    wiki-compile (inline at main-model cost)
                                            │
                                            ▼
                                    wiki-freshness-checker (post-loop)

  Bottom-up triggers (any skill → wiki-supersede):
    • wiki-query lands on retired note
    • wiki-pruner asked to delete retired
    • wiki-impact-checker flags candidate
    • commonplace lint reports retired-but-referenced
```

| Skill | Triggers on | Hands off to | Receives from |
|---|---|---|---|
| wiki-init | first-time setup; missing `.vault-path` | (none) | (entry point) |
| wiki-domain | "set up a domain", "list domains" | (none) | wiki-ingest (no domain match) |
| wiki-ingest | "save this", arXiv ID, paper URL | paper-analyzer; wiki-supersede; wiki-domain; post-write hook | (entry point) |
| paper-analyzer | "analyze this paper"; arXiv without save intent | (returns analysis) | wiki-ingest |
| wiki-query | "how does X relate to Y"; post-ingest pivot | wiki-supersede (retired note) | wiki-ingest |
| wiki-supersede | "mark X retired"; body declares supersession; retired-but-live debt | (terminal) | wiki-ingest, wiki-query, wiki-pruner, wiki-impact-checker |
| wiki-lint | "how's the vault" — read-only | autoimprove (if fixes wanted) | (entry point) |
| autoimprove | "improve the vault", "what's the score" | wiki-linter, wiki-pruner, wiki-moc-updater, wiki-deep-linker, wiki-compile, wiki-freshness-checker | wiki-lint |
| wiki-compile | "fill the stubs" | (none) | autoimprove; wiki-lint |
| wiki-deep-link | "find hidden connections" (needs Ollama) | (none) | autoimprove (optional) |

Three-tier cost model:
1. **TypeScript scripts** (zero LLM cost) — indexing, validation, linting
2. **Haiku agents** (cheap) — mechanical fixes, wikilink insertion, MOC syncing
3. **Main model** (synthesis) — paper analysis, concept definitions, query answers

## Install

```bash
git clone https://github.com/noopz/commonplace
cd commonplace
npm install

# Point it at your vault
npx tsx scripts/init.ts --vault /path/to/your/vault
```

## Dependencies

- `gray-matter` — YAML frontmatter parsing
- `glob` — File pattern matching
- `pdfjs-dist` — PDF text extraction
- `tsx` — TypeScript execution
