Не используйте Claude Code без этого

AAI LABS
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00Правда в том, что ИИ никогда не произведет революцию в процессе создания ПО, по крайней мере, не так, как вы думаете.
00:00:05Он определенно ускоряет работу и упрощает восстановление, если что-то идет не так.
00:00:10Но процессы, выстроенные за 60 лет создания продуктов, по-прежнему важны, просто по другим причинам.
00:00:16Раньше они внедрялись, чтобы у людей был структурированный способ разработки этих продуктов.
00:00:21Но теперь акцент сместился на то, чтобы позволить ИИ-агентам работать так же, как люди.
00:00:25Поэтому, чтобы ИИ-агенты работали правильно, нужно настроить их среду так, чтобы они действительно следовали процессу.
00:00:32И мы пройдем через все шаги, которые необходимо предпринять еще до начала разработки.
00:00:36Правильное планирование требований — это самое важное, что нужно сделать перед написанием первого промпта.
00:00:41Это тот этап, на который придется тратить время, независимо от того, насколько хороши станут модели.
00:00:45Существует несколько способов планирования.
00:00:46Вы можете планировать приложение с помощью Claude Code в режиме планирования, но оно сильно ориентировано на технику, а не на продукт.
00:00:52Как мы упоминали в прошлом видео, с развитием агентов,
00:00:56режим планирования не должен быть таким детальным или техническим, а должен фокусироваться на продуктовом аспекте,
00:01:01потому что новые модели мощны, и планирование должно отличаться от того, каким оно было с менее способными ранними моделями.
00:01:07Вместо режима планирования Claude вы можете создать отдельного агента, который поможет спланировать ваше приложение.
00:01:11Он содержит инструкции для создания правильного PRD с шаблоном, чтобы направить Claude в понимании требований.
00:01:18После настройки агента вы можете дать Claude промпт использовать его для планирования нужного вам приложения.
00:01:23Он загружает агента-планировщика и задает вопросы, пока не поймет все требования.
00:01:28Он будет продолжать задавать вопросы, пока вы не будете удовлетворены планом.
00:01:32Чтобы понять суть MVP, агент настроен задавать много вопросов.
00:01:36В конце он спросит, нужно ли вам в приложении что-то еще.
00:01:40Если да, вы можете добавить функции, которые агент должен реализовать.
00:01:43Если вы ответили на все вопросы и считаете, что агент понял план, просто скажите: «На этом все».
00:01:49После сессии вопросов и ответов он создает PRD-документ и сохраняет его в папку проекта.
00:01:54Этот документ содержит подробную информацию обо всех обсужденных требованиях.
00:01:57Реализация разделена на этапы и содержит ключевые проектные решения и всё необходимое для приложения.
00:02:04Теперь, когда вы уточнили, какое приложение строите, следующий шаг — правильно определить файл Claude.md.
00:02:10Этот файл важен, так как содержит все инструкции, которым должен следовать ваш агент.
00:02:15Вы привязываете PRD-документ, чтобы агент мог брать требования прямо оттуда, и вам не приходилось их повторять.
00:02:21Этот файл должен содержать только то, чего агент не знает, не упоминая то, что ему и так известно.
00:02:27Он ссылается на правила, которым должен следовать проект.
00:02:30Вы можете добавить конвенции проекта и специфические инструкции для Claude при реализации приложения.
00:02:37Идеальный подход — не создавать Claude.md через команду init, а сделать его самостоятельно,
00:02:43так как эта команда генерирует файл на основе существующего кода, а не того, что агенту действительно нужно знать.
00:02:49Но этот файл не пишется один раз и навсегда.
00:02:53Вам нужно постоянно дополнять его, чтобы постепенно улучшать процесс создания приложений во время работы.
00:02:58Как мы говорили ранее, этот файл загружается один раз и остается в контексте, служа руководством во время работы.
00:03:05Поэтому убедитесь, что в нем нет лишних вещей или того, что относится только к одной узкой области.
00:03:12В этот файл стоит добавить лучшие практики, соглашения о кодировании и стиле текста,
00:03:19но не то, что агент может понять сам, например, структуру проекта.
00:03:24Для этого он может просто прочитать структуру файлов и разобраться самостоятельно.
00:03:28Так что уделите время написанию этого файла и адаптируйте его под свои нужды перед началом реализации.
00:03:36Следующим шагом вы настраиваете навыки, агентов и любые MCP, которые хотите использовать, — всё это до начала сборки.
00:03:42MCP подключаются довольно легко.
00:03:44Вы можете просто подключить любой внешний сервис и установить его, выполнив соответствующие команды.
00:03:50Например, мы хотели бэкенд на Supabase, поэтому подключили Supabase MCP к нашему агенту в проекте.
00:03:57Если вы используете Shadcn UI для компонентов и Playwright для тестирования в браузере,
00:04:01их нужно подключить до начала сборки, чтобы агенты имели доступ к этим инструментам.
00:04:07Но это было про внешние сервисы, а вам также нужно настроить самих агентов.
00:04:12Вы можете настроить столько агентов, сколько потребуется.
00:04:14У вас уже есть выделенный агент для планирования.
00:04:16Также можно создать агента по коммитам, который будет отвечать за фиксацию кода и проверку сообщений.
00:04:23Можно завести агента по рефакторингу, который улучшает код и общую производительность.
00:04:28И агента по верификации, использующего Playwright MCP для проверки UI и пользовательских сценариев.
00:04:39Помимо агентов, нужно настроить навыки (skills).
00:04:42Вы можете создавать любые навыки с помощью Skill Creator, доступного в открытом репозитории на GitHub.
00:04:49Можно добавлять ссылки и скрипты, чтобы агент мог запускать их и использовать результат.
00:04:55Различие: используйте навыки для повторяющихся рабочих процессов, требующих четких руководств и справочников.
00:05:04Например, можно создать фронтенд-навык, так как это повторяющийся процесс с едиными правилами оформления.
00:05:11Агентов же внедряйте для задач, которым нужно отдельное окно контекста.
00:05:14Вы также можете использовать открытый фронтенд-навык, который активно применяет сам создатель Claude Code.
00:05:20Также нужно добавить правила для конкретных путей к файлам вашего приложения.
00:05:23Эти правила определяют путь, к которому они применяются, и содержат инструкции для этой части кода.
00:05:29Вы можете настроить их сколько угодно и сослаться на них в Claude.md, чтобы агент знал о них.
00:05:36Claude.md нужен для общих принципов, а специфические правила помогают агенту понять детали реализации на местах.
00:05:46Мы разбираем все эти настройки и создание продуктов с ИИ на этом канале, так что подписывайтесь.
00:05:54Но даже со всеми этими положительными инструкциями остается пробел.
00:05:58Агенты склонны к действию и могут реализовать лишнее, выходящее за рамки ваших условий.
00:06:03Поэтому нужно явно сказать агенту, чего делать НЕ следует.
00:06:06Создайте такой файл в папке docs и укажите ссылку на него в Claude.md, чтобы агент видел ограничения.
00:06:12Он должен содержать инструкции о том, чего именно вы не хотите видеть в проекте.
00:06:19Отрицательные ограничения важны, так как они убирают двусмысленность и не дают агенту экспериментировать там, где не нужно.
00:06:29Они дают четкое понимание того, как результат выглядеть не должен.
00:06:32Например, если вы не хотите стандартную сине-белую гамму, прямо укажите это, а не просто намекайте.
00:06:41Но прежде чем продолжить, пара слов о нашем спонсоре — Way in Video.
00:06:44Если вы работаете с длинными видео, вы знаете, как это сложно: часами искать нужный момент и монтировать.
00:06:52Way in Video решает это. Это ИИ-платформа, которая действительно понимает ваше видео.
00:06:56Их навык клиппинга в OpenClaw берет любое длинное видео, находит виральные моменты и делает из них вертикальные ролики.
00:07:04Без кода и сложных настроек. Просто запустите навык, и ваши клипы готовы к публикации.
00:07:08Если нужно что-то конкретное, ищите внутри видео на обычном языке: введите «смешная реакция», и сервис найдет её.
00:07:16Он также делает саммари и транскрипцию с разделением по ролям. Идеально для подкастов и стримов.
00:07:22Будь то переработка контента или автоматизация работы, Way in Video экономит вам часы каждую неделю.
00:07:27Хватит тратить время на ручной монтаж. Переходите по ссылке в закрепленном комментарии.
00:07:32Большинство ИИ-фреймворков в той или иной форме используют несколько документов для разных целей.
00:07:38Но основой всего этого являются документы прогресса и обучения.
00:07:42Файл прогресса критически важен в больших проектах, иначе агент забывает, что уже сделано, а что — нет.
00:07:52Без этого файла агенту приходится перечитывать код и сравнивать его с документацией,
00:07:58что создает лишнюю нагрузку и тратит ваше время и токены.
00:08:01Поэтому создайте файл прогресса, чтобы агент мог в одном месте увидеть текущий статус задач.
00:08:07Но одного отслеживания прогресса мало: агенту нужно знать, что пошло не так.
00:08:11Для этого нужен файл обучения (learnings), где агент записывает ошибки и способы их решения.
00:08:17Так, столкнувшись с похожей ситуацией позже, он не совершит ту же ошибку дважды.
00:08:22Поскольку оба этих файла должны обновляться в процессе разработки,
00:08:26вам нужно явно прописать в Claude.md, чтобы агент постоянно дополнял их в ходе сборки.
00:08:34Эти два файла — самые необходимые элементы в любой настройке.
00:08:38Вы можете использовать их при создании собственной среды для кодинга.
00:08:41У нас уже было видео о том, как самостоятельно собирать такие фреймворки, оно есть на канале.
00:08:46Но если вы не хотите возиться с настройкой с нуля,
00:08:49вы можете просто положиться на готовые фреймворки, которые уже используют эти механизмы.
00:08:56Еще одна частая ошибка — внедрение тестов только в самом конце разработки.
00:09:00Это проблема, потому что если просить агента писать тесты после написания функций,
00:09:05они будут не так эффективны, как если бы они были написаны заранее.
00:09:09При написании тестов агент должен опираться на созданный вами PRD и на его основе определять логику работы.
00:09:16Агент должен писать тесты исходя из требований,
00:09:19фактически воссоздавая нужный функционал и находя узкие места прямо из спецификаций.
00:09:24Когда тесты готовы, их можно запустить в конце, чтобы проверить соответствие реализации требованиям.
00:09:29Суть написания тестов вначале в том, что после реализации агент знает только то, что уже сделано.
00:09:35Он оптимизирует тесты под существующий код, а не под исходные требования спецификации.
00:09:41Из-за этого вы можете пропустить баги в функциях, которые были в плане, но реализованы неверно.
00:09:46Так как агент подстраивается под готовый код, он может халатно отнестись к тестированию,
00:09:50упуская крайние случаи, которые можно было поймать, если бы тесты шли напрямую от ТЗ.
00:09:55Не давайте агенту размытых команд вроде «протестируй приложение», иначе Claude просто подстроится под код.
00:10:02Вместо этого внедряйте тесты по спецификациям, чтобы агент знал, на что именно ориентироваться.
00:10:07Также, если вам нравится наш контент, жмите кнопку «хайп», это помогает нам расти и охватывать больше людей.
00:10:14Другая проблема многих разработчиков — отсутствие отслеживания проблем на ранних этапах.
00:10:19Без этого баги копятся, причины их появления забываются, и с ростом приложения отследить их всё труднее.
00:10:26Поэтому ведение логов во время тестирования крайне важно.
00:10:29Многие используют для этого GitHub, и это отличная платформа для управления задачами.
00:10:34В сочетании со структурированными Git-коммитами это дает Claude понимание того, что было сделано на каждом этапе.
00:10:42Огромный плюс Git в том, что если изменение ломает код, вы всегда можете откатить коммит.
00:10:47А если нужно протестировать что-то экспериментальное, используйте worktree для изоляции.
00:10:51Вы можете настроить среду так, чтобы агент делал коммит после каждого шага с подробным описанием.
00:10:58Но GitHub удобен для технарей, а нетехническим членам команды может быть сложно создавать там тикеты.
00:11:03Для них лучше подключить агента к инструментам управления проектами, таким как Trello или Notion.
00:11:08Это позволит фиксировать баги, следить за прогрессом и совместно работать над исправлениями.
00:11:12Подключите MCP нужного инструмента, чтобы агент мог управлять задачами и отчетами напрямую.
00:11:20Также добавьте инструкцию в Claude.md, чтобы агент использовал Notion MCP для корректного трекинга ошибок.
00:11:28Настройка этого в самом начале неоценима при масштабировании проекта и командной разработке.
00:11:36Но даже если ваше приложение идеально в тестах, код от ИИ не всегда готов к нагрузке от множества пользователей.
00:11:43Вот почему многие находят решения от ИИ недостаточно производительными в «проде».
00:11:47Следовательно, к этому тоже нужно подготовиться заранее.
00:11:49Вы можете сообщить агенту ожидаемое число пользователей и то, что они будут работать одновременно.
00:11:56На основе этих данных агент должен написать тест-кейсы для стресс-тестирования нагрузки.
00:12:01Существует множество инструментов тестирования, выбирайте тот, который подходит под ваши задачи.
00:12:05Мы использовали K6 для приложения на Next.js, так как его легко внедрить.
00:12:10Здесь также можно использовать режим планирования Claude для проработки детального технического плана.
00:12:17Claude строит план на основе PRD и примерного количества одновременных пользователей.
00:12:23Claude задает вопросы с разных ракурсов и проясняет потенциальные проблемы, которые могут возникнуть в продакшене.
00:12:29Это помогает приложению корректно обрабатывать сбои и оптимизирует пользовательский опыт.
00:12:34Используя этот режим, вы уточняете свои цели и получаете от агента план по масштабируемости.
00:12:39Этот план — финальный штрих в превращении вашей идеи в готовый к работе продукт.
00:12:43Все упомянутые агенты и навыки доступны в AI Labs Pro для этого и предыдущих видео.
00:12:53Если вы цените нашу работу и хотите поддержать канал, это лучший способ сделать это.
00:12:57Ссылка находится в описании.
00:12:59На этом наше видео подходит к концу.
00:13:00Если хотите поддержать канал, вы можете воспользоваться кнопкой «суперспасибо» ниже.
00:13:07Как всегда, спасибо за просмотр, и увидимся в следующем выпуске.

Key Takeaway

Успешная разработка ПО с Claude Code требует жесткой предварительной настройки среды через PRD, специализированные файлы контекста (Claude.md) и превентивное написание тестов по спецификациям для предотвращения галлюцинаций и избыточных действий ИИ.

Highlights

Эффективная работа ИИ-агентов требует настройки среды, которая принудительно заставляет их следовать процессам разработки, выстроенным за последние 60 лет.

Создание документа PRD (Product Requirements Document) через специализированного агента-планировщика предотвращает избыточную техническую детализацию на ранних этапах.

Файл Claude.md должен создаваться вручную, а не через команду init, чтобы содержать только уникальные инструкции и правила проекта без дублирования общеизвестной информации.

Использование файла прогресса и файла обучения (learnings.md) снижает потребление токенов и предотвращает повторение одних и тех же ошибок кодирования.

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

Интеграция Supabase, Shadcn UI и Playwright через протокол MCP до начала сборки обеспечивает агентам необходимый инструментарий для автономной работы.

Timeline

Смена парадигмы в планировании требований

  • Традиционные процессы разработки теперь служат для структурирования работы ИИ-агентов, а не только людей.
  • Специализированный агент-планировщик заменяет стандартный технический режим планирования Claude для фокусировки на продуктовых требованиях.
  • Итоговый PRD-документ автоматически сохраняется в папку проекта и служит единым источником истины для всех последующих этапов.

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

Настройка управляющих файлов и инструментов

  • Файл Claude.md выступает в роли глобального руководства, которое загружается в контекст один раз и содержит только специфические правила проекта.
  • Внешние сервисы вроде Supabase и Playwright подключаются через MCP до начала написания кода для обеспечения доступа агентов к инфраструктуре.
  • Разделение ответственности между специализированными агентами (коммиты, рефакторинг, верификация) повышает качество отдельных аспектов разработки.

Ручное создание файла Claude.md предпочтительнее автоматической инициализации, так как стандартные команды часто включают в файл лишнюю информацию о структуре проекта, которую ИИ может считать самостоятельно. Навыки (skills) следует использовать для повторяющихся рабочих процессов, таких как верстка фронтенда, в то время как отдельные агенты лучше подходят для задач, требующих изоляции контекста. Специфические правила для конкретных путей к файлам дополняют общие принципы, устраняя двусмысленность при реализации локальных задач.

Отрицательные ограничения и файлы памяти

  • Явное указание запрещенных действий в отдельном файле в папке docs предотвращает нежелательные эксперименты ИИ.
  • Файл прогресса избавляет агента от необходимости постоянно перечитывать весь код для понимания статуса задач.
  • Логирование ошибок в файле обучения гарантирует, что ИИ не совершит одну и ту же ошибку дважды в рамках одного проекта.

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

Тестирование по спецификациям и управление ошибками

  • Тесты, написанные после реализации кода, менее эффективны, так как ИИ подстраивает их под существующие баги.
  • Интеграция с GitHub, Trello или Notion позволяет фиксировать проблемы в понятном для нетехнических специалистов виде.
  • Использование Git-коммитов после каждого шага обеспечивает возможность безопасного отката при возникновении критических ошибок.

Написание тестов на раннем этапе заставляет агента воссоздавать логику приложения непосредственно из PRD, что выявляет узкие места еще до компиляции. Для командной работы рекомендуется использовать Notion MCP, чтобы баги фиксировались в общей системе управления проектами, а не только в технической среде. Структурированные сообщения коммитов помогают ИИ лучше понимать историю изменений и контекст каждой правки.

Подготовка к нагрузкам и масштабированию

  • Передача агенту данных об ожидаемом количестве пользователей позволяет заранее создать сценарии стресс-тестирования.
  • Инструмент K6 применяется для автоматизированной проверки производительности приложений на Next.js.
  • Технический план масштабируемости, построенный Claude в режиме планирования, является финальным этапом подготовки продукта к релизу.

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

Community Posts

View all posts