Как из папки с Markdown-файлами получился AI-наставник для учёбы

Давно замечаю за собой привычку листать GitHub в поисках неожиданного. Иногда попадаешь на библиотеку, иногда на консольную утилиту, а иногда на репозиторий, где вообще нет файлов с кодом. DIO Agent как раз из последней категории.

Внутри только файлы Markdown. Ни Python, ни JavaScript, ни системы сборки. GitHub даже язык проекта не определил, в метаданных стоит null. И всё равно 1755 звёзд и 260 форков. Как так?

Что это за штука

DIO это бразильская образовательная платформа для разработчиков: буткемпы и челленджи по коду или проектам. Репозиторий dio-agent не содержит приложения в привычном смысле. Он содержит описание AI-агента, который подтягивается к вашей учёбе и ведёт вас как наставник.

Ключевое слово здесь — агент. Обычный чат-бот отвечает на вопрос и замолкает. Агент читает контекст, планирует шаги и доводит вас до результата. Разница примерно как между справочной стойкой и человеком, который идёт рядом. DIO Agent это второй вариант. Он знает, что такое Буткемп, Формация, Aceleração, Desafio de Código, и подсказывает то, что реально есть на платформе, а не абстрактные советы из интернета.

Три навыка, которые он умеет

Всё поведение агента расписано в так называемых skill'ах. Это пошаговые инструкции в отдельных папках, каждая под свою задачу.

План учёбы. Вы даёте цель, свой текущий уровень и сколько времени готовы тратить. На выходе получаете порядок тем и подборку материалов. Например, хотите стать бэкенд-разработчиком и можете уделять час по будням, он соберёт план под этот ритм, а не под абстрактного «идеального студента».

Разблокировка челленджа. Застряли на задаче, агент ведёт вас к решению, но не выдаёт готовый ответ. Это осознанное решение авторов: цель не сдать задание, а понять, где именно вы сломались.

Объяснение концепции. Просят разобрать API, цикл или наследование, он объясняет простыми словами и через аналогии. Уровень подстраивается: «никогда не видел», «что-то слышал», «хочу глубже».

Ничего вызывать вручную не нужно. Вы просто пишете, как думаете, а агент сам определяет, какой из трёх сценариев подходит.

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

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

Хочу собрать план учёбы.
Цель: [например, стать бэкенд-разработчиком]
Курс или буткемп DIO: [название или ссылка]
Мой уровень: [новичок, средний, продвинутый]
Сколько времени есть: [например, час в день по будням]

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

Почему это работает где угодно

Здесь спрятан самый интересный технический момент. Сердце проекта это файл AGENTS.md. Это открытый стандарт, который читают современные AI-инструменты, или «харнессы», если пользоваться терминами авторов. Метафора из README хорошая: агент это преподаватель, а харнесс это аудитория. Один профессор может читать лекцию в разных залах.

На практике харнесс это программа, через которую вы говорите с моделью. Поддерживаются Google Antigravity (его советуют новичкам из-за более щедрых лимитов), Claude Code, Codex, OpenCode и Hermes. Ставите любой из них, скачиваете репозиторий через git clone или обычным zip-архивом, открываете папку в харнессе и готово. Он сам находит AGENTS.md.

Структура при этом прозрачная и небольшая:

dio-agent/
├── AGENTS.md        определение агента
├── CLAUDE.md        ссылка на AGENTS.md для Claude Code
├── agent/
│   ├── persona.md   характер и тон
│   └── knowledge/   знания о платформе DIO
├── skills/          три навыка
└── docs/glossary.md глоссарий

Файл CLAUDE.md намеренно тонкий. Он просто указывает на AGENTS.md, чтобы Claude Code подхватывал то же описание. Из-за этого проект не привязан к одному вендору.

Кому это нужно и есть ли подвох

Сразу оговорюсь: репозиторий на португальском. Персона агента, инструкции, глоссарий, всё написано на языке Бразилии, и заточен он под платформу DIO. Если вы там не учитесь и языка не знаете, напрямую пользы мало.

Но ценность здесь не только в самом агенте. Это хороший пример того, как собрать ассистента без кода: текстовые файлы, чёткая персона, вынесенные в отдельные навыки сценарии и один стандартный файл-точка входа. Такой же каркас можно повторить для своей команды, своей базы знаний или внутренних регламентов. Форкните, перепишите persona.md под свою предметную область, добавьте свои skill'ы.

Документация при этом скромная. README объясняет шаги установки, но на вопросы вроде версионирования навыков или проверки поведения агента ответов нет. Лицензия в метаданных тоже не проставлена. Воспринимайте проект как рабочий пример, а не как коробочную платформу.

DIO Agent попробовал бы, если вы учитесь на DIO и говорите по-португальски. Настройка занимает минут десять, а результат заметен сразу: наставник всегда под рукой и не устаёт объяснять одно и то же по десять раз.

Если же вы просто присматриваетесь к агентам на LLM, загляните ради архитектуры. Любопытно увидеть своими глазами, что осмысленный AI-ассистент умещается в несколько текстовых файлов, и никакой инфраструктуры для этого не требуется.