Термин

Markdown

Разметка обычного текста значками: решётка делает заголовок, звёздочки жирный шрифт, дефис пункт списка. На Markdown написаны CLAUDE.md, скиллы и второй мозг, потому что его одинаково легко читают человек и ИИ-агент.

Что это

Markdown - обычный текст с расширением .md. Оформление в нём задают значками: # Заголовок, **жирный**, - пункт списка, [ссылка](адрес). В блокноте видны сами значки, а Obsidian или предпросмотр в VS Code собирают из них аккуратный документ с заголовками и списками.

Почему его любят агенты

Так устроены CLAUDE.md, скиллы, AGENTS.md и планы задач. Для модели это самый понятный формат: заголовки показывают структуру, лишнего оформления нет. Свой второй мозг я держу в папке с Markdown-файлами, связанными ссылками, и заметил, что агент ориентируется в ней лучше, чем в базе данных.

Как это выглядит на практике

Документ для работы с агентом я сначала перевожу в Markdown. Так дешевле. PDF и презентации съедают в разы больше токенов, чем тот же текст в .md. Идею продукта или план прошу агента сразу записать в .md-файл, чтобы в новой сессии он прочитал его сам и мне не пришлось пересказывать всё заново.

Связанные концепты

Термин

Скилл

Скилл - это сохранённая инструкция для ИИ-агента: один раз описал порядок действий, и агент выполняет её по команде. Живёт отдельным файлом и подгружается, когда задача под него подходит.

Термин

CLAUDE.md

Файл-манифест проекта, который Claude читает первым: карта репозитория, правила, набор инструментов, ссылки на ИИ-клон и Второй мозг. Без него агент работает «в общем по индустрии», с ним - в правилах твоего проекта.

Термин

Второй мозг

Папка business/ в проекте с базой знаний: аудитория, продукты, цели, экономика. Claude читает её перед каждой задачей и заземляет решения на реальный контекст бизнеса.

Термин

Ключ API

Длинная секретная строка, по которой сервис узнаёт твою программу и списывает деньги с твоего счёта. У кого ключ, тот и тратит твой баланс, поэтому ключ не вставляют ни в код, ни в чат с агентом.

Термин

Галлюцинации

Ответ ИИ, который звучит уверенно и выглядит правдой, но выдуман: функция, которой нет в библиотеке, дата, цена, цитата или ссылка. Модель дописывает самое правдоподобное, даже когда данных у неё нет.

Термин

Промпт

Текст, которым ты ставишь задачу ИИ-модели или агенту: вопрос, просьба, инструкция в сообщении. Короткого промпта хватает, когда модель уже знает твой проект, правила и цель.

Гайды, упоминающие этот концепт

Как превратить PDF и Word в текст для ИИ: MarkItDown от Microsoft

Бесплатная утилита Microsoft превращает документы в текст, который понимает нейросеть. Разбираю на своих замерах, где она выручает, а где тихо подсовывает пустой файл.

29 мин

Codex vs Claude Code 2026: как выбрать инструмент

Сравнение двух главных инструментов вайб-кодинга в 2026. Цены, лимиты, режимы reasoning, доступность из России и матрица «кому что подходит».

26 мин

Как загружать PDF в Claude Code без потери токенов: 3 способа в 2026

Каждая страница PDF в Claude Code стоит 1500-3000 токенов ещё до первого вопроса. Внутри: три способа конверсии в Markdown (MarkItDown, PyMuPDF4LLM, MCP-сервер), готовый скрипт для папки документов и точные лимиты Anthropic API в 2026.

17 мин

Как настроить Spec Kit в Claude Code в 2026: спецификации вместо промптов

GitHub Spec Kit - метод Spec-Driven Development, через который Karpathy предлагает заменить вайб-кодинг в 2026. Внутри: 4 фазы, готовые шаблоны под Claude Code, истории AWS Kiro и Rackspace.

23 мин

Как защитить вайб-код в Claude Code в 2026: 754 готовых навыка

Открытая библиотека из 754 структурированных навыков кибербезопасности под Claude Code и 20+ других ИИ-агентов. Mapped на MITRE ATT&CK, NIST CSF, MITRE ATLAS, D3FEND и NIST AI RMF. Бесплатно, под Apache 2.0.

14 мин

Что такое AGENTS.md и как написать свой за 30 минут в 2026

AGENTS.md - открытый формат файла-инструкции для ИИ-агентов, который придумал OpenAI в августе 2025. К декабрю того же года он попал в Linux Foundation вместе с MCP и goose, и сейчас его читают 60 000+ репозиториев и 15+ инструментов: Codex, Cursor, GitHub Copilot, Junie, Gemini CLI, Aider. С сентября 2026 его читает и Claude Code, если в проекте нет CLAUDE.md. Покажу, как держать оба файла в одном репо.

13 мин

Claude Code Skills в 2026: как собрать библиотеку навыков под себя

Claude Code Skills - упакованная методология повторяющегося действия. Структура SKILL.md, формула description, 5 готовых наборов от Anthropic, Matt Pocock и Corey Haines. Пошаговая сборка первого skill за 30 минут.

22 мин

Как чужой репозиторий взламывает Claude Code в 2026: 7 правил защиты

Чужой репозиторий, заголовок Pull Request, фейковый отчёт об ошибке - за две недели нашли 4 способа угнать ИИ-агента без единой строчки вредоносного кода. Разбираю механику и даю готовую защиту.

17 мин

Топ-10 плагинов Claude Code 2026: что ставить из 101

Поставил 25 плагинов из реестра Claude Code, оставил 10. Личный отбор с цифрами установок, цитатами авторов и антипаттернами.

14 мин

Как сделать один файл инструкций для Claude Code, Codex и Cursor в 2026

Claude Code, Codex и Cursor ищут инструкции в разных файлах. С сентября 2026 Claude Code читает AGENTS.md сам, если в проекте нет CLAUDE.md. Разбираю, когда хватает одного AGENTS.md и когда нужен CLAUDE.md с импортом @AGENTS.md.

18 мин