AI-кодинг для fullstack: с чего начать в 2026

AI-кодинг для fullstack — это другой способ вести разработку: вы формулируете задачу и критерий готовности, а агент читает ваш проект, запускает тесты, правит код и сам проверяет результат. Но за этой простой идеей скрывается несколько уровней инструментов, которые нужно освоить в правильном порядке. В этой статье — дорожная карта: от ментальной модели до spec-driven разработки, с типичными ошибками на каждом этапе.

Уровень 0. Ментальная модель агента

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

Правильная модель состоит из четырёх понятий:

Контекст — всё, что агент видит прямо сейчас: ваш запрос, прочитанные файлы, вывод команд, история сессии. Агент не знает о проекте ничего сверх этого. Чем чище контекст — тем лучше результат.
Инструменты — конечный набор действий агента: читать файл, писать файл, искать по коду, запускать команду в терминале, ходить в git. Агент не «думает» — он вызывает инструменты.
Разрешения — слой между «хочет выполнить» и «выполнил». Опасные действия требуют вашего подтверждения. Это ваш руль и тормоз.
Цикл агента — агент работает в петле: понял задачу → собрал контекст → выбрал инструмент → посмотрел на результат → решил, что дальше. Запустил тест, увидел красный, прочитал ошибку, починил, перезапустил.

Главный сдвиг: перестать мыслить репликами («дай функцию») и начать мыслить задачами («сделай, чтобы этот тест прошёл»). Подробнее о модели — в статье что такое Claude Code.

Уровень 1. Установка и первый таск

Прежде чем настраивать что-либо — просто запустите и дайте реальную задачу из своего проекта. Не «привет, что ты умеешь?», а «найди все места, где используется устаревший API, и замени на новый». Посмотрите, как агент читает файлы, как спрашивает разрешение, как делает несколько итераций.

Первый запуск ломает неправильные ожидания быстрее, чем любое объяснение. Как установить Claude Code — там же про управление контекстом и режимы работы.

На этом этапе типичная ошибка — давать расплывчатые задачи: «сделай лучше», «рефактори», «оптимизируй». Агент честно попробует — и закодирует ваше непонимание. Формулируйте цель и проверяемый критерий готовности.

Уровень 2. CLAUDE.md — конституция проекта

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

Ответ — файл CLAUDE.md в корне репозитория. Это инструкция, которую агент читает при каждом запуске. Туда идёт:

стек и конвенции (Next.js + NestJS, TypeScript strict, именование файлов);
структура проекта и что где лежит;
команды для запуска тестов, линтера, сборки;
правила, которые нельзя нарушать (не коммитить секреты, всегда писать тесты для новых эндпоинтов);
контекст домена (что такое «заказ», «клиент», «смена» в вашем проекте).

Без CLAUDE.md агент каждый раз начинает с нуля и угадывает конвенции по коду. С хорошим CLAUDE.md — уже с первого запроса знает, что в проекте принято, и не изобретает велосипед. Детали настройки — в статье CLAUDE.md: настройка.

Типичная ошибка: написать CLAUDE.md один раз и забыть. Это живой документ — обновляйте его, когда меняете конвенции или добавляете новые модули.

Уровень 3. Skills — повторяемые инструкции

Когда у вас есть задачи, которые повторяются по одному шаблону («создай CRUD-модуль», «напиши миграцию», «добавь эндпоинт по паттерну X»), — оформляйте их как skills.

Skill — это файл-инструкция, который агент читает, когда вы его вызываете явно или когда триггер совпадает с запросом. Механика проста: описание (description) определяет, когда skill срабатывает, тело — что делать.

Главная ценность skills — прогрессивное раскрытие контекста. Инструкция подгружается только тогда, когда нужна, а не висит в контексте всё время. Это и экономия, и чистота.

Для fullstack-проекта полезные skills:

генератор CRUD-модуля по конвенциям проекта;
шаблон для новой страницы Next.js с нужными импортами и структурой;
skill для написания e2e-теста по описанию сценария.

Подробнее о механике — что такое skills.

Уровень 4. MCP — внешние инструменты для агента

По умолчанию агент работает только с файлами и терминалом. MCP (Model Context Protocol) — способ подключить к агенту дополнительные инструменты: браузер, базу данных, внешние API, документацию.

Для fullstack-разработки три MCP меняют многое:

Context7 — агент получает актуальную документацию библиотек (Next.js, NestJS, Prisma) прямо в контекст, а не галлюцинирует API из тренировочных данных.
Playwright — агент открывает браузер, кликает, проверяет UI. Полноценное e2e-тестирование без ручного запуска.
PostgreSQL — агент читает схему базы, выполняет запросы, видит реальные данные и может проверить миграции.

MCP не требует писать код агента с нуля — подключаете готовый сервер через конфиг. Что такое MCP — там и протокол, и примеры подключения.

Типичная ошибка на этом уровне — подключить всё сразу. Каждый MCP-сервер занимает контекст и требует разрешений. Добавляйте только то, что реально нужно для текущей задачи.

Уровень 5. Субагенты и параллельная работа

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

Типичный сценарий для fullstack: три независимых CRUD-модуля (меню, клиенты, заказы) генерируются тремя агентами одновременно. Каждый работает в своей ветке (worktree), изолированно. Итог — три PR вместо одного, и в три раза быстрее.

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

Уровень 6. Spec-driven development

На предыдущих уровнях вы делегируете конкретные задачи с чётким критерием. Spec-driven — следующий шаг: вы описываете фичу на естественном языке, агент сначала уточняет требования, потом строит план, потом реализует.

Поток выглядит так:

/specify — агент задаёт уточняющие вопросы и создаёт спецификацию;
/plan — на основе спецификации строит технический план;
/tasks — план разбивается на атомарные задачи;
/implement — каждая задача реализуется с проверкой.

Ценность не в том, что это «автоматически». Ценность в том, что спецификация становится однозначной до написания кода. Меньше переделок, меньше «а я думал, что имелось в виду другое».

Для fullstack особенно полезно при фичах, которые затрагивают и API, и UI, и базу одновременно — спека фиксирует контракт между слоями. Подробнее: spec-driven development.

Типичные ошибки и как их избежать

Пропускать уровни. Часто хотят сразу субагентов и spec-driven, не разобравшись с контекстом и CLAUDE.md. Результат — агент делает странные вещи, и непонятно, почему. Пройдите уровни по порядку на реальном проекте.

Расплывчатые задачи. «Улучши производительность» — плохо. «Добавь индекс на поле created_at в таблице orders и проверь, что запрос выборки заказов за сутки выполняется быстрее» — хорошо. Чем конкретнее критерий готовности, тем лучше результат.

Не читать, что делает агент. Агент может принять неверное архитектурное решение — особенно если в CLAUDE.md не описан контекст домена. Ревьюйте диф перед коммитом, не полагайтесь на «сам разберётся».

Держать всё в одной сессии. Длинная сессия с большой историей снижает качество — агент «забывает» детали из начала диалога. Очищайте контекст и начинайте новую сессию при смене задачи.

Делегировать то, что ещё не понимаете сами. Если вы сами не можете сформулировать, что значит «готово» — агенту делегировать нечего. Сначала ясность в голове, потом задача агенту. Как делегировать задачи AI-агенту — там про правильные формулировки.

С чего начать прямо сейчас

Не стройте идеальный CLAUDE.md с нуля. Возьмите реальный рабочий проект и:

Установите Claude Code, дайте одну конкретную задачу с проверяемым результатом.
Посмотрите, что пошло не так из-за отсутствия контекста — это покажет, что писать в CLAUDE.md.
Добавьте CLAUDE.md с минимумом: стек, структура, команды тестов.
Повторите задачу — сравните результат.

Этот цикл за один-два дня даёт больше понимания, чем неделя чтения документации.

Если хотите пройти этот путь структурированно — от пустого репозитория до задеплоенного fullstack-проекта с агентами, skills, MCP и spec-driven — посмотрите полный курс по Claude Code. Сквозной проект, реальный стек (Next.js + NestJS + PostgreSQL), без платных API.