Урок 3: Сравнение результатов и заключение

Чему вы научитесь

В этом уроке вы:

• Создадите полный отчёт о работе с AI-агентами
• Сравните скорость и качество решений
• Поймёте, когда AI-помощник наиболее эффективен
• Получите сертификат об окончании Трека 2
• Узнаете, как продолжить обучение

Результат: объективная оценка вашей продуктивности с AI и план для будущей работы.

Содержание

Часть 1: Заполняем отчёт

Шаблон отчёта для одной задачи

Для каждой из трёх задач создайте отчёт в формате Markdown:

# Задача 1: Баг-фикс

## Описание
Исправление ошибки 500 при пустом теле запроса в POST /api/items

## Время выполнения
- С агентом: 12 минут
- Без агента (оценка): 25 минут
- Экономия: 52%

## Метрики качества

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время (мин) | 12 | 25 |
| Кол-во итераций | 1 | 2-3 |
| Тесты пройдены (%) | 100% | 95% |
| Линтер errors | 0 | 1 |
| Покрытие тестами | 95% | 80% |
| Субъективная оценка (1-10) | 9 | 7 |

## Описание процесса

### С агентом
1. Написал промпт (2 мин)
2. Claude прочитал файлы (1 мин)
3. Агент предложил решение (3 мин)
4. Я проверил и одобрил (2 мин)
5. Тесты запущены (4 мин)

Итого: 12 минут, 0 багов, готово с первой попытки.

### Без агента (воображаемый сценарий)
1. Найти баг в коде (5 мин)
2. Написать валидацию вручную (10 мин)
3. Написать тесты (7 мин)
4. Запустить и исправить ошибки (2 мин)
5. Переделать тесты (1 мин)

Итого: 25 минут, нужна переделка теста, требует опыта.

## Что сработало хорошо
[+] Агент быстро нашёл место ошибки
[+] Предложил правильное решение с первой попытки
[+] Написал тесты корректно

## Что можно улучшить
[!] Агент не добавил обработку пробельных строк (я подправил)
[!] Не учёл type checking (string vs number)

## Вывод
**AI ускоряет простые задачи на 50-70%.** Идеален для:
- Bug-fixing
- Стандартных паттернов
- Написания тестов

Но требует проверки код-ревью.

Как заполнять: инструкция по замеру

Шаг 1: Записывайте время

Используйте секундомер (есть на телефоне):

• Запустите при начале работы над задачей
• Остановите, когда все тесты проходят
• Запишите в минутах и секундах

Инструмент: используйте time команду в bash:

time npm test
# Real: 0m 4.523s

Шаг 2: Считайте итерации

Итерация = цикл “промпт → агент → результат → проверка”.

Пример 1 (1 итерация):

Я: "Добавь пагинацию"
Агент: Добавил код [+]
Тесты: Пройдены [+]
Готово.

Пример 2 (2 итерации):

Я: "Добавь пагинацию"
Агент: Добавил код, но забыл валидацию limit
Я: "Ограничь limit максимум 100"
Агент: Исправил [+]
Тесты: Пройдены [+]
Готово.

Шаг 3: Проверьте линтер

npm run lint

# Если есть ошибки:
# [-] 12 error(s), 3 warning(s)

# Если чисто:
# [+] No errors, no warnings

Шаг 4: Проверьте покрытие тестами

npm run coverage

# Результат:
# Statements   : 85.5% ( 342/400 )
# Branches     : 78.2% ( 98/125 )
# Functions    : 92.1% ( 47/51 )
# Lines        : 86.3% ( 345/400 )

Запишите % Statements (основной показатель).

Шаг 5: Субъективная оценка

Ответьте на вопросы (1-10 баллов каждый):

1. Скорость: насколько быстрее с агентом? (1=медленнее, 10=в 3 раза быстрее)
2. Качество: насколько хорош код агента? (1=требует переделки, 10=идеален)
3. Удобство: удобно ли работалось? (1=мучение, 10=легко и приятно)
4. Надёжность: можно ли доверять агенту? (1=нельзя, 10=полностью доверяю)

Финальная оценка = среднее из 4 вопросов.

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

Пример 1: Developer A (быстро на простых, медленнее на сложных)

# Отчёт: Трек 2 - 3 задачи

## Задача 1: Баг-фикс [*]
**Время:** 12 минут (с агентом) vs 25 минут (оценка без)
**Итерации:** 1

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 12 мин | 25 мин |
| Итерации | 1 | 2 |
| Тесты (%) | 100% | 95% |
| Линтер | 0 ошибок | 1 ошибка |
| Покрытие | 95% | 80% |
| Оценка (1-10) | 9 | 7 |

**Опыт:** Агент моментально нашёл место ошибки и написал валидацию. Очень эффективно для простых багов!

---

## Задача 2: Новая фича (пагинация) [**]
**Время:** 22 минут (с агентом) vs 40 минут (оценка без)
**Итерации:** 2

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 22 мин | 40 мин |
| Итерации | 2 | 3 |
| Тесты (%) | 100% | 90% |
| Линтер | 0 ошибок | 2 ошибки |
| Покрытие | 88% | 75% |
| Оценка (1-10) | 8 | 6 |

**Опыт:** Агент написал основной код хорошо, но забыл про граничные случаи (limit > 100). Пришлось одну итерацию уточнить. Всё равно быстрее, чем самому.

**Вторая итерация:**
- Я: "Ограничь limit максимум 100"
- Агент: Добавил валидацию за 1 минуту
- Готово!

---

## Задача 3: Рефакторинг [***]
**Время:** 38 минут (с агентом) vs 90 минут (оценка без)
**Итерации:** 3

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 38 мин | 90 мин |
| Итерации | 3 | 5 |
| Тесты (%) | 100% | 85% |
| Линтер | 0 ошибок | 4 ошибки |
| Покрытие | 82% | 70% |
| Оценка (1-10) | 7 | 5 |

**Опыт:** Рефакторинг сложный. Агент хорошо разбил монолит, но пришлось 3 раза переписывать импорты. На таких задачах требуется больше контроля, но всё равно AI помогает.

**Ошибки:**
1. Циклические импорты в middleware
2. Забыл подключить errorHandler в правильном месте
3. Нужно было добавить checks для DB конфига

Каждый раз я объяснял проблему - агент исправлял за несколько минут.

---

## ИТОГИ

### Общая статистика
- **Общее время с агентом:** 72 минуты
- **Оценка без агента:** 155 минут
- **Экономия времени:** 53%
- **Среднее качество:** 8/10

### Выводы по задачам

| Тип задачи | Ускорение | Качество | Рекомендация |
|-----------|----------|---------|-------------|
| Баг-фикс | 2x | Отличное | [+] Используй всегда |
| Новая фича | 1.8x | Хорошее | [+] Используй для первого черновика |
| Рефакторинг | 2.4x | Нормальное | [!] Используй, но тщательно проверяй |

### Когда AI эффективен
[+] Простые задачи (баги, стандартные фичи)
[+] Поиск ошибок и логирование
[+] Написание тестов
[+] Первый черновик кода

### Когда нужна ручная работа
[-] Сложный архитектурный рефакторинг
[-] Критичные решения по безопасности
[-] Code-review перед боевым сервером
[-] Оптимизация производительности

**Вывод:** AI — это не замена программисту, это ускоритель. Лучший результат когда человек + агент работают вместе.

Пример 2: Developer B (медленнее, но выучил технику)

# Отчёт: Трек 2 - 3 задачи (вариант 2)

## Задача 1: Баг-фикс [*]
**Время:** 18 минут (с агентом) vs 20 минут (оценка без)
**Итерации:** 2

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 18 мин | 20 мин |
| Итерации | 2 | 2 |
| Тесты | 100% | 100% |
| Линтер | 0 | 0 |
| Покрытие | 96% | 92% |
| Оценка | 8 | 8 |

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

**Вывод:** Баги — это не главное преимущество AI для меня.

---

## Задача 2: Новая фича [**]
**Время:** 28 минут (с агентом) vs 35 минут (оценка без)
**Итерации:** 1

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 28 мин | 35 мин |
| Итерации | 1 | 2 |
| Тесты | 100% | 95% |
| Линтер | 0 | 0 |
| Покрытие | 92% | 88% |
| Оценка | 9 | 8 |

**Опыт:** Тут агент помог! Я просто дал чёткое описание требований, и он написал 90% кода корректно. Это где есть настоящая экономия.

**Ключевой момент:** когда я был точен в описании → агент был точен в коде.

---

## Задача 3: Рефакторинг [***]
**Время:** 52 минуты (с агентом) vs 85 минут (оценка без)
**Итерации:** 4

| Метрика | С агентом | Без агента |
|---------|-----------|-----------|
| Время | 52 мин | 85 мин |
| Итерации | 4 | 4 |
| Тесты | 98% | 90% |
| Линтер | 2 warning | 5 error |
| Покрытие | 80% | 75% |
| Оценка | 6 | 5 |

**Опыт:** Сложная задача, агент потерялся в архитектуре. Нужно было много уточнений. Но учебное значение было огромное!

Я узнал как:
- Правильно разбивать монолиты
- Организовать middleware
- Писать типы для больших проектов

**Главный вывод:** даже если агент не идеален, работа с ним учит правильной архитектуре.

---

## ИТОГО

**Суммарное время:** 98 минут с агентом, ~140 минут без
**Сокращение:** 30%

**Но самое важное:** я теперь понимаю архитектуру намного лучше!

**Рекомендация:** используй AI как учителя, а не только как помощника. Когда ты объясняешь агенту задачу, ты сам лучше её понимаешь.

Часть 3: Анализ и выводы

Когда AI ускоряет работу (и насколько)

flowchart LR
  A["Баг-фикс 1.5-2x"] --> B["Фичи 1.8-2.5x"]
  B --> C["Рефакторинг 2-3x"]
  C --> D["Новые технологии 3-5x"]

Категория 1: Баг-фиксинг ([*])

• Ускорение: 1.5x - 2x
• Идеально для:
  • Ошибок в валидации
  • Неправильных статус кодов
  • Простых логических ошибок

Категория 2: Новые фичи со стандартными паттернами ([**])

• Ускорение: 1.8x - 2.5x
• Идеально для:
  • API endpoints (CRUD)
  • Пагинация, фильтры
  • Логирование, мониторинг

Категория 3: Сложный рефакторинг ([***])

• Ускорение: 2x - 3x
• Но требует:
  • Четких требований заранее
  • 2-3 итераций уточнения
  • Интенсивного code-review

Категория 4: Новые технологии ([****])

• Ускорение: 3x - 5x
• Когда вы не знаете:
  • Синтаксис нового языка
  • Лучшие практики фреймворка
  • API незнакомой библиотеки

Когда AI замедляет работу

[-] Когда задача требует контекста большего, чем может вместить промпт

Пример:

Вы: "Отрефакторь сервер"
Агент: Читает 2 файла из 15 нужных
Пишет неправильный код
Вам нужно исправлять

Решение: разбейте задачу на части или используйте @-упоминания файлов.

[-] Когда нужно принять архитектурное решение

Пример:

Вы: "Как лучше организовать БД?"
Агент: Предлагает 3 варианта
Но не знает вашего контекста, масштаба, нагрузки

Решение: сначала вы решаете архитектуру, потом агент реализует.

[-] Когда нужна специфичная для компании логика

Пример:

Вы: "Добавь обработку ошибок"
Агент: Использует стандартный errorHandler
Но в вашей компании свой протокол ошибок

Решение: заранее создайте CLAUDE.md с примерами компании.

Таблица сравнения: “AI vs Без AI”

Часть 4: Ваш сертификат

Условия получения сертификата “Кодинг с AI-агентами”

Вы получите сертификат, если выполнили:

[+] Модуль 2.2: Основы работы с Claude Code (ознакомились)

[+] Модуль 2.7: MCP-серверы (настроили)

[+] Модуль 2.6: Документирование (создали CLAUDE.md + AGENTS.md)

[+] Модуль 2.9: Code-review и workflows (провели)

[+] Модули 2.1–2.9: Практика в каждом модуле

[+] Модуль 2-10 - Финальный проект:

• Подготовили проект (Урок 1)
• Решили 3 задачи с агентом (Урок 2)
• Создали полный отчёт (Урок 3)

[+] Все тесты проходят: npm test [+]

[+] Код без ошибок: npm run lint [+]

Сертификат

╔════════════════════════════════════════════════════════════╗
║                                                            ║
║     СЕРТИФИКАТ О ЗАВЕРШЕНИИ КУРСА                        ║
║                                                            ║
║     Трек 2: Кодинг с AI-агентами (Claude Code)          ║
║                                                            ║
║     Выдан: ______________________ [ваше имя]             ║
║     Дата:  1 марта 2026                                  ║
║                                                            ║
║     [+] Установлены MCP-серверы                            ║
║     [+] Написаны 50+ промптов                               ║
║     [+] Проведены code-review с AI                          ║
║     [+] Решены 3 реальные задачи                            ║
║     [+] Создан полный аудит производительности             ║
║                                                            ║
║     Компетенции:                                          ║
║     • Работа с Claude Code                                ║
║     • Промпт-инжиниринг                                   ║
║     • Архитектурный рефакторинг с AI                      ║
║     • Управление качеством кода                           ║
║     • Оптимизация рабочего процесса                       ║
║                                                            ║
║     Средний результат: ___/10 (из ваших оценок)          ║
║                                                            ║
║     Подпись инструктора: ________________                ║
║                                                            ║
╚════════════════════════════════════════════════════════════╝

Рекомендуемая должность: Senior Developer / Tech Lead

Следующий уровень: архитектурные решения + управление командой

Как получить физический сертификат:

1. Скопируйте текст выше
2. Заполните пропуски
3. Экспортируйте в PDF
4. Поделитесь в LinkedIn (опционально)

Часть 5: Резюме навыков Трека 2

Что вы теперь умеете

Уровень 1: Новичок (пройдена часть модулей)

• [+] Использовать Claude Code в основном режиме
• [+] Писать простые промпты (“добавь функцию…”)
• [+] Разбирать код, написанный агентом

Уровень 2: Практик (пройдены все модули)

• [+] Настраивать MCP-серверы
• [+] Писать детальные промпты с контекстом
• [+] Искать баги через AI
• [+] Рефакторить код с помощью агента
• [+] Проводить code-review решений AI
• [+] Оценивать качество AI-кода

Уровень 3: Эксперт (владеете всеми техниками + опыт)

• [+] Архитектурный рефакторинг с AI
• [+] Многошаговые промпты (план → имплементация → тест)
• [+] Управление командой с использованием AI
• [+] Создание документации для AI-ассистентов
• [+] Обучение других работе с AI
• [+] Выбор правильного инструмента для каждой задачи

Ваши новые суперспособности

Часть 6: Что дальше?

Продолжение обучения

Если вы Junior разработчик

Следующие шаги:

1. Практика: решайте задачи из LeetCode с помощью Claude
2. Проекты: создайте личный проект (SPA, API, CLI-утилита)
3. Чтение кода: учитесь у опен-сорса (попросите AI объяснить код)
4. Менторство: попросите опытного программиста code-review ваших работ с AI

Ресурсы:

• LeetCode.com — задачи по алгоритмам
• Frontend Masters — видео курсы
• GitHub Awesome Lists — лучшие проекты для изучения
• Ваше местное сообщество разработчиков

Если вы Middle разработчик

Следующие шаги:

1. Architecture: учитесь проектировать системы (Design Patterns, System Design)
2. Optimization: оптимизируйте production код (performance, scalability)
3. Leadership: возглавьте небольшой проект в команде
4. Teaching: создайте свой туториал или курс

Ресурсы:

• System Design Interview — подготовка к собеседованиям
• Clean Code / Clean Architecture — архитектура
• PostgreSQL / MongoDB доки — глубокое погружение в БД
• Высоконагруженные системы (книга)

Если вы Senior / Tech Lead

Следующие шаги:

1. Автоматизация: создайте CI/CD/CD pipeline с AI помощью
2. Code Quality: настройте автоматические проверки кода
3. Team Scaling: обучайте команду работать с AI
4. Innovation: экспериментируйте с новыми технологиями

Ресурсы:

• DevOps Handbook — автоматизация процессов
• Team Topologies — организация команд
• Building Microservices — архитектура
• The Phoenix Project — управление проектами

Сообщество

Где найти помощь и общение

Discord серверы:

• Claude Community (официальный)
• Developer Advocates (для advanced вопросов)
• ваше локальное AI сообщество

GitHub:

• anthropics/anthropic-sdk-python — официальные примеры
• Поищите claude-code или mcp-server в repos

YouTube каналы:

• Anthropic Official
• ваши местные DevTalk-конференции
• Tech-блогеры вашего стека

Конференции 2026:

• AI DevSummit (виртуально)
• Your local JavaScript/Python meetups
• PyCon / JSConf

Бесплатные ресурсы для продолжения

Документация (всегда актуальна):

• https://docs.anthropic.com/en/docs/claude-code — официальные доки Claude Code
• https://docs.anthropic.com — API и SDK документация
• https://github.com/anthropics/anthropic-sdk-python
• https://github.com/anthropics/anthropic-sdk-typescript

Открытые примеры:

• https://github.com/anthropics/anthropic-cookbook — примеры кода
• https://github.com/modelcontextprotocol/servers — официальные MCP серверы

Статьи и гайды:

• “Prompt Engineering Guide” — на GitHub и Kaggle
• “AI Code Review Best Practices” — от Anthropic
• Medium — поиск по “Claude AI development”

Практика:

• GitHub Issues — найдите проект, помогайте с AI
• Open Source Contribution — контрибьютьте в проекты
• Your company’s codebase — работайте с реальным кодом

Часть 7: Финальное слово

Вы прошли путь от новичка до практика

Когда вы начинали Трек 2:

• “Как это работает?”
• “Может ли AI писать код?”
• “Когда это сломается?”

Теперь вы знаете:

• [+] Как работает Claude Code
• [+] Когда AI ускоряет, когда замедляет
• [+] Как правильно работать с агентом
• [+] Как проверять и улучшать результаты

Главное, что вы узнали

AI — это не волшебство. Это инструмент, как Git, Docker или SQL.

Как любой инструмент, он:

• Требует обучения и практики
• Имеет свои сильные стороны
• Имеет свои ограничения
• Становится всё мощнее с опытом

Три принципа работы с AI

Последний совет

Не ждите, пока AI будет идеален. Начните использовать его сейчас.

Даже если результаты на 80% соответствуют вашим ожиданиям — это всё равно экономия 50% времени. А в production-е, где вы всё равно проверяете код, эта разница становится ещё более ценной.

До встречи!

Спасибо, что прошли этот курс.

Если вы:

• Решили все 3 задачи [+]
• Заполнили отчёт [+]
• Поделились опытом с командой [+]

…то вы готовы быть современным разработчиком в эпоху AI.

Впереди вас ждут:

• Более крупные проекты
• Более сложные задачи
• Вдохновляющий опыт работы с AI
• Мир, где код пишут быстрее и лучше

АНКЕТА: Помогите улучшить курс

После прохождения заполните короткую анкету (3-5 минут):

1. Какой урок был самым полезным?
   [ ] 1.1 Основы Claude
   [ ] 1.4 Промпт-инжиниринг
   [ ] 2.6 Документирование
   [ ] 2.10 Финальный проект
   [ ] Другое: ________

2. Что было сложнее всего?
   [ ] Понимание MCP
   [ ] Написание хороших промптов
   [ ] Проверка AI-кода
   [ ] Настройка инструментов

3. Что было проще всего?
   [ ] Понимание базовых концепций
   [ ] Использование Claude Code
   [ ] Чтение и правка кода
   [ ] Написание отчётов

4. Как часто вы будете использовать AI в работе?
   [ ] Каждый день
   [ ] Несколько раз в неделю
   [ ] Несколько раз в месяц
   [ ] Редко
   [ ] Не буду

5. Чему мы не научили, а вы хотели бы узнать?
   ________________________________________

Спасибо за обратную связь! 

Поздравляем!

Вы официально завершили Трек 2: Кодинг с AI-агентами.

Вас теперь можно назвать практиком в области использования AI для разработки. Вы знаете:

• Когда помогает AI, когда мешает
• Как писать промпты
• Как проверять результаты
• Как работать с помощником эффективно

Это очень ценный навык в 2026 году.

Впереди вас ждёт новый Трек 3 (если вы захотите): “OpenClaw (AI-ассистент)”. Там мы научимся работать с большими проектами и командами.

Но сначала — отдохните, примените полученные знания в своих проектах, и наслаждайтесь результатами!

Сертификат получен. Миссия выполнена.

Спасибо за внимание и до встречи в следующем треке!

— Команда курса AIStudy