ОБЗОР 2026 · МЕТОД ОБУЧЕНИЯ

Интерактивные HTML-страницы от агента: как учить сложное быстрее документации

Метод Andrej Karpathy в пересказе Kai (@hqmank): попросить агента собрать одну интерактивную HTML-страницу вместо текста и разобраться в теме быстрее, чем по документации. Разбираем четыре формата вывода, промпт-шаблон, метрики инструментов и цену метода.

Метод обученияHTML + inline SVGОбзор 2026
Категория Обучение с агентомФормат результата Один HTML-файлИсточник кейса X · @hqmank, 05.10.2026Обновлено 16.10.2026

Есть способ разобраться в новой теме без чтения документации: попросить агента превратить её в одну интерактивную HTML-страницу — со схемами, кликами и самопроверкой — и открыть её в браузере. Приём популяризировал Andrej Karpathy (@karpathy), а 5 октября 2026 года инженер Kai (@hqmank) показал кейс: он изучал SEO и GEO по такой странице и усвоил тему быстрее, чем по документации. Ниже — как метод устроен, что именно писать агенту, какие метрики у инструментов и в чём его цена.

Короткий ответ
Добавьте в конец промпта требование отдать ответ одним HTML-файлом (со схемой сверху и кликабельными блоками) и откройте результат в браузере. Читайте не текст, а страницу: кликайте по блокам, пересказывайте своими словами, проверяйте каждую цифру по ссылке. Нет ссылки — нет знания.
Карточка метода
ИдеяAndrej Karpathy: просить не текст, а формат ответа — диаграмму, HTML-страницу, объясняющее видео
КейсKai (@hqmank), 05.10.2026: SEO и GEO как кликабельная страница; 607 лайков, 49 репостов (снято 16.10.2026)
Формат результатаОдин самодостаточный HTML-файл: текст, inline SVG, интерактив — без сборки и сервера
Где применятьНовая тема, чужой код, любая система, где связи важнее формулировок
Главный рискКрасивая вёрстка создаёт ложное чувство проверенности — источник обязателен у каждого утверждения
Чем собиратьClaude Code, Codex, Cursor, Claude; схемы — навык Diagram Design
Что понадобитсяПромпт-шаблон ниже плюс час времени и привычка проверять факты

01Четыре формата ответа: что советует Karpathy

В посте от начала октября 2026 года (@karpathy) речь о том, что меняется, когда модели выполняют больше работы, а человеку остаётся контроль и понимание. Вместо длинных абзацев он предлагает задавать формат ответа — четыре варианта по возрастанию усилия.

  1. Контролируемый язык ASD-STE100 — словарь и правила из авиационной документации: короткие предложения, одна мысль на фразу, один термин на одно понятие.
  2. Диаграмма — вместо текста просим схему: связи и слои видно до чтения.
  3. HTML-страница — один файл с разметкой, интерактивом и анимацией, который открывается в браузере.
  4. Объясняющее видео — ролик «в стиле 3Blue1Brown» под конкретный вопрос со озвучкой через TTS.

Kai в своём посте выбрал третий формат и описал, зачем: агент превращает ключевые идеи в страницу, по которой можно кликать. Его формулировка полезна как маркер метода — «Please build a single-file, responsive, interactive HTML explainer» — это уже не «объясни простыми словами», а заказ на артефакт.

Цитата из поста Kai (@hqmank, 05.10.2026)
Every tip in @karpathy's post is gold. I use the HTML one a lot. When I'm learning something new or trying to understand complex code, I ask the agent to build me a visual HTML page. Here I was learning SEO and GEO. The agent turned the key ideas into an interactive page I could click through. I picked it up faster than I would have from reading docs.
Формат ответаЧто вы получаетеКогда выбирать
Текст ASD-STE100Однозначные короткие формулировки без украшенийИнструкции и регламенты, где важна точность, а не картинка
ДиаграммаСхему: узлы, связи, слои — структуру видно без чтенияТема — система из нескольких частей
HTML-страницаСамодостаточный файл с текстом, схемой и интерактивомНовая тема или чужой код: нужно вникнуть и запомнить
Объясняющее видеоАнимацию под ваш вопрос с озвучкойНужен сквозной прогон и важна динамика
Четыре формата ответа и когда какой выбирать
Составлено по посту @karpathy и разбору tau-home.com; формулировки — редакции Qantcore.

02Как метод работает на практике

Цикл один: текст, который у вас уже есть (документация, диф, логи, транскрипт), превращается в один файл, который вы открываете и читаете глазами. Четыре шага выглядят так.

СХЕМА · PROCESS · DIAGRAM DESIGN
Путь одного вопроса: от «не понимаю» до «могу объяснить» Четыре шага метода: вопрос формулируется словами, агент собирает интерактивную HTML-страницу, читатель кликает по блокам и проверяет себя. МЕТОД В ЧЕТЫРЁХ ШАГАХ01ВопросСвоими словами:«что такое GEO икак он устроен»02АгентЧитаетдокументацию икод, выбирает03HTML-страницаОдин файл, inlineSVG, клики04ПониманиеПроверяешь себя иобъясняешь вслухИсточник схемы: пост Kai (@hqmank) от 05.10.2026 и промпт-шаблон из разбора tau-home.com, снято 16.10.2026агент — не лектор, а верстальщик
Путь одного вопроса: от «не понимаю» до «могу объяснить»

Ключевое отличие от «объясни простыми словами» — обязательная структура. Модель, которая не понимает тему, выдаёт это в вёрстке: пустые блоки, потерянные связи, обрубленные ветки. Дыра в схеме — самый честный сигнал «здесь я не разобрался», и он появляется до того, как вы успели поверить тексту.

Проверка на понимание
Закройте страницу и перескажите тему вслух. Не получилось — вернитесь к блоку, который «ничего не добавил»: обычно именно там агент достроил картину сам.

03Промпт: что именно написать агенту

Ниже — промпт-шаблон из разбора tau-home.com (по мотивам поста Kai), переведённый на русский. Он требует ровно то, что отличает объяснялку от обычного ответа: самодостаточный файл, схему сверху, кликабельные блоки и ссылки на источники.

prompt.txttext
Собери один самодостаточный интерактивный HTML-файл, чтобы я быстро понял [ТЕМА ИЛИ КОД].

Требования:
1. Всё в одном файле: открывается в браузере без установки зависимостей и без сервера.
2. Сверху — схема или сетка ключевых блоков: слои, компоненты, связи.
3. Каждый блок кликабельный: по клику в панели ниже раскрываются механизм, параметры и пример.
4. Тёмная тема, карточки, аккуратные состояния наведения.
5. У каждого технического утверждения — ссылка на источник. Нет источника — помечай как предположение.

Что объяснять: [ВСТАВЬТЕ ДОКУМЕНТАЦИЮ, АЛГОРИТМ ИЛИ ФРАГМЕНТ КОДА]
Четыре шага заказа объяснялки
1
Подготовьте вход
Документация, диф, логи или транскрипт — то, что уже есть. Чем конкретнее вход, тем меньше выдумки.
2
Задайте формат
Добавьте к промпту требование к формату ответа — это и есть весь приём.
terminalcopy
Format your entire response as a complete HTML document.
3
Проверьте факты
Пройдите по ссылкам: у каждой цифры и лимита должен быть источник. Красивая вёрстка не является доказательством.
4
Откройте и кликайте
Читайте страницу как интерфейс: раскрывайте блоки, отвечайте на вопросы самопроверки, потом перескажите тему.
Агент умеет уверенно рисовать неверное
Разметка не проверяет факты. В обсуждении под постом это назвали риском «выглядит проверенным»: аккуратные карточки и анимация создают доверие, которого содержание не заслужило. Требуйте ссылку на источник у каждой цифры.

04Кейс SEO и GEO: что получилось у Kai

SEO и GEO — многопеременная тема: техническая оптимизация, структура данных, поведенческие сигналы, ответы генеративных систем. Вместо чтения гайда Kai попросил агента собрать ключевые идеи в кликабельную страницу: блоки-карточки, раскрывающиеся панели, связи между понятиями.

Его вывод — «понял быстрее, чем по документации». В комментариях к посту сразу спросили про цену: HTML с разметкой и интерактивом расходует заметно больше выходных токенов, чем markdown. Это честное ограничение метода, и оно описано ниже.

Где метод выигрывает, а где нет
Выигрывает: новая тема, чужой код, система со связями и ветвлениями. Почти не даёт ничего: короткий факт, список из трёх пунктов, вопрос «какая сейчас версия». Для этого хватит абзаца — страница будет дороже и дольше.

05Что внутри объяснялки: три слоя и один файл

Объяснялка — не статья с картинками. Это три слоя в одном файле: короткий текст, схема и интерактив. Слои нарастают по стоимости, поэтому собирать их нужно в этом порядке.

СХЕМА · LAYER STACK · DIAGRAM DESIGN
Три слоя одной объяснялки: текст, схема, интерактив Слои страницы-объяснялки: короткий текст, схема с inline SVG и интерактив с кликами и самопроверкой. НАРАСТАЕТ ИНТЕРАКТИВ ↓L1Тексткороткие абзацы, простые формулировкиL2Схемаinline SVG: связи, слои, поток данныхL3Интерактивклики, переключатели, самопроверкаСлои собраны в один файл: ни одного внешнего скрипта, страница открывается офлайн
Три слоя одной объяснялки: текст, схема, интерактив

Внутри файла нет ничего экзотического — только разметка, стили и векторная графика. Ни сборки, ни сервера, ни внешних данных: файл можно открыть через год с рабочего стола и он не сломается.

СХЕМА · ARCHITECTURE · DIAGRAM DESIGN
Что лежит в одном файле-объяснялке Состав одного HTML-файла: структурированный текст, inline SVG-схемы и интерактивные элементы; файл не требует сборки, сервера и внешних данных. ОДИН HTML-ФАЙЛ · ~100 КБТекст и структураЗаголовки, короткие абзацы, таблицы и карточки — то, что раньше было документациейСхемы inline SVGДиаграммы внутри того же файла: связи, слои, поток данныхИнтерактивКлики по блокам, аккордеоны, чек-листы и вопросы для самопроверки· без сборки· без сервера· работает офлайн· открывается двойным щелчкомПравило метода: файл самодостаточный — данные и разметка внутри, внешних зависимостей нет
Что лежит в одном файле-объяснялке
Правило одного файла
Держите требование «один самодостаточный файл» в каждом промпте. Как только появляются внешние скрипты и шрифты, объяснялка превращается в проект, который нужно поддерживать, — и вы перестаёте её выбрасывать.

06Чем рисовать схемы: инструменты и метрики

Интерактив агент пишет сам, а вот схемы лучше не отдавать на волю случая: без редакционного стиля модели выдают одинаковый «скруглённый блок». Ниже — инструменты, которыми собирают объяснялки, и проверяемые метрики внимания к ним.

Внимание к инструментам схем (звёзды GitHub)Снято 16.10.2026 через GitHub API
0тыс.75тыс.150тыс.Excalidraw134тыс.Mermaid91тыс.draw.io Desktop64тыс.Diagram Design56тыс.tldraw51тыс.
Звёзды показывают внимание, а не качество: часть проектов — редакторы для ручной работы, часть — текстовые форматы, и только Diagram Design и Mermaid рассчитаны на работу агента.
ИнструментЛицензияЗвёзды GitHubРоль
Diagram DesignMIT56 149Навык агента: описываем схему словами — получаем HTML с inline SVG
MermaidMIT90 696Текстовый формат схем: удобно в репозитории и на страницах
ExcalidrawMIT133 962Рисование руками: набросок перед автоматической схемой
draw.io DesktopGPL-3.063 526Ручной редактор схем офлайн, экспорт в SVG
tldrawсвоя лицензия50 951Доска для быстрых набросков и совместной работы
Инструменты и их роль в объяснялке
Звёзды сняты 16.10.2026 через GitHub API (api.github.com/repos/<owner>/<repo>). Лицензия tldraw указана в API как NOASSERTION — уточняйте условия на сайте проекта.

Отдельно стоит темп разработки: навык обновляется быстро, и по нему видно, что проект живой. Ниже — коммиты в репозиторий Diagram Design по неделям.

Коммиты в Diagram Design по неделям52-недельное окно GitHub API, последние 12 недель; снято 16.10.2026
0шт.20шт.40шт.60шт.80шт.26.0709.0823.0806.0920.0904.1000743054241012364878
Нули в начале окна — затишье между релизами, а не пустой репозиторий: всего за 52 недели в проекте 343 коммита, пики приходятся на релизы навыка.
Как это устроено у нас
На Qantcore схемы для новых гайдов и обзоров собираются навыком Diagram Design: он держит один редакционный стиль, сетку 4 пикселя и самопроверку файла. Разбор навыка — в обзоре Diagram Design.

07Как мы применили метод: эта страница

Эту страницу мы собирали тем же способом, только в обратном порядке: сначала проверили факты и метрики, потом собрали текст генератором страниц, а диаграммы — навыком Diagram Design с профилем сайта (тёмная тема, шрифты сайта, ни одного внешнего запроса).

Пример проверки: звёзды репозиториев и недельные коммиты взяты из GitHub API 16.10.2026, метрики поста — со страницы поста, промпт-шаблон — из разбора tau-home.com. Всё, что не подтверждено источником, помечено как редакционное суждение.

  • Диаграммы на этой странице нарисованы навыком Diagram Design — три типа: process, layer stack и architecture.
  • Стиль схем берётся из профиля qantcore: палитра сайта и системные шрифты, без внешних загрузок.
  • Каждый файл схемы проходит самопроверку: контраст, выход элементов за границы SVG, отсутствие внешних ресурсов.
Как собирается страница на Qantcore
1ФактыСобираем проверяемые данные: API, посты, официальные страницы2СпекаТекст, таблицы и графики описываем декларативно3ДиаграммыСхемы собирает Diagram Design в профиле сайта4ПроверкаСамопроверка схем, контраст, мобильная ширина, ссылки5ПубликацияДеплой, .gz, карточка в списке, sitemap и IndexNowТот же порядок работает и для ваших объяснялок: сначала факты, потом верстка
Вердикт Qantcore
8,2/ 10
Метод стоит одного часа: он превращает чтение в разбор и вытаскивает дыры в понимании наружу — раньше, чем вы успели поверить тексту. Минусы честные: HTML дороже markdown по токенам, а аккуратная вёрстка умеет маскировать выдумку. Два правила убирают почти весь риск: один самодостаточный файл и обязательная ссылка на источник у каждого утверждения.

Частые вопросы

Что конкретно просить у агента, чтобы получить объяснялку?
Требование формата плюс структура: «отдай ответ одним самодостаточным HTML-документом со схемой сверху, кликабельными блоками и ссылками на источники у каждого утверждения». Работает в Claude Code, Codex, Cursor и обычном чате с моделью.
Это работает только в Claude Code?
Нет. Метод не зависит от инструмента: важно, что у агента есть доступ к вашим файлам и он умеет писать HTML. В терминальных агентах удобнее складывать результат в папку проекта, в чате — скачать файл и открыть его.
Сколько токенов съедает HTML-страница?
Заметно больше, чем markdown: разметка, стили и inline SVG объёмнее обычного текста. Точных замеров мы не публикуем — их у нас нет. Практический приём: просить сначала каркас и одну схему, а не «всё сразу».
Чем это отличается от «объясни простыми словами»?
Структурой и проверкой. Текст можно прочитать поверхностно, а по странице нужно кликать, отвечать на вопросы и пересказывать. Ошибки модели становятся видимыми: они превращаются в пустые блоки и потерянные связи.
Можно ли верить такой странице?
Только после проверки. Требуйте ссылку на источник у каждой цифры, а спорные утверждения проверяйте сами — особенно в быстро меняющихся темах вроде GEO, где ответы генеративных систем меняются каждые несколько месяцев.

Источники и официальные ссылки

Собрать такую же страницу о своей теме
Возьмите промпт-шаблон из раздела 03, подставьте свой текст и откройте результат в браузере. Если нужны схемы в стиле сайта — начните с навыка Diagram Design.