Эфир 18.11 · Поток 318 ноября в 19:00 МСК — бесплатный практический эфир по ИИ-агентам · Живой Поток 3 стартует 23.11Эфир 18 ноября →Поток 3 (23.11)
РелизКод / SDK · В работуHabr AI→ оригинал

Что показывать, когда агент пишет код за пять минут

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

AI-обработка оригинала Habr AI; редакция Hamidun News
Что показывать, когда агент пишет код за пять минут
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1Решения и отклоненные варианты — почему именно так, а не иначе. Имена функций без точек в MCP-сервере намеренны, потому что провайдеры моделей точки не пропускают.
Ключевой факт #2Провалы и диагностика — одна строка в robots.txt блокировала весь API, Google видел только экран ошибки вместо реальных страниц.
Ключевой факт #3Что вы сделали бы иначе. Честный разбор вызывает больше доверия, чем история успеха, и полезнее для тех, кто делает похожее.

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

Этот вопрос подхватил принцип из книги Остина Клеона «Покажи свою работу!» — не ждать завершения проекта, а демонстрировать процесс маленькими шагами, обучая других тому, что знаешь. Но в 2026 году это требует переосмысления: нужно показывать не артефакты, а суждения.

Шесть вещей вместо кода

Что раскрывает вашу работу, если код уже написан агентом:

  • Решения и отклоненные варианты. Показывают суждение, которого у агента о вашем проекте нет. Когда каталог MCP-серверов снял два балла за имена функций без точек (вроде stories.search), это было намеренным решением: крупные провайдеры моделей точки в именах не пропускают, а правильные по каталогу имена сломали бы клиентов, ради которых сервер существует.
  • Провалы и способ диагностики. Google начал называть страницы «soft 404», хотя они открывались в браузере. Причина — одна строка в robots.txt блокировала API для получения содержимого. Google рендерит как браузер, не смог получить данные и увидел экран ошибки.
  • Как вы верифицировали работу агента. Самый важный навык сейчас, невидимый в коде. Три примера за неделю: тест сервера проверял неправильный код ошибки и проходил несколько дней, пока реальный клиент через сторонний инструмент не упал с исключением; блок статистики был пустой в продакшене из-за политики безопасности CDN, которую тестовый браузер не применял; Google нашёл несуществующие страницы с окончанием .mdread-only — ссылка на исходный текст стояла вплотную к пометке, браузер видел отступ, в исходном коде его не было, Google склеил их в один адрес.
  • Инструкции агенту после ошибки. Правила в конфигурации, переиспользуемые навыки. После бага с политикой безопасности деплой отказывается выкатывать страницы со встроенными скриптами. После расхождения реестра сервера с его реальной работой деплой падает, если публичная поверхность изменилась без новой версии.
  • Цифры до и после. Результат легко показать, даже когда систему показать нельзя. «Через два дня после исправления Google перестал называть страницы soft 404» или «проверка теперь ловит это до релиза» говорит больше, чем дифф.
  • Что вы сделали бы иначе. Честный разбор вызывает больше доверия, чем история успеха, и полезнее для тех, кто делает похожее.

Как это работает: сценариус вместо одиночки

Когда демонстрируете решения и ошибки вместо кода, отвечают люди с другим опытом. Две переписки в комментариях на dev.to о MCP-сервере превратились в функции продукта: проверку версии и набор тестов через настоящего клиента. Одна из них дошла до Сидни Биссоли, автора семи MCP-серверов для бразильских открытых данных. Он создал из неё отдельный инструмент, прогнал через него все 142 версии своих серверов, нашёл две, которые вообще не запускались, и написал статью с выводом: «одна ветка комментариев изменила то, как выпускаются восемь серверов». Остин Клеон называет это «сцениусом» — хорошая работа рождается в группе, которая показывает друг другу, что делает, а не у одиночки.

Внутри компании: механизм без названий

На worklore.dev публикуют короткие истории: что пробовали, что сломалось, что сработало. Когда чей-то агент воспроизводит историю, это учитывается на странице. Контент, который нельзя обобщить для публики, всё равно стоит записать для себя — ваш собственный агент повторит через пару месяцев, когда детали забудутся.

Даже в закрытых проектах большую часть можно показать, если оставить механизм и убрать названия. «Внутренний сервис», «шаг оплаты», «наш CDN» — урок почти никогда не зависит от бренда. Показывайте рассуждение, а не артефакт: почему выбрали так, как проверили, что изменили бы. Спросите разрешение один раз — большинство руководителей не против обезличенного урока. Маленькое допустимо: одна проблема, одно исправление, 300 слов. Удобная схема: контекст → в чём агент был уверен и ошибся → диагностика → что изменили, чтобы не повторилось.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: шесть вещей вместо кода?

Что раскрывает вашу работу, если код уже написан агентом: Решения и отклоненные варианты. Показывают суждение, которого у агента о вашем проекте нет. Когда каталог MCP-серверов снял два балла за имена функций без точек (вроде stories.search), это было намеренным решением: крупные провайдеры моделей точки в именах не пропускают, а правильные по каталогу имена сломали бы клиентов, ради которых сервер существует. Провалы и способ диагностики. Google начал называть страницы «soft 404», хотя они открывались в браузере.

Что известно по теме: как это работает: сценариус вместо одиночки?

Когда демонстрируете решения и ошибки вместо кода, отвечают люди с другим опытом. Две переписки в комментариях на dev.to о MCP-сервере превратились в функции продукта: проверку версии и набор тестов через настоящего клиента. Одна из них дошла до Сидни Биссоли, автора семи MCP-серверов для бразильских открытых данных.

Что известно по теме: внутри компании: механизм без названий?

На worklore.dev публикуют короткие истории: что пробовали, что сломалось, что сработало. Когда чей-то агент воспроизводит историю, это учитывается на странице. Контент, который нельзя обобщить для публики, всё равно стоит записать для себя — ваш собственный агент повторит через пару месяцев, когда детали забудутся. Даже в закрытых проектах большую часть можно показать, если оставить механизм и убрать названия. «Внутренний сервис», «шаг оплаты», «наш CDN» — урок почти никогда не зависит от бренда.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…