knowledge-base/notes/karpathy-method.md

date, type, tags

date	type	tags
2026-04-19	note	terminology karpathy agent-loop self-healing

Karpathy method — что это на самом деле

Karpathy = Andrej Karpathy (Андрей Карпати) — живой человек. Не копипаст, не аббревиатура.

Кто он

ML-исследователь: бывший директор AI в Tesla, ex-OpenAI, ex-Stanford. Создал:

• nanoGPT (минималистичная реализация GPT)
• micrograd (autograd в 150 строк)
• llm.c (тренировка LLM на чистом C без зависимостей)
• autoresearch (март 2026) — автономный AI-агент улучшает модель ночью

GitHub: https://github.com/karpathy

karpathy/autoresearch — источник нашей схемы

AI-агент (Claude Code/Codex) сам работает ночью:

1. Читает program.md — инструкция что исследовать
2. Правит train.py (только этот файл, других нельзя)
3. Запускает обучение ровно 5 мин (wall-clock budget)
4. Замеряет val_bpb (bits per byte — объективная метрика)
5. Если лучше → коммит, если хуже → откат
6. Следующая итерация, так 100+ раз за ночь

Ключевые принципы:

• Границы изменений (один файл)
• Объективная метрика (один скаляр, меньше = лучше)
• Фиксированный budget (5 мин)
• НЕ пауза на подтверждение человека — работает автономно

Как мы применили к KB (2026-04-18)

• scripts/kb-health.py — наша метрика: битые ссылки + orphan-файлы + TODO без дат + файлы без frontmatter + duplicates
• scripts/kb-agent-loop.sh — Opus работает в ветке auto-fix/DATE
• Merge в main если score ниже, reset если выше
• Первый прогон: 493 → 45 (−91%), сам написал helper kb-add-indexes.py

НЕ путать

• ❌ «Корпати» ≠ «копировать-вставить»
• ❌ Не метод, а фамилия человека
• ✅ Метод = karpathy-style autoresearch = self-healing через метрику + auto-merge

Ссылки

• Decision-файл с деталями: ../decisions/2026-04-17-nextcloud-sync-schema
• Scripts: /scripts/kb-health.py, /scripts/kb-agent-loop.sh, /scripts/kb-add-indexes.py