Мышление через Git Diff (Искусство проверки правок)

1. Обзор концепции и системная проблема

Десятилетиями главной навыком программиста считалась скорость набора текста: сколько сотен строк кода за изменение вы можете выбить пальцами по клавиатуре.

В эпоху автономных агентов и вайбкодинга эта механическая навык девальвировала. Любая языковая модель генерирует 1 000 строк кода за 8 секунд. Таким образом, главной ценностью инженера стало искусство быстрого анализа дифа (Diff-First Mindset).

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

• «Зеленый код корректен, но красный удалил критическую проверку сессии — отклоняю!»
• «Изменения чистые, архитектура не сломана — коммитим!»

Ментальная модель: как главный редактор журнала не пишет все колонки сам, а вычитывает гранки перед печатью, так и senior-инженер фильтрует выходные данные агентов через сито Git Diff.

┌─────────────────────────────────────────────────────────────┐
│                 АРХИТЕКТУРА ДИФ-ФИЛЬТРАЦИИ                  │
├─────────────────────────────────────────────────────────────┤
│ 1. ПРОМПТ ДЛЯ АГЕНТА:                                       │
│    «Добавь кэширование сессий через Redis в модуль auth.ts» │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ Автономная генерация              │
├─────────────────────────────────────────────────────────────┤
│ 2. НЕПРЕЗЕНТАБЕЛЬНЫЙ СЫРОЙ ВЫХОД (4 файла изменено)       │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ Контрольный шлюз DIFF-REVIEW     │
├─────────────────────────────────────────────────────────────┤
│ 🛑 ТАКСОНОМИЯ ПРОВЕРКИ:                                    │
│    • КРАСНЫЕ СТРОКИ (-): Не стерто ли логирование и типы?  │
│    • ЗЕЛЕНЫЕ СТРОКИ (+): Нет ли галлюцинированных пакетов?  │
│    • СТАТИСТИКА: Если просили 5 строк, а изменилось 120 —   │
│      НЕГАЙНЫЙ REJECT!                                       │
└─────────────────────────────────────────────────────────────┘

2. Инженерный пример: анатомия правильного дифа

diff --git a/src/services/billing.ts b/src/services/billing.ts
--- a/src/services/billing.ts
+++ b/src/services/billing.ts
@@ -42,7 +42,9 @@ export async function calculateInvoice(user: UserProfile) {
-  // Временный хак: фиксированная скидка для тестов
-  return user.cartTotal * 0.95;
+  // Проверка активной подписки перед расчетом
+  const discountRate = await getSubscriptionDiscount(user.id);
+  return user.cartTotal * (1 - discountRate);
 }

Смотря на этот фрагмент, опытный инженер сразу проверяет три вещи:

1. Красный минус: Удален именно технический долг (временный хак), как и требовалось в тикете.
2. Зеленый плюс: Вызов getSubscriptionDiscount является асинхронным и добавлено await.
3. Контракт: Тип возвращаемого значения остается числовым, побочных эффектов на соседние методы нет. Можно уверенно нажимать Accept.

3. Практические CLI-команды для инспекции дифа в терминале

Все современные IDE (Cursor, VS Code, Windsurf) имеют графические UI для дифа, но настоящий контроль достигается в терминале через точные флаги Git:

# 1. Быстрая сводная статистика: сколько строк добавлено/удалено в каждом файле
git diff --stat

# 2. Просмотр изменений только для конкретного файла без постороннего шума
git diff src/lib/auth.ts

# 3. Просмотр изменений, которые уже добавлены в staging (перед git commit)
git diff --staged

# 4. Интерактивный пошаговый разбор (Patch Mode): позволяет принимать или отклонять куски файла (hunk) по очереди
git checkout -p

# 5. Игнорирование изменений пробелов и форматирования, чтобы увидеть чистую логику
git diff -w --ignore-blank-lines

4. Четыре золотых правила гигиены чтения Diff

1. Фокус на красном (Red First): Новый код (зеленый) почти всегда выглядит гладко. Наиболее опасные регрессии и дыры в безопасности всегда скрываются в удаленных красных строках.
2. Проверка импортов: Обратите внимание на первые 10 строк файла. Не добавил ли агент стороннюю библиотеку (например, lodash или axios), если в проекте уже есть нативные инструменты?
3. Правило лимита объема (Diff Budget): Если вы просили модель изменить одну валидацию формы, а дифф показывает +180 -95 строк в 5 файлах — не пытайтесь его вычитывать. Нажмите Reject и перезапустите промпт с жестким ограничением: "Изменения только функцию validateForm в файле Form.tsx, не трогай остальной код".
4. Line-by-line Accept: Избегайте кнопки «Accept All» в сложных файлах. Принимайте изменения отдельными блоками (Hunk by Hunk).

5. Подводный камень, типовые ошибки и безопасность

Diff-First Mindset — это главная навык выживания в 2026 году. Она защищает вашу кодовую базу от постепенной деградации и синтетического мусора, превращая бешеную скорость нейросетей в стабильный и надежный бизнес-результат.