LLM Wiki Manager

LLM wiki kit

Created by sametbrr

Published in sametbrr/llm-wiki-manager. Publisher page

73 GitHub starsUpdated 2026-11-02

What it is

Agent Skills plugin for a persistent LLM-managed markdown wiki — ingest, cross-reference, cited queries and lint with 5 stdlib scripts

— the description by sametbrr

AutoGineer overview, from the brain’s own files

LLM Wiki Manager is an agent skill and plugin designed to implement the Karpathy LLM Wiki pattern. It shifts the paradigm from traditional RAG—where an LLM re-reads raw documents on every query—to a persistent, compounding knowledge base. The system maintains a clear division of labor: the user curates raw source files in a dedicated folder, while the agent manages the wiki layer, handling synthesis, cross-referencing, indexing, and bookkeeping. It includes idempotent Python scripts for maintenance tasks like linting, logging, and schema evolution, ensuring that knowledge remains structured and traceable over time.

How it works

Memory model: LLM wiki

AutoGineer overview, from the brain’s own files

The system organizes data into a three-layer model: a schema file for conventions, a raw folder for immutable source documents, and a wiki folder for synthesized content. The agent uses a set of Python scripts to manage this structure. When a user provides a source, the agent ingests it, summarizes the content, updates entity and concept pages, and logs the action. It supports advanced operations like semantic updates to propagate changes across multiple pages, automated health checks that generate dated reports, and multi-wiki routing to bridge project-specific and global knowledge bases.

Folders
Folder	Role	Files
.github	agent-config	2
skills	agent-instructions	27
tests	tests	1
.claude-plugin	folder	1
.codex-plugin	folder	1

The agent reads

CLAUDE.md evidence: README.md

The agent writes

Requirements

Works with: Claude Code, OpenAI Codex, GitHub Copilot, Cursor, Kiro, OpenCode, Amp, Cline, JetBrains Junie, Devin (ex-Windsurf)

Set it up

Download the brain as a ZIP and unzip it where you keep your notes or project: https://mp-staging.autogineer.com/agent-brains/sametbrr/llm-wiki-manager/download
Claude Code reads CLAUDE.md from this folder automatically.
cd llm-wiki-manager && claude
AutoGineer scanned these files at commit 28ad285.
Created by sametbrr. Published in sametbrr/llm-wiki-manager. Licence: MIT License.

Usage

AutoGineer overview, from the brain’s own files

Bootstrap a new wiki environment in a research folder.
Ingest PDF or text documents into the wiki.
Query the wiki for synthesized answers with citations.
Perform semantic updates to propagate information changes across the wiki.
Run automated health checks to identify broken links or orphan pages.
Route knowledge between project-specific and global wikis.

“Set up an LLM wiki here. Topic: history of nutrition science.”: The agent scaffolds the raw/ and wiki/ folders and initializes the schema file.
“Add this PDF to the wiki.”: The agent reads the source, writes a summary, updates relevant entity pages, and logs the ingestion.
“Smith 2024 supersedes Keys 1980, update the wiki.”: The agent performs a semantic sweep across all pages to update the superseded claim and logs the change.
“Lint the wiki.”: The agent runs a health check, generates a dated report in the reports folder, and updates the index.

Documentation by sametbrr

Image: Release Image: License: MIT Image: Agent Skills

Quick Start • Installation • Usage • Update mode • Multi-wiki • Compatibility

LLM Wiki Manager

An Agent Skill and plugin for Claude Code and Codex for building and maintaining a personal LLM-managed wiki — a persistent, compounding knowledge base where the LLM does all the writing, cross-referencing, and bookkeeping while you curate sources and ask questions.

🇹🇷 Türkçe için README.tr.md

Quick Start

claude plugin marketplace add sametbrr/skill-hub && claude plugin install llm-wiki-manager@skill-hub   # Claude Code
codex plugin marketplace add sametbrr/skill-hub && codex plugin add llm-wiki-manager@skill-hub         # Codex

Start a new session in your research folder:

mkdir ~/research/my-topic && cd ~/research/my-topic && claude   # or: codex
> "Set up an LLM wiki here. Topic: history of nutrition science."

Features

Instead of RAG — where the LLM rediscovers answers from raw documents on every query — this pattern has the LLM compile raw sources into a persistent, interlinked markdown wiki. Each new source enriches existing pages. Cross-references are built eagerly. Contradictions are flagged. Knowledge compounds over time.

Implements Karpathy's LLM Wiki pattern as a full agent skill with 9 operating modes (including multi-wiki routing and migrate), 5 idempotent Python scripts, 8 page templates, and 11 reference documents.

Without this pattern          With this pattern
────────────────────          ──────────────────
Query 1 → re-read 50 docs     Query 1 → read compiled wiki (already synthesized)
Query 2 → re-read 50 docs     Query 2 → read updated wiki (cross-refs already there)
Query 3 → re-read 50 docs     Query 3 → read updated wiki (contradictions already flagged)

Requirements

Claude Code, OpenAI Codex, or any agentskills.io-compatible agent
Python 3.9+ (stdlib only, for the 5 included scripts — no pip install needed)

Installation

Option 1 — Claude Code plugin (recommended)

claude plugin marketplace add sametbrr/skill-hub
claude plugin install llm-wiki-manager@skill-hub

Option 2 — Codex plugin

codex plugin marketplace add sametbrr/skill-hub
codex plugin add llm-wiki-manager@skill-hub

Option 3 — GitHub CLI, any agent (gh CLI with gh skill)

gh skill install sametbrr/llm-wiki-manager llm-wiki-manager --agent claude-code --scope user   # or --agent codex

Option 4 — manual copy: copy skills/llm-wiki-manager/ into ~/.claude/skills/ or ~/.agents/skills/.

After installing, start a new session. The skill loads automatically when relevant.

Usage

The skill auto-detects which mode applies from natural language. No slash commands needed.

> "Set up an LLM wiki here"                             # Bootstrap: scaffold raw/, wiki/ and the schema file
> "Add this PDF to the wiki"                            # Ingest: summarize, cross-reference, index, log
> "What does the wiki say about X?"                     # Query: answer with citations, offer to file back
> "Smith 2024 supersedes Keys 1980, update the wiki"    # Update: sweep every page that paraphrases the claim
> "Lint the wiki"                                       # Lint: dated health report in wiki/reports/
> "We should always do X going forward"                 # Schema-evolve: record a convention for future sessions
> "Add this to my global wiki"                          # Multi-wiki: route between project and global wiki
> "How does this pattern work?"                         # Teach: explain the pattern and compare it with RAG

Modes

Mode	Trigger examples	What happens
Bootstrap	"Set up a wiki", "start a knowledge base here"	Scaffolds `raw/`, `wiki/` and the schema file (`AGENTS.md` + a `CLAUDE.md` pointer) from templates
Ingest	"Add this PDF to the wiki", "I just read X, file it"	Reads source → writes summary → updates entity/concept pages → indexes → logs
Query	"What does the wiki say about X?", "Compare X and Y"	Reads index → candidate pages → synthesizes answer with citations → offers to file back
Update	"Smith 2024 supersedes Keys 1980, update the wiki"	Semantic sweep across all pages → diff-before-write per page → single log entry
Lint	"Health check the wiki", "anything broken?"	Runs `lint_wiki.py` → auto-saves `wiki/reports/lint-YYYY-MM-DD.md` → auto-tracks in index and log
Schema-evolve	"We should always do X going forward"	Updates the schema file (`AGENTS.md` / `CLAUDE.md`) so future sessions inherit the convention
Multi-wiki	"Add this to my global wiki", "promote this page to global"	Routes between project wiki and global wiki using the `External Wiki:` declaration in project `CLAUDE.md`
Teach	"How does this pattern work?", "explain the LLM wiki idea"	Explains the pattern, compares with RAG, walks through a concrete example

Full walkthrough

# 1. Go to your research folder
mkdir ~/research/my-topic && cd ~/research/my-topic && claude

# 2. Bootstrap the wiki
> "Set up an LLM wiki here. Topic: history of nutrition science."

# 3. Drop a source
cp ~/Downloads/pollan-2008.pdf raw/

# 4. Ingest it
> "Ingest Pollan's In Defense of Food"

# 5. Ask questions
> "What does the wiki say about nutritionism?"

# 6. Health check (auto-saves dated report to wiki/reports/)
> "Lint the wiki"

The three-layer model

your-wiki/
├── AGENTS.md          # Schema — conventions for this wiki (co-evolved over time)
├── CLAUDE.md          # One line: @AGENTS.md (Claude Code reads CLAUDE.md, Codex reads AGENTS.md)
├── raw/               # YOUR layer — immutable sources you curate. LLM reads, never writes.
└── wiki/              # LLM layer — all pages written and maintained by the LLM
    ├── index.md       # Content catalog (updated on every ingest)
    ├── log.md         # Append-only operation log (greppable)
    ├── hot.md         # Hot cache — most recently ingested sources and active references
    ├── sources/       # One summary page per ingested source
    ├── entities/      # People, organizations, places, products
    ├── concepts/      # Ideas, theories, frameworks, terms
    ├── notes/         # Filed-back query answers and loose pages
    └── reports/       # Auto-generated dated lint reports (wiki/reports/lint-YYYY-MM-DD.md)

Division of labor:

You do	The LLM does
Curate sources (decide what to read)	Read sources end-to-end
Ask questions, steer direction	Write summaries, entity and concept pages
Review the wiki, follow links	Update cross-references in-place
Decide what matters	Maintain index.md and log.md
Own `raw/`	Flag contradictions, surface gaps

You almost never write wiki pages by hand. The LLM does the bookkeeping — that's what makes the wiki compound instead of collapse.

Core disciplines

LLM owns wiki/. You own raw/. No exceptions.
Every operation logs to log.md via append_log.py. Greppable: grep "^## \[" log.md | tail -20
Every new or updated page touches index.md via update_index.py. Stale index = wiki that feels lost.
Cross-reference aggressively. When a source mentions an entity that already has a page, update that page. Don't leave connections implicit.
Cite back to raw/. Every claim is traceable to a specific source file.
Flag contradictions, don't overwrite. New source disagrees with old claim? Both stay, marked with their source, with a > [!warning] Sources disagree callout.
Schema lives in CLAUDE.md. When a convention works, write it down. The next session starts informed.

What's inside

Scripts (Python stdlib, no dependencies, all idempotent)

Script	Purpose
`scripts/init_wiki.py`	Scaffold a new wiki — creates `raw/`, `wiki/`, the schema file (`AGENTS.md` + `CLAUDE.md` pointer, or keeps an existing one), `index.md`, `log.md`, and `hot.md`. Idempotent.
`scripts/append_log.py`	Append a `## [YYYY-MM-DD] action \| title` entry to `log.md`. Supports flexible log path detection.
`scripts/update_index.py`	Add or update an entry under a category in `index.md`. Case-insensitive categories, keeps section order and content, follows the index link style (markdown or `[[wikilinks]]`), new categories go before `## Meta`.
`scripts/lint_wiki.py`	Health check. Detects orphan pages, broken links and index drift in both standard markdown and Obsidian wiki-link format (`[[page#heading]]`, `![[embed.png]]` included). Default: writes `wiki/reports/lint-<today>.md` and auto-tracks. Run `--stdout` for terminal output.
`scripts/migrate_wiki.py`	Schema upgrade (v1 → v2). Deduplicates `index.md`, moves dated changelog blocks from `hot.md` into `log.md`, stamps the schema version. Idempotent.

Templates

Template	Used for
`wiki-CLAUDE.md.tmpl`	The schema file dropped into a fresh wiki
`source-summary.md.tmpl`	One ingested source — claims, methodology, cross-links, open questions
`entity-page.md.tmpl`	People, organizations, places, products
`concept-page.md.tmpl`	Ideas, frameworks, theories, terms
`comparison-page.md.tmpl`	"X vs Y" pages, often filed-back query answers
`index.md.tmpl`	Initial content catalog
`log.md.tmpl`	Initial log with bootstrap entry
`hot.md.tmpl`	Initial hot cache — rewritten after each ingest with latest sources and active references

Reference docs

Eleven detailed workflow documents in references/: philosophy.md · architecture.md · bootstrap-workflow.md · ingest-workflow.md · query-workflow.md · update-workflow.md · lint-workflow.md · migrate-workflow.md · schema-design-guide.md · multi-wiki-routing.md · teaching-mode.md

The skill reads these selectively — you don't need to. They're there to give the LLM depth on each mode.

Update mode

Standard ingest already handles contradictions on a single page (Disputes section). Update mode is for when a new source supersedes a claim that's paraphrased across multiple pages — the same idea written four different ways in four different files.

Scenario: Smith 2024 reanalysis shows Keys 1980's seven-countries study cherry-picked data.
The Keys r=0.87 claim appears as:
  concepts/saturated-fat.md     → "Keys found r=0.87 across seven countries"
  entities/ancel-keys.md        → "famous for showing strong correlation"
  concepts/heart-disease.md     → "saturated fat is a primary driver per Keys"
  concepts/dietary-policy.md    → "the saturated fat hypothesis drove decades of policy"

Update mode:
  1. Semantic sweep — finds all four (grep won't, LLM will)
  2. Shows scope: "4 pages affected. Proceed?"
  3. Diff-before-write per page — y/n/skip/edit per change
  4. Per-page strategy: revise / disputes / annotate (not one-size-fits-all)
  5. One log entry tying all four edits to Smith 2024

This is change propagation, not change tracking. The log and frontmatter track what was edited. Update mode ensures the edit reaches everywhere it should.

Auto-dated lint reports

lint_wiki.py with no flags:

Writes wiki/reports/lint-YYYY-MM-DD.md (overwrites same-day run — idempotent daily)
Adds a Reports index entry automatically
Appends a lint | Health check log entry automatically
Exits with code 1 if any block-severity issue found (useful for CI)

Reports accumulate as a longitudinal health record. git log wiki/reports/ shows how wiki quality evolved over time.

Override flags: --stdout (terminal, no tracking), --no-track (write file, skip index/log), --report PATH (custom path).

Multi-wiki

Most users start with one wiki. Once you have two — say, a per-project wiki at the working directory plus a long-lived global "second brain" (often an existing Obsidian vault) — the skill routes writes between them based on a single declaration in the project's CLAUDE.md.

~/projects/x-project/          ← active project (current working directory)
├── CLAUDE.md                  ← project schema — declares the global wiki path
├── raw/                       ← project sources
└── wiki/                      ← project wiki

~/Documents/obsidian/          ← global wiki (long-lived, exists across projects)
├── CLAUDE.md                  ← global schema
├── raw/
└── wiki/

One-time setup

Add this to the project's CLAUDE.md (or ask the agent to do it):

## External Wiki

Global knowledge base: ~/Documents/obsidian/

### Routing rules
- Project-specific code decisions, architecture, bugs, configuration → this project's `wiki/`
- Concepts, frameworks, patterns, ideas applicable beyond this project → global wiki
- When in doubt, ask before writing
- Scripts always need `--path` flag pointing to the right wiki root

### Cross-wiki links
- Use absolute paths (`~/...`) when linking from one wiki to the other.
- Never use relative paths that cross wiki boundaries.

Four canonical scenarios

#	Scenario	Trigger	What the agent does
A	Write to global while in a project	"Add JWT refresh rotation to my global wiki"	Reads project `CLAUDE.md` → resolves global path → writes to global, project wiki untouched
B	Pull from global into a project	"What does the global wiki say about rate limiting? Apply it to /api/search"	Reads global pages → synthesizes recommendation → writes a project-specific page that links to the global one (never copies)
C	Promote a page from project to global	"concepts/event-sourcing.md has matured, promote it"	Moves content to global → leaves a one-line redirect stub at the project path → updates both indexes and logs
D	Lint both wikis at once	"Lint both wikis"	Runs `lint_wiki.py --path` against each → reads both reports → returns one summary

Full walkthroughs of all four scenarios in references/multi-wiki-routing.md.

Compatibility

Tool	Install	Schema file it reads
Claude Code	plugin (`claude plugin install llm-wiki-manager@skill-hub`) or `~/.claude/skills/`	`CLAUDE.md`
OpenAI Codex	plugin (`codex plugin add llm-wiki-manager@skill-hub`) or `~/.agents/skills/`	`AGENTS.md`
GitHub Copilot, Cursor, Gemini CLI, …	`gh skill install … --agent <name>`	usually `AGENTS.md`

A wiki that keeps its schema in AGENTS.md with a one-line CLAUDE.md (@AGENTS.md) works in all of them; init_wiki.py sets that up.

Karpathy's LLM Wiki gist — the original idea
agentskills.io — open standard spec

Contributing

Questions and ideas: Discussions
Bugs: issue tracker
Pull requests: read the contribution guide first
Security reports: follow the security policy, not a public issue

License

MIT — see LICENSE.

Report Bug · Request Feature

</div>

README.tr.md

Image: Release Image: License: MIT Image: Agent Skills

Hızlı Başlangıç • Kurulum • Kullanım • Update Modu • Çok-Wiki • Uyumluluk

LLM Wiki Manager

Kişisel, LLM tarafından yönetilen bir wiki oluşturmak ve sürdürmek için Claude Code ve Codex'e yönelik bir Agent Skill ve plugin — LLM tüm yazma, çapraz referans ve kayıt tutma işlerini yaparken siz kaynakları seçip sorular sorarsınız.

🇬🇧 For English see README.md

Hızlı Başlangıç

claude plugin marketplace add sametbrr/skill-hub && claude plugin install llm-wiki-manager@skill-hub   # Claude Code
codex plugin marketplace add sametbrr/skill-hub && codex plugin add llm-wiki-manager@skill-hub         # Codex

Araştırma klasörünüzde yeni bir oturum başlatın:

mkdir ~/research/my-topic && cd ~/research/my-topic && claude   # ya da: codex
> "Set up an LLM wiki here. Topic: history of nutrition science."

Özellikler

RAG'dan farklı olarak — LLM'nin her sorguda ham belgelerden cevap yeniden keşfettiği yaklaşım — bu pattern LLM'nin ham kaynakları kalıcı, birbiriyle bağlantılı bir markdown wiki'sine derlemesini sağlar. Her yeni kaynak mevcut sayfaları zenginleştirir. Çapraz referanslar hevesle kurulur. Çelişkiler işaretlenir. Bilgi zamanla birikerek büyür.

Karpathy'nin LLM Wiki pattern'ini 9 çalışma modu (çok-wiki yönlendirme ve migrate dahil), 5 idempotent Python scripti, 8 sayfa şablonu ve 11 referans belgeyle tam bir agent skill'i olarak uygular.

Bu pattern olmadan                    Bu pattern ile
────────────────────                  ──────────────────
Sorgu 1 → 50 belge yeniden okunur     Sorgu 1 → derlenmiş wiki okunur (zaten sentezlendi)
Sorgu 2 → 50 belge yeniden okunur     Sorgu 2 → güncel wiki okunur (çapraz referanslar hazır)
Sorgu 3 → 50 belge yeniden okunur     Sorgu 3 → güncel wiki okunur (çelişkiler işaretlendi)

Gereksinimler

Claude Code, OpenAI Codex veya herhangi bir agentskills.io uyumlu agent
Python 3.9+ (yalnızca stdlib, dahil 5 script için — pip kurulumu gerekmez)

Kurulum

Seçenek 1 — Claude Code plugin'i (önerilen)

claude plugin marketplace add sametbrr/skill-hub
claude plugin install llm-wiki-manager@skill-hub

Seçenek 2 — Codex plugin'i

codex plugin marketplace add sametbrr/skill-hub
codex plugin add llm-wiki-manager@skill-hub

Seçenek 3 — GitHub CLI, herhangi bir agent (gh skill destekli gh CLI)

gh skill install sametbrr/llm-wiki-manager llm-wiki-manager --agent claude-code --scope user   # ya da --agent codex

Seçenek 4 — elle kopyalama: skills/llm-wiki-manager/ klasörünü ~/.claude/skills/ ya da ~/.agents/skills/ altına kopyalayın.

Kurduktan sonra yeni bir oturum başlatın. Skill gerektiğinde otomatik yüklenir.

Kullanım

Skill, doğal dilden hangi modun uygulanacağını otomatik olarak algılar. Slash komutu gerekmez.

> "Set up an LLM wiki here"                             # Bootstrap: raw/, wiki/ ve şema dosyasını kurar
> "Add this PDF to the wiki"                            # Ingest: özetler, çapraz bağlar, indeksler, loglar
> "What does the wiki say about X?"                     # Query: alıntılı cevap verir, kaydetmeyi teklif eder
> "Smith 2024 supersedes Keys 1980, update the wiki"    # Update: iddiayı içeren tüm sayfaları tarar
> "Lint the wiki"                                       # Lint: wiki/reports/ içine tarihli sağlık raporu
> "We should always do X going forward"                 # Schema-evolve: gelecek oturumlar için bir kural kaydeder
> "Add this to my global wiki"                          # Multi-wiki: proje ve global wiki arasında yönlendirir
> "How does this pattern work?"                         # Teach: pattern'i açıklar, RAG ile karşılaştırır

Modlar

Mod	Tetikleyici örnekler	Ne olur
Bootstrap	"Wiki kur", "burada bir bilgi tabanı başlat"	`raw/`, `wiki/` ve şema dosyasını (`AGENTS.md` + `CLAUDE.md` yönlendirmesi) şablonlardan oluşturur
Ingest	"Bu PDF'i wiki'ye ekle", "X'i az önce okudum, kaydet"	Kaynağı okur → özet yazar → varlık/kavram sayfalarını günceller → indeksler → loglar
Query	"Wiki X hakkında ne diyor?", "X ile Y'yi karşılaştır"	İndeksi okur → aday sayfalar → alıntılı cevap sentezler → kaydetmeyi teklif eder
Update	"Smith 2024, Keys 1980'in yerini aldı, wiki'yi güncelle"	Tüm sayfalarda semantik tarama → sayfa başına diff-before-write → tek log girişi
Lint	"Wiki'yi kontrol et", "bir sorun var mı?"	`lint_wiki.py` çalıştırır → `wiki/reports/lint-YYYY-MM-DD.md` kaydeder → indeks ve log'a ekler
Schema-evolve	"Bundan böyle her zaman X yapmalıyız"	Şema dosyasını (`AGENTS.md` / `CLAUDE.md`) günceller, böylece gelecek oturumlar bu kuralı bilir
Multi-wiki	"Bunu global wiki'me ekle", "global wiki hakkında ne diyor"	Proje `CLAUDE.md`'sindeki bildirgeye göre wiki'ler arasında yönlendirir
Teach	"Bu pattern nasıl çalışıyor?", "LLM wiki fikrini açıkla"	Pattern'i açıklar, RAG ile karşılaştırır, somut bir örnek üzerinden anlatır

Tam adımlar

# 1. Araştırma klasörünüze gidin
mkdir ~/research/my-topic && cd ~/research/my-topic && claude

# 2. Wiki'yi başlatın
> "Set up an LLM wiki here. Topic: history of nutrition science."

# 3. Kaynak ekleyin
cp ~/Downloads/pollan-2008.pdf raw/

# 4. İçeri aktarın
> "Ingest Pollan's In Defense of Food"

# 5. Sorular sorun
> "What does the wiki say about nutritionism?"

# 6. Sağlık kontrolü (wiki/reports/ içine tarihli rapor kaydeder)
> "Lint the wiki"

Üç Katmanlı Model

your-wiki/
├── AGENTS.md          # Şema — bu wiki için kurallar (zamanla birlikte evrilir)
├── CLAUDE.md          # Tek satır: @AGENTS.md (Claude Code CLAUDE.md'yi, Codex AGENTS.md'yi okur)
├── raw/               # SİZİN katmanınız — değiştirilemez kaynaklar. LLM okur, asla yazmaz.
└── wiki/              # LLM katmanı — tüm sayfalar LLM tarafından yazılır ve sürdürülür
    ├── index.md       # İçerik kataloğu (her içe aktarmada güncellenir)
    ├── log.md         # Sadece ekleme yapılan işlem günlüğü (grep'lenebilir)
    ├── hot.md         # Sıcak önbellek — son eklenen kaynaklar ve aktif referanslar
    ├── sources/       # İçe aktarılan her kaynak için bir özet sayfası
    ├── entities/      # Kişiler, kuruluşlar, yerler, ürünler
    ├── concepts/      # Fikirler, teoriler, çerçeveler, terimler
    ├── notes/         # Kaydedilen sorgu cevapları ve serbest sayfalar
    └── reports/       # Otomatik oluşturulan tarihli lint raporları (wiki/reports/lint-YYYY-MM-DD.md)

İş bölümü:

Siz yaparsınız	LLM yapar
Kaynakları seçin (ne okunacağına karar verin)	Kaynakları baştan sona okur
Sorular sorun, yönlendirin	Özetler, varlık ve kavram sayfaları yazar
Wiki'yi inceleyin, linkleri takip edin	Çapraz referansları yerinde günceller
Neyin önemli olduğuna karar verin	index.md ve log.md'yi sürdürür
`raw/` dizinine sahip olun	Çelişkileri işaretler, boşlukları ortaya çıkarır

Wiki sayfalarını neredeyse hiç elinizle yazmazsınız. LLM kayıt işlemlerini yapar — bu, wiki'nin çökmek yerine birikmesini sağlayan şeydir.

Temel Disiplinler

LLM wiki/'ye sahiptir. Siz raw/'a. İstisna yok.
Her işlem log.md'ye loglanır — append_log.py ile. Grep'lenebilir: grep "^## \[" log.md | tail -20
Her yeni veya güncellenen sayfa index.md'ye dokunur — update_index.py ile. Eski indeks = kaybolmuş hissettiren wiki.
Çapraz referansları agresif olarak kurun. Bir kaynak zaten sayfası olan bir varlıktan bahsediyorsa o sayfayı güncelleyin. Bağlantıları örtük bırakmayın.
raw/'a atıfta bulunun. Her iddia belirli bir kaynak dosyasına kadar izlenebilir olmalıdır.
Çelişkileri işaretleyin, üzerine yazmayın. Yeni kaynak eski iddiaya katılmıyor mu? Her ikisi de kaynağıyla işaretli kalır, > [!warning] Sources disagree notuyla.
Şema CLAUDE.md'de yaşar. Bir kural işe yarıyorsa yazın. Bir sonraki oturum bilgili başlar.

İçinde Neler Var

Scriptler (Python stdlib, bağımlılık yok, hepsi idempotent)

Script	Amaç
`scripts/init_wiki.py`	Yeni bir wiki oluşturur — `raw/`, `wiki/`, şema dosyası (`AGENTS.md` + `CLAUDE.md` yönlendirmesi ya da mevcut olanı korur), `index.md`, `log.md` ve `hot.md` oluşturur. İdempotent.
`scripts/append_log.py`	`log.md`'ye `## [YYYY-MM-DD] eylem \| başlık` girişi ekler. Esnek log yolu tespitini destekler.
`scripts/update_index.py`	`index.md`'de bir kategori altına giriş ekler veya günceller. Kategoriler büyük/küçük harfe duyarsız eşleşir, bölüm sırası ve içeriği korunur, link stili (markdown ya da `[[wikilink]]`) index'e uyar, yeni kategoriler `## Meta`'dan önce eklenir.
`scripts/lint_wiki.py`	Sağlık kontrolü. Hem standart markdown hem Obsidian wiki-link formatında (`[[sayfa#başlık]]`, `![[embed.png]]` dahil) yetim sayfaları, kırık linkleri ve indeks kaymasını tespit eder. Varsayılan: `wiki/reports/lint-<bugün>.md` yazar ve otomatik takip eder.
`scripts/migrate_wiki.py`	Şema yükseltme (v1 → v2). `index.md`'yi tekilleştirir, `hot.md`'deki tarihli changelog bloklarını `log.md`'ye taşır, şema sürümünü damgalar. İdempotent.

Şablonlar

Şablon	Kullanım yeri
`wiki-CLAUDE.md.tmpl`	Yeni wiki'ye düşürülen şema dosyası
`source-summary.md.tmpl`	İçe aktarılan bir kaynak — iddialar, metodoloji, çapraz bağlantılar, açık sorular
`entity-page.md.tmpl`	Kişiler, kuruluşlar, yerler, ürünler
`concept-page.md.tmpl`	Fikirler, çerçeveler, teoriler, terimler
`comparison-page.md.tmpl`	"X vs Y" sayfaları
`index.md.tmpl`	İlk içerik kataloğu
`log.md.tmpl`	Bootstrap girdisiyle ilk log
`hot.md.tmpl`	İlk sıcak önbellek — her içe aktarmadan sonra yeniden yazılır

Referans Belgeler

references/ içinde on bir ayrıntılı iş akışı belgesi: philosophy.md · architecture.md · bootstrap-workflow.md · ingest-workflow.md · query-workflow.md · update-workflow.md · lint-workflow.md · migrate-workflow.md · schema-design-guide.md · multi-wiki-routing.md · teaching-mode.md

Skill bunları seçici olarak okur — sizin okumanıza gerek yok. Her mod için LLM'e derinlik sağlamak amacıyla buradalar.

Update Modu

Standart ingest tek bir sayfadaki çelişkileri zaten işler (Disputes bölümü). Update modu, yeni bir kaynağın birden fazla sayfada farklı biçimlerde parafraz edilmiş bir iddiayı geçersiz kılması durumu içindir.

Senaryo: Smith 2024 analizi, Keys 1980'in yedi ülke çalışmasının verileri seçici kullandığını gösteriyor.
Keys r=0.87 iddiası şu şekillerde geçiyor:
  concepts/saturated-fat.md     → "Keys yedi ülkede r=0.87 buldu"
  entities/ancel-keys.md        → "güçlü korelasyon göstermesiyle ünlü"
  concepts/heart-disease.md     → "Keys'e göre doymuş yağ birincil etken"
  concepts/dietary-policy.md    → "doymuş yağ hipotezi on yıllarca politikayı yönlendirdi"

Update modu:
  1. Semantik tarama — dördünü de bulur (grep bulamaz, LLM bulur)
  2. Kapsam gösterir: "4 sayfa etkilendi. Devam edilsin mi?"
  3. Sayfa başına diff-before-write — her değişiklik için y/n/skip/edit
  4. Sayfa başına strateji: revise / disputes / annotate (tek tip değil)
  5. Dört düzenlemeyi de Smith 2024'e bağlayan tek log girişi

Bu, değişiklik yayılımıdır, değişiklik takibi değil. Neyin düzenlendiğini log ve frontmatter takip eder. Update modu, düzenlemenin ulaşması gereken her yere ulaşmasını sağlar.

Otomatik Tarihli Lint Raporları

lint_wiki.py bayrak olmadan çalıştırıldığında:

wiki/reports/lint-YYYY-MM-DD.md yazar (aynı gün tekrar çalıştırıldığında üzerine yazar — günlük idempotent)
Otomatik olarak Reports indeks girişi ekler
Otomatik olarak lint | Sağlık kontrolü log girişi ekler
Herhangi bir blok-önem düzeyinde sorun bulunursa kod 1 ile çıkar (CI için kullanışlı)

Override bayrakları: --stdout (terminal, takip yok), --no-track (dosya yaz, indeks/log atla), --report PATH (özel yol).

Çok-Wiki

Çoğu kullanıcı tek bir wiki ile başlar. İki wiki'niz olduğunda — örneğin çalışma dizinindeki proje wikisi ve uzun ömürlü global bir "second brain" (çoğu zaman mevcut bir Obsidian vault'u) — skill, yazmaları projenin CLAUDE.md'sindeki tek bir tanıma göre ikisi arasında yönlendirir.

~/projects/x-project/          ← aktif proje (geçerli çalışma dizini)
├── CLAUDE.md                  ← proje şeması — global wiki yolunu tanımlar
├── raw/                       ← proje kaynakları
└── wiki/                      ← proje wikisi

~/Documents/obsidian/          ← global wiki (uzun ömürlü, projeler arası)
├── CLAUDE.md                  ← global şema
├── raw/
└── wiki/

Tek Seferlik Kurulum

Projenin CLAUDE.md'sine şunu ekleyin (ya da agent'tan eklemesini isteyin):

## External Wiki

Global knowledge base: ~/Documents/obsidian/

### Routing rules
- Project-specific code decisions, architecture, bugs, configuration → this project's `wiki/`
- Concepts, frameworks, patterns, ideas applicable beyond this project → global wiki
- When in doubt, ask before writing
- Scripts always need `--path` flag pointing to the right wiki root

### Cross-wiki links
- Use absolute paths (`~/...`) when linking from one wiki to the other.
- Never use relative paths that cross wiki boundaries.

Yönlendirme kuralları projeye özgü bilgiyi proje wikisine, projeden bağımsız bilgiyi global wikiye gönderir. Wikiler arası bağlantılar her zaman mutlak yolla (~/...) verilir; wiki sınırını aşan göreli yol kullanılmaz.

Dört Temel Senaryo

#	Senaryo	Tetikleyici	Agent ne yapar
A	Projedeyken global'e yaz	"JWT refresh rotasyonunu global wiki'me ekle"	Proje `CLAUDE.md`'sini okur → global yolu çözer → global'e yazar, proje wikisine dokunmaz
B	Global'den projeye çek	"Global wiki rate limiting hakkında ne diyor? /api/search'e uygula"	Global sayfaları okur → öneri sentezler → global sayfaya bağlantı veren (asla kopyalamayan) projeye özel bir sayfa yazar
C	Proje sayfasını global'e taşı	"concepts/event-sourcing.md olgunlaştı, taşı onu"	İçeriği global'e taşır → proje yolunda tek satırlık yönlendirme bırakır → iki indeksi ve logu günceller
D	İki wiki'yi birlikte lint et	"İki wiki'yi de lint et"	Her birinde `lint_wiki.py --path` çalıştırır → iki raporu okur → tek özet döner

Dört senaryonun ayrıntılı anlatımı references/multi-wiki-routing.md dosyasında.

Uyumluluk

Araç	Kurulum	Okuduğu şema dosyası
Claude Code	plugin (`claude plugin install llm-wiki-manager@skill-hub`) ya da `~/.claude/skills/`	`CLAUDE.md`
OpenAI Codex	plugin (`codex plugin add llm-wiki-manager@skill-hub`) ya da `~/.agents/skills/`	`AGENTS.md`
GitHub Copilot, Cursor, Gemini CLI, …	`gh skill install … --agent <ad>`	genelde `AGENTS.md`

Şemayı AGENTS.md'de tutan ve tek satırlık bir CLAUDE.md (@AGENTS.md) içeren wiki hepsinde çalışır; init_wiki.py bunu kurar.

İlgili

Karpathy'nin LLM Wiki gist'i — orijinal fikir
agentskills.io — açık standart spesifikasyonu

Katkıda Bulunma

Sorular ve fikirler: Discussions
Hatalar: issue takibi
Pull request'ler: önce katkı rehberini okuyun
Güvenlik bildirimleri: herkese açık issue yerine güvenlik politikasını izleyin

Lisans

MIT — bkz. LICENSE.

Hata Bildir · Özellik İste

</div>

40 files

Advantages

Compounding knowledge base that synthesizes information rather than re-reading raw documents on every query. evidence: README.md
Automated bookkeeping and cross-referencing reduce manual maintenance effort. evidence: README.md
Idempotent scripts ensure reliable operations without external dependencies. evidence: README.md

Limitations

Requires strict adherence to the division of labor between the raw source folder and the LLM-managed wiki folder. evidence: README.md
Multi-wiki routing requires manual configuration of paths in the schema file. evidence: README.md

Security

Risk level: No risk found

This brain runs

Agent instructions that run or fetch something (8)

AGENTS.md: `tests/test_scripts.py`: functional tests that run every script against temp wikis.
AGENTS.md: `python3 -m unittest discover -s tests`
AGENTS.md: Codex: install from a local marketplace in an isolated `CODEX_HOME`;
skills/llm-wiki-manager/SKILL.md: Run them by path relative to this skill's directory, and always pass `--path <wiki-root>`.
skills/llm-wiki-manager/SKILL.md: If it is lower than the version this skill expects, offer one sentence before starting the requested work: *"This wiki is at schema v1, the skill expects v2 — run `scripts/migrate_wiki.py` first?"* Don't block the requested operation if the user declines;
skills/llm-wiki-manager/SKILL.md: If the section is missing and a multi-wiki operation is requested, **run Schema-evolve first** to add it, then proceed.
skills/llm-wiki-manager/SKILL.md: Some users run two wikis: a per-project wiki at the working directory and a long-lived global wiki (often an existing Obsidian vault) at a fixed path.
skills/llm-wiki-manager/SKILL.md: unstamped = v1), shows a **dry-run** of the mechanical steps plus the manual (LLM) steps, applies with `--apply` only.

Attribution and licence

Created by

sametbrr

Declared authors

sametbrr (declared in .claude-plugin/plugin.json)

Publisher

Samet Birer (Community)

Source

sametbrr/llm-wiki-manager · commit 28ad285

Licence

MIT License (files served here)

ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-12

AutoGineer is not affiliated with or endorsed by sametbrr.

Download

The ZIP holds the files AutoGineer serves, with ATTRIBUTION.md and the licence. Download llm-wiki-manager.zip

What it is

How it works

Requirements

Set it up

Usage

Documentation by sametbrr

LLM Wiki Manager

Quick Start

Features

Requirements

Installation

Usage

Modes

Full walkthrough

The three-layer model

Core disciplines

What's inside

Scripts (Python stdlib, no dependencies, all idempotent)

Templates

Reference docs

Update mode

Auto-dated lint reports

Multi-wiki

One-time setup

Four canonical scenarios

Compatibility

Related

Contributing

License

LLM Wiki Manager

Hızlı Başlangıç

Özellikler

Gereksinimler

Kurulum

Kullanım

Modlar

Tam adımlar

Üç Katmanlı Model

Temel Disiplinler

İçinde Neler Var

Scriptler (Python stdlib, bağımlılık yok, hepsi idempotent)

Şablonlar

Referans Belgeler

Update Modu

Otomatik Tarihli Lint Raporları

Çok-Wiki

Tek Seferlik Kurulum

Dört Temel Senaryo

Uyumluluk

İlgili

Katkıda Bulunma

Lisans

Advantages

Limitations

Security

This brain runs

Attribution and licence

Download