agentleFS
matvej-melikhovmatvej-melikhov/karpathy-llm-wiki/.claude/CLAUDE.md

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 или раз в сутки.

The file

Files
CLAUDE.md

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-сессийbrainstormcreate
raw/meta/*Эмбеддинги источников, dedup-манифестbin/embed.py, ingestgenerated
_attachments/Вложения для wiki-страницingestcreate
_templates/Шаблоны Obsidian Templaterпользовательread-only
wiki/ideas/Концепции, механизмы, теорииingestcreate + edit
wiki/entities/Люди, статьи, библиотеки, моделиingestcreate + edit
wiki/domains/Навигационные хабы по областям (MOC)ingest (порог N=10)create + edit
wiki/questions/Сохранённые ответы из /save, /querysave, querycreate + edit
wiki/minds/Мысли пользователя (через /brainstorm)brainstormcreate + edit
wiki/index.mdКаталог всех страницbin/gen_index.pygenerated
wiki/log.mdЖурнал операцийвсе скиллыappend (сверху)
wiki/cache.mdГорячий кэш ~500 слов (актуальный контекст)ingest, save, query, brainstormoverwrite
wiki/summary.mdОбзор vault (счётчики, статус)ingestoverwrite
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.jsonlAppend-only журнал метрик для time-series и pulsebin/update_dashboard.pyappend
wiki/meta/snapshots/heavy.jsonСвежий sankey/treemap/инсайты для дашбордаbin/knowledge_map.py + ручная правка /snapshotoverwrite
wiki/meta/vendor/Vendored Chart.js + плагины (зеркало bin/vendor/)bin/update_dashboard.py::ensure_vendor()generated
wiki/meta/* (прочее)Эмбеддинги, lint-state, дашборды Basesbin/*, lint, gen_dashboards.pygenerated

Режимы:

  • 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 буллетов. Правила вытеснения:
    1. Новая страница, важная поперёк vault (cross-link к нескольким доменам, ключевой концепт для текущей задачи) → добавь и вытесни наименее актуальный.
    2. Кандидат на вытеснение — буллет, который (а) не звучал в работе последние 2-3 недели и (б) семантически покрыт другим буллетом из списка или index.md.
    3. Не превращай в исторический архив. Если буллет старше месяца и не используется — вытесняй.
  • ## Недавние изменения — FIFO 3-5 строк. Новая строка сверху, нижняя вытесняется.

Бюджет: wc -w wiki/cache.md ≤ 700 слов (целевые ~500). Если разрастается — сжимай буллеты в Ключевых фактах или вытесняй.

Frontmatter

_templates/ — источник правды для схем. При создании страницы бери шаблон и заполняй его поля, не добавляя новых без причины.

Общие правила

  1. Каждая wiki-страница начинается с YAML frontmatter.
  2. Frontmatter плоский: поля могут быть строками или списками, но не вложенными объектами.
  3. Для wiki-страниц используй даты YYYY-MM-DD; для type: meta допустим datetime.
  4. Пустой список пиши как [], непустой — блоком через -.
  5. Wikilinks в YAML всегда в кавычках: "[[Страница]]".
  6. domain, related, sources, aliases и supersedes — списки, даже если в них один элемент.
  7. 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 не требуются.

Важные правила и ограничения

  1. Один концепт = одна страница.
  2. Никаких подпапок по темам внутри ideas/, entities/ — структура страниц плоская.
  3. Каждая синтезированная страница имеет источник.
  4. Каждый ingest/save оставляет запись в log.md.
  5. Wikilinks — для ссылок между страницами, markdown — для внешних ссылок.
  6. cache.md — curated rewrite (Write целиком, но содержимое накапливается по правилам — см. раздел «Кэш контекста»). Бюджет ≤ 700 слов (целевые ~500); сжимай при разрастании.
  7. log.md — append-only. Новые записи сверху.
  8. Rename/move — только через bin/rename_wiki_page.py. Прямой mv или Write на новый путь ломают wikilinks.
  9. Файлы в raw/ не редактируются агентом. Создание источников допустимо при /transcribe и brainstorm.
  10. Всегда используй frontmatter при синтезе страниц.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.