karpathy-llm-wiki
CLAUDE.md2 starsChanged 6 months agoMITView on GitHub
Obsidian-vault, управляемый агентом. Реализует паттерн LLM Wiki — постоянная, накапливающаяся база знаний. Скиллы: /ingest, /query, /study, /lint, /save, /brainstorm, /edge, /snapshot, /transcribe, /defuddle, /obsidian-bases, /obsidian-markdown, /help Дашборд: wiki/meta/vault-explorer.html — открой в Obsidian (через HTML-плагин) или в браузере. Лёгкие метрики (счётчики, time-series, pulse, word cloud, distributions, health score) обновляются автоматически после каждого turn'а через Stop-hook (bin/update_dashboard.py). Тяжёлая часть (UMAP, force-graph, sankey, treemap, инсайты к 5 картам) — через /snapshot или раз в сутки.
In this repository13 other files it gives its agents.
- brainstormSkill
- defuddleSkill
- edgeSkill
- helpSkill
- ingestSkill
- lintSkill
- obsidian-basesSkill
- obsidian-markdownSkill
- querySkill
- saveSkill
- snapshotSkill
- studySkill
- transcribeSkill
The file
Files
LLM Wiki
Obsidian-vault, управляемый агентом. Реализует паттерн LLM Wiki — постоянная, накапливающаяся база знаний.
Скиллы: /ingest, /query, /study, /lint, /save, /brainstorm, /edge, /snapshot, /transcribe, /defuddle, /obsidian-bases, /obsidian-markdown, /help
Дашборд: wiki/meta/vault-explorer.html — открой в Obsidian (через HTML-плагин) или в браузере. Лёгкие метрики (счётчики, time-series, pulse, word cloud, distributions, health score) обновляются автоматически после каждого turn'а через Stop-hook (bin/update_dashboard.py). Тяжёлая часть (UMAP, force-graph, sankey, treemap, инсайты к 5 картам) — через /snapshot или раз в сутки.
Структура wiki
| Путь | Назначение | Владелец | Режим агента |
raw/ | Источники (md, pdf, docx, транскрипты) | пользователь, transcribe (только конвертация из raw/formats/) | create |
raw/formats/ | Бинарные оригиналы (видео/аудио/изображения) | пользователь | read-only |
raw/brainstorm/ | Транскрипты brainstorm-сессий | brainstorm | create |
raw/meta/* | Эмбеддинги источников, dedup-манифест | bin/embed.py, ingest | generated |
_attachments/ | Вложения для wiki-страниц | ingest | create |
_templates/ | Шаблоны Obsidian Templater | пользователь | read-only |
wiki/ideas/ | Концепции, механизмы, теории | ingest | create + edit |
wiki/entities/ | Люди, статьи, библиотеки, модели | ingest | create + edit |
wiki/domains/ | Навигационные хабы по областям (MOC) | ingest (порог N=10) | create + edit |
wiki/questions/ | Сохранённые ответы из /save, /query | save, query | create + edit |
wiki/minds/ | Мысли пользователя (через /brainstorm) | brainstorm | create + edit |
wiki/index.md | Каталог всех страниц | bin/gen_index.py | generated |
wiki/log.md | Журнал операций | все скиллы | append (сверху) |
wiki/cache.md | Горячий кэш ~500 слов (актуальный контекст) | ingest, save, query, brainstorm | overwrite |
wiki/summary.md | Обзор vault (счётчики, статус) | ingest | overwrite |
wiki/meta/vault-explorer.html | Живой дашборд vault: метрики, time-series, карты, инсайты | bin/update_dashboard.py (Stop-hook), bin/knowledge_map.py (/snapshot) | generated (overwrite) |
wiki/meta/snapshots/history.jsonl | Append-only журнал метрик для time-series и pulse | bin/update_dashboard.py | append |
wiki/meta/snapshots/heavy.json | Свежий sankey/treemap/инсайты для дашборда | bin/knowledge_map.py + ручная правка /snapshot | overwrite |
wiki/meta/vendor/ | Vendored Chart.js + плагины (зеркало bin/vendor/) | bin/update_dashboard.py::ensure_vendor() | generated |
wiki/meta/* (прочее) | Эмбеддинги, lint-state, дашборды Bases | bin/*, lint, gen_dashboards.py | generated |
Режимы:
- read-only — агент не пишет (источники, шаблоны, скрипты)
- create — создаёт новые файлы, существующие не правит
- create + edit — создаёт и точечно правит (Edit, не перезапись)
- append — только добавляет, старое не правится
- overwrite — перезаписывает целиком при каждом обновлении
- generated — derivable артефакт, можно безопасно удалить и пересчитать
Кэш контекста
wiki/cache.md — саммари недавнего контекста на ~500 слов. Существует чтобы любая сессия могла получить недавний контекст без полного обхода wiki.
Режим записи — curated rewrite, не append. Файл каждый раз переписывается целиком (Write, не Edit), но содержимое накапливается по правилам ниже. То есть не «забыть всё, что было» и не «дописать сверху»: переписать целиком так, чтобы он отражал актуальное состояние работы за последние несколько недель.
Обновляй cache.md:
- После каждого ingest
- После любого значимого обмена через query
- После save / brainstorm / study, которые создали новую страницу
- В конце сессии при завершении работы
Формат:
---
type: meta
title: "Кэш контекста"
updated: YYYY-MM-DDTHH:MM
---
# Недавний контекст
## Последнее обновление
YYYY-MM-DD. [что произошло в этот раз — 2-4 предложения, что ingest'ировано / о чём query, какие страницы созданы, ключевая связь]
## Ключевые факты
- [[Концепт]] — одно предложение сути, без раскрытия деталей.
- [[Другой концепт]] — формула или ключевое отношение в одну строку.
- ... (6–10 буллетов)
## Недавние изменения
- YYYY-MM-DD: что произошло, какие страницы затронуты ([[wikilink]]).
- ... (3–5 строк, FIFO)Правила обновления секций:
## Последнее обновление— действительно overwrite. Каждое обновление полностью заменяет одной строкой про самый свежий turn.## Ключевые факты— якоря к темам, которые сейчас в работе. Лимит 6-10 буллетов. Правила вытеснения:- Новая страница, важная поперёк vault (cross-link к нескольким доменам, ключевой концепт для текущей задачи) → добавь и вытесни наименее актуальный.
- Кандидат на вытеснение — буллет, который (а) не звучал в работе последние 2-3 недели и (б) семантически покрыт другим буллетом из списка или index.md.
- Не превращай в исторический архив. Если буллет старше месяца и не используется — вытесняй.
## Недавние изменения— FIFO 3-5 строк. Новая строка сверху, нижняя вытесняется.
Бюджет: wc -w wiki/cache.md ≤ 700 слов (целевые ~500). Если разрастается — сжимай буллеты в Ключевых фактах или вытесняй.
Frontmatter
_templates/ — источник правды для схем. При создании страницы бери шаблон и заполняй его поля, не добавляя новых без причины.
Общие правила
- Каждая wiki-страница начинается с YAML frontmatter.
- Frontmatter плоский: поля могут быть строками или списками, но не вложенными объектами.
- Для wiki-страниц используй даты
YYYY-MM-DD; дляtype: metaдопустим datetime. - Пустой список пиши как
[], непустой — блоком через-. - Wikilinks в YAML всегда в кавычках:
"[[Страница]]". domain,related,sources,aliasesиsupersedes— списки, даже если в них один элемент.sourcesссылается на файлы изraw/; эти ссылки не нужно дублировать в теле страницы.
Общие поля
type— тип страницы. Должен совпадать с шаблоном и расположением файла.summary— короткая аннотация в одну строку, желательно до 120 символов. Пиши по сути: не "страница описывает X", а "X делает Y".created— дата создания страницы.updated— дата последнего содержательного изменения.tags— тематические теги для фильтрации. Не дублируйtype. Регистр: аббревиатуры заглавными (ML,RL,NLP,RLHF,LLM,LoRA), обычные слова с заглавной первой буквой (Alignment,Optimization). Без lowercase-аббревиатур.status— состояние работы над страницей. Значения зависят от типа.domain— wikilinks на страницы изwiki/domains/, от более узкого домена к более общему. У domain-страницы здесь стоит ссылка на саму себя.related— важные соседние wiki-страницы, которые помогают читать материал в контексте.sources— wikilinks на исходники вraw/, из которых получена информация.provenance— опциональный маркер происхождения страницы. Возможные значения:ingest(создано через обработку источника),study(создано из training knowledge модели в учебной сессии),save(зафайлировано из чата),brainstorm(сборка mind-страницы из реплик пользователя). Заполняется создающим скиллом; для страниц, созданных вручную, поле остаётся пустым.
Схемы
idea
Общие поля: type, summary, created, updated, tags, status, domain, related, sources.
Специфичные поля и правила:
aliases— альтернативные названия, аббревиатуры и распространенные варианты написания.status—evaluationдля новой или непроверенной идеи,in-progressесли суть уже описана, но не хватает связей/примеров/источников,readyесли идея проверена, раскрыта и хорошо связана с wiki.
entity
Общие поля: type, summary, created, updated, tags, domain, related, sources.
Специфичные поля и правила:
entity_type— класс объекта:person,organization,product,repository,place,paper,model,datasetили близкое значение, если точного нет.role— короткое пояснение роли сущности в wiki: например, "автор статьи", "модель для генерации изображений", "репозиторий фреймворка".statusне используется: сущность фиксирует факт, а не стадию проработки.
question
Общие поля: type, summary, created, updated, tags, status, domain, related, sources.
Специфичные поля и правила:
question— исходный пользовательский вопрос или его аккуратная формулировка.answer_quality— качество ответа:draft,solid,definitive.status—evaluationесли ответ требует проверки,in-progressесли ответ полезен, но неполон,readyесли ответ закрывает вопрос и хорошо связан с источниками/wiki. Не заменяетanswer_quality.
domain
Общие поля: type, summary, created, updated, tags, status, domain, related.
Специфичные правила:
domain— self-reference: domain-страница ссылается на саму себя, чтобы граф и knowledge map видели ее как узел домена.related— соседние домены или ключевые страницы, которые не входят прямо в этот домен.sourcesобычно не используется: domain собирает навигацию по уже созданным страницам.status—evaluationдля нового домена,in-progressесли собраны ключевые страницы, но навигация неполная,readyесли домен хорошо структурирован и связан.
mind
Общие поля: type, summary, created, updated, tags, status, domain, related, sources.
Специфичные поля и правила:
author— автор мысли. Обычноuser.seed— исходная фраза, вопрос или тезис, из которого выросла заметка.seed_strategy— способ получения seed, напримерexplicitдля явно сказанной мысли.status—draftдля новой мысли,stableдля устоявшейся версии,deprecatedдля мысли, замененной новой заметкой черезsupersedes.supersedes— ссылки на более старые mind-заметки, которые эта заметка заменяет или уточняет.
meta
Общая схема wiki-страниц не применяется. meta использует только служебные поля:
title— отображаемое название служебной страницы.updated— время обновления служебного артефакта.summary,created,tags,status,domain,relatedиsourcesдля meta не требуются.
Важные правила и ограничения
- Один концепт = одна страница.
- Никаких подпапок по темам внутри
ideas/,entities/— структура страниц плоская. - Каждая синтезированная страница имеет источник.
- Каждый ingest/save оставляет запись в
log.md. - Wikilinks — для ссылок между страницами, markdown — для внешних ссылок.
cache.md— curated rewrite (Writeцеликом, но содержимое накапливается по правилам — см. раздел «Кэш контекста»). Бюджет ≤ 700 слов (целевые ~500); сжимай при разрастании.log.md— append-only. Новые записи сверху.- Rename/move — только через
bin/rename_wiki_page.py. ПрямойmvилиWriteна новый путь ломают wikilinks. - Файлы в
raw/не редактируются агентом. Создание источников допустимо при/transcribeиbrainstorm. - Всегда используй frontmatter при синтезе страниц.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

