Что нужно понимать про AI-агентов, чтобы собрать первый проект

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

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

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

Чат отвечает текстом. Вы спрашиваете, он формулирует, дальше вы копируете ответ куда-то руками. У агента есть руки. Он читает и пишет файлы на вашем диске, запускает программы, ходит в интернет, открывает результат и смотрит на него.

Из этого растет вторая разница. Агент работает циклом. Разобрал задачу, составил план, сделал шаг, посмотрел на результат, нашел ошибку, поправил. Так он крутится, пока задача не сойдется, и показывает вам уже готовое.

Разговор с чатом исчезает вместе с вкладкой. После работы агента остаются файлы, которые можно открыть завтра.

Отсюда практическое следствие. Агенту нужно место, где он работает. Это папка на вашем компьютере. Все остальное дальше так или иначе крутится вокруг нее.

Агент живет в оболочке, и одна и та же модель доступна сразу в нескольких. Выбор оболочки меняет ощущение от работы сильнее, чем выбор модели.

Слово IDE пугает зря. Это редактор файлов с деревом папок слева, окном текста посередине и диалогом с агентом справа. Вы в нем ничего не пишете, но видите, что именно агент поменял, и можете нажать отмену.

Терминал выглядит суровее и при этом устроен проще. Одно окно, куда вы пишете человеческим языком. Его сила в том, что он ставится куда угодно, включая арендованный сервер, где никакого редактора нет.

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

Любая работа начинается с того, что вы указываете агенту папку. Все, что он видит, правит и создает, лежит внутри нее. Папка и есть проект. Личный сайт, телеграм-бот, разбор документов, база заметок про здоровье. Четыре задачи, четыре отдельные папки.

Внутри папки со временем заводится свой порядок. Ключевой файл там один, текстовая инструкция про проект, которую агент читает первой в каждой сессии.

moya-pervaya-papka/ AGENTS.md // кто я, что за проект, чего делать нельзя README.md // что это и как запускается docs/ plan.md // план, по которому идем resheniya.md // почему сделали именно так src/ // сам проект .env // ключи и пароли, наружу не уезжают

Имя файла-инструкции зависит от инструмента. Где-то это AGENTS.md, где-то CLAUDE.md. Смысл один, короткий текст про проект, который агент читает первым делом.

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

Дисциплина простая. Если решение принято и нигде не записано, через неделю его не существует.

Git это машина времени для папки. Каждое сохранение делает снимок всего проекта, и к любому снимку можно вернуться. GitHub это сайт, где такие снимки хранятся в интернете. Новичку это нужно по четырем причинам.

Откат. Агент увлекся и сломал работавшее. Одна фраза возвращает вчерашнее состояние целиком.
Видимость. В истории видно, что именно изменилось в каждом файле и когда.
Перенос. Проект открывается на другом компьютере в том же виде, в каком вы его оставили.
Мост к серверу. Хостинг подключается к репозиторию один раз, дальше каждое сохранение само уезжает в интернет.

Команды git писать не придется, коммиты делает агент. От вас требуется привычка. Перед крупной правкой попросить сохраниться, после рабочего куска попросить сохраниться снова.

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

В каждом серьезном агенте есть переключатель режима. Это самая недооцененная кнопка новичка.

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

режим планирования, файлы не тронуты > собери лендинг под мой курс. файлы не меняй, сначала план План из пяти шагов 1. Структура: обложка, программа, отзывы, оплата 2. Дизайн-токены в DESIGN.md, дальше собираем по ним 3. Разметка и стили одним файлом 4. Локальный просмотр, правки по вашим замечаниям 5. Публикация на хостинг из репозитория Ничего не менял. Начинать с первого шага? > начни со второго и покажи три варианта палитры

Правка плана стоит одной фразы. Правка готового результата стоит вечера.

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

Внутри одного агента обычно доступно несколько моделей. Умные думают лучше и стоят дороже, быстрые дешевле и торопливее. Правило простое. Планируем самой умной моделью, выполняем более дешевой.

Чтобы переключение работало, план должен лежать в файле. Тогда смена модели ничего не ломает, новая сессия читает docs/plan.md и продолжает с того места, где остановились. План в переписке пропадает при каждом переключении.

Контекст это оперативная память одной сессии. Туда попадает все. Ваши сообщения, файлы, которые агент открыл, вывод команд, найденные страницы. Окно конечно, и по мере заполнения поведение меняется. Агент забывает начало разговора, заново предлагает то, что вы уже отвергли, теряет договоренности, правит файл, который просили не трогать.

Часть инструментов показывает заполнение прямо в строке состояния и при подходе к пределу сама сжимает историю или переносит работу в новую сессию. Там, где такого нет, следить приходится человеку.

строка состояния сессии модель: сильная контекст: 78% правок в сессии: 41 > запиши итоги и открытые вопросы в docs/resheniya.md Записал: три принятых решения, два открытых вопроса, следующий шаг. Можно начинать новую сессию. контекст: 12% история сжата

Ритуал занимает полминуты и экономит час. Прежде чем закрывать переполненную сессию, вытащите из нее все, что должно пережить закрытие.

Сессия это черновик. Файл в папке это память.

Как только крупный этап закончен, просите агента записать итоги и открывайте новую сессию. Заодно перестает работать неприятный эффект, когда длинный разговор тащит за собой все тупиковые ветки и агент продолжает на них оглядываться.

По умолчанию агент видит только вашу папку. Коннектор дает ему доступ наружу, к конкретному сервису. MCP это общий стандарт такой розетки, один раз описанный интерфейс, который понимают все крупные агенты.

Список того, что подключается, длинный и растет. Заметки и базы знаний, облачные диски, календарь и почта, таблицы, дизайн-макеты, базы данных, аналитика сайта, платежные сервисы, браузер, который агент открывает сам.

коннекторы проекта заметки подключено // читает и создает страницы облачный диск подключено // забирает файлы сам, просить не нужно база данных подключено // смотрит таблицы проекта аналитика подключено // достает цифры за период браузер подключено // открывает страницу и снимает экран

Ставится галочкой в настройках инструмента плюс вход в сервис. Кода при подключении вы не увидите.

Меняется при этом одна вещь, зато сильно. Агент перестает просить у вас данные и берет их сам. Фраза собери сводку по трафику за неделю и положи страницей в мои заметки становится исполнимой целиком, без выгрузок и копирования руками.

Коннектор это выданный доступ к вашим данным. Ставьте только то, чей источник понятен, читайте, какие права запрашиваются, и не подключайте на всякий случай.

Когда работа крупная, главный агент режет ее на части и запускает помощников. У каждого помощника свое контекстное окно и своя узкая задача, работают они одновременно, а обратно приходит короткая выжимка.

Как главный агент раздает работу помощникам

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

Типичные задачи под такую схему. Проверить сотню страниц по одному правилу, посмотреть на решение с четырех разных сторон, собрать исследование по десятку источников.

В первую неделю это не нужно. Сначала одна сессия, один проект, один агент. Субагенты становятся осмысленными, когда вы уже чувствуете, где именно работа распадается на независимые куски.

Одно окно закрывает несколько ролей сразу, и переключаются они вашей формулировкой.

Программист. Пишет и чинит код, объясняет, что сделал, простыми словами.
Дизайнер. Собирает интерфейс по референсу и по токенам.
Тестировщик. Проходит сценарии за пользователя, ломает формы, ищет ошибки и приносит список.
Ревьюер. Смотрит на работу свежим взглядом в отдельной сессии и говорит, где слабо.
Редактор. Пишет тексты вашим голосом, если голос описан правилами.

Прием, который работает во всех ролях, это оценка по критериям. Оцени результат от 1 до 100 по читаемости, скорости и понятности новичку, потом улучшай, пока не будет сотни. Агент находит собственные слабые места охотнее, чем кажется, и делает это до того, как их увидите вы.

Второй прием, разделять поиск проблем и починку. Сначала попросите только список того, что плохо, без единой правки. Потом выберите из списка то, что действительно чинить.

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

Отсюда рабочий цикл. Правка, просмотр, скриншот агенту, замечание словами. Показать агенту криво собранный экран быстрее, чем описать кривизну текстом.

Пока проект лежит в папке, он ваш личный. Чтобы им пользовались другие, проект надо разместить на сервере. Это и называется деплоем.

Цепочка от папки на компьютере до ссылки в интернете

Цепочку настраивают один раз. Дальше каждое сохранение уезжает в интернет само, вручную ничего копировать не нужно. Случаев на старте три.

Сайт или лендинг. Подходит бесплатный хостинг статики. Подключается к репозиторию за пять минут, обновляется при каждом сохранении.
Телеграм-бот или сервис, который работает круглосуточно. Нужен арендованный сервер. Площадки вроде Railway берут несколько долларов в месяц, репозиторий подключается кнопкой, база данных добавляется тоже кнопкой.
Личный инструмент. Остается на вашей машине, деплой ему не нужен вообще.

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

Все шаги здесь делает агент. Он заводит проект на площадке, подключает репозиторий, настраивает переменные, поднимает базу и чинит первый неудачный запуск. От вас нужны решение и оплата.

Из работы уходит набор рук и остается голова. Задачи на вашей стороне четыре.

Понимать, что и зачем. Какой результат вам нужен и по каким признакам вы поймете, что он достигнут. Устройство кода при этом знать не обязательно.
Ставить задачу словами. Обычным языком, с примерами, с явными запретами.
Принимать решения на развилках. Агент честно спрашивает, когда вариантов несколько, и молча выбирает средний, когда его не спросили.
Проверять. Открыть, нажать, прочитать. Агент склонен рапортовать об успехе раньше, чем он случился.

Слова готово недостаточно. Просите показать результат и смотрите на него сами. Это единственная привычка, которая отделяет собранный проект от красивого отчета о нем.

На кэмпе Точки над ИИ мы ставим эти инструменты вместе с участниками и доводим первый проект до работающего результата на их же задачах.

Порядок, который стабильно доводит до результата.

Выберите одну настоящую задачу. Ту, что болит: сайт, разбор документов, бот для клиентов, порядок в заметках. Учебные упражнения бросают на третий день.
Поставьте один инструмент. Одну среду разработки с агентом внутри. Сравнение пяти инструментов съедает неделю и не дает ничего.
Заведите папку и файл-инструкцию. Попросите агента написать этот файл самому: кто вы, что за проект, чего делать нельзя. Потом поправьте руками.
Первую сессию проведите в режиме плана. Прочитайте план целиком до того, как что-то запустится.
Подключите гит на второй день. Просите сохранять после каждого рабочего куска. Это страховка, которая понадобится раньше, чем вы думаете.
Доведите до показуемого. Первый проект должен открываться и работать. Коннекторы, субагентов и сервер добавляйте после этого.

Первая задача займет вечер и покажется медленной. Третья займет двадцать минут. Дальше меняется сам способ думать про работу, вы начинаете формулировать задачи так, будто их уже кто-то выполняет.

Собирать инструменты вместо работы. Пять установленных агентов и ни одного собранного проекта.
Просить все сразу одной фразой. Крупная задача без плана превращается в кучу изменений, которую невозможно проверить.
Работать без сохранений. Первая сломанная папка стоит вечера и желания продолжать.
Держать договоренности в переписке. Сессия закрылась, и решения вместе с ней.
Включать автоматический режим на живом проекте. Особенно на том, которым уже пользуются люди.
Верить отчету. Готово в чате и работает на экране совпадают не всегда.
Ставить коннекторы пачкой. Каждый из них это выданный доступ к вашим данным.
Складывать три проекта в одну папку. Контекст мешается, агент правит соседний проект.

Агент отличается от чата руками: файлы, команды, интернет, проверка своей работы. После него остаются файлы.
Живут агенты в четырех местах: среда разработки, терминал, расширение к редактору, облако. Для старта берите среду разработки, там видно происходящее.
Проект это папка, и она же точка синхронизации. Внутри лежит файл-инструкция, который агент читает первым в каждой сессии.
GitHub дает откат, историю изменений, перенос на другой компьютер и мост к серверу. Коммиты делает агент.
Режимов четыре: чтение, планирование, исполнение, авто. Любая заметная работа начинается с плана.
Планируем самой умной моделью, выполняем дешевой. Чтобы переключение работало, план лежит в файле.
Контекстное окно конечно. Заполнилось, записали итоги в файл и открыли новую сессию.
MCP-коннекторы это мостики к внешним сервисам. Каждый из них выданный доступ, поэтому ставим по одному и осознанно.
Субагенты ускоряют крупную работу и берегут контекст главного агента. В первую неделю не нужны.
Деплой превращает папку в ссылку. Статике хватает бесплатного хостинга, боту нужен арендованный сервер и база данных.
Программировать не нужно. Технические слова придется выучить на уровне значения: репозиторий, контекст, деплой, коннектор.
Порог входа по деньгам небольшой. Подписка на одного агента около 20 долларов в месяц, аренда сервера под бота примерно от 5 долларов.
Личные документы держите за пределами рабочей папки, ключи в отдельном файле, автоматический режим включайте на копии проекта.