раздел 03

Зачем это вайбкодеру

Вы не пишете код руками, за вас это делает агент. Но эти два формата всё равно попадутся - и тут полезно их узнавать, а не теряться.

Три ситуации, где это пригодится

Читать конфиги и API

Агент показал JSON-конфиг или ответ сервиса - вы понимаете, что там за настройки и данные.

Писать README и инструкции

Описание проекта и правила для агента вы пишете в Markdown. Файл AGENTS.md - это тоже markdown.

Не пугаться JSON

Куча фигурных скобок в коде - это просто данные. Узнали структуру, прочитали, поехали дальше.

Что конкретно делать

Когда агент правит настройки в JSON-файле, вы можете заглянуть и проверить, что значения на месте. Когда вы хотите задать агенту правила работы, вы пишете их в файл инструкций - а это Markdown с заголовками и списками. Чем понятнее структура, тем лучше агент её прочитает.

Файл AGENTS.md (и его родственник CLAUDE.md) - это обычный Markdown: заголовки, списки, блоки кода. Никакой магии, просто текст по правилам разметки из прошлой главы.

Главное

Не нужно становиться экспертом по форматам. Достаточно: увидел JSON - понял, что это данные с парами ключ-значение; увидел .md - понял, что это текст с разметкой; смог сам написать понятный README или правила для агента. Этого хватает, чтобы спокойно вайбкодить.