commonplace

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 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