Как предотвратить потерю контекста при написании продакшн-кода с помощью Claude Code
1. Почему ИИ забывает структуру всего проекта
В крупномасштабных проектах ошибки ИИ-агентов, таких как Claude, — это не ваша вина. Модели подвержены явлению «потери в середине» (Lost in the Middle), когда они фокусируются только на начале и конце диалога. В частности, когда контекстное окно заполнено более чем на 60%, качество ответов резко падает. Если системный файл инструкций слишком длинный, ИИ тратит все токены на чтение конфигурационных файлов вместо важной логики.
Чтобы предотвратить это, не заставляйте ИИ распылять свое внимание.
- Сократите системные инструкции (CLAUDE.md) до 200 строк или менее.
- Если диалог затягивается, очищайте историю с помощью команды /compact.
- Не заставляйте его сканировать весь проект, указывайте рабочую область напрямую, например: «строки 45–80 в конкретном файле».
2. Диета кодовой базы и проектирование схем
Передавать ИИ весь исходный код неэффективно. Вместо этого сначала стандартизируйте интерфейсы. Создавайте отдельные файлы схем: OpenAPI для API, Zod или Pydantic для моделей данных. Таким образом, ИИ не нужно ломать голову над всей логикой, он будет генерировать код только в рамках заданного стандарта. По результатам моих личных тестов, при предоставлении таких схем количество запросов на повторное исправление из-за некорректного кода от ИИ сократилось почти на 60%.
- Создавайте схемы в формате .json или .yaml для каждого модуля.
- Разместите в корне проекта файл ai-context.md объемом до 100 строк, содержащий только ключевую структуру.
- Не давайте команду на поиск по всему проекту, используйте команду grep для извлечения и чтения только необходимых строк.
3. Проверка кода ИИ с помощью тестовой песочницы
Код, написанный ИИ, часто выглядит убедительно, но содержит множество багов. Используйте Husky или фреймворки pre-commit, чтобы заблокировать слияние кода, не прошедшего контроль качества.
- Добавьте в хуки pre-commit eslint и tsc --noEmit, чтобы предотвратить синтаксические ошибки и ошибки типов на корню.
- Настройте хук PreToolUse для выполнения проверки безопасности перед внесением правок, чтобы предотвратить утечку API-ключей.
- Когда главный агент пишет код, поручите суб-агенту написать провальный тест для этого кода. Запуск цикла до тех пор, пока тест не будет пройден (Green), позволит выявлять баги на ранней стадии.
4. Стратегия ветвления для инициализации сессии
Если ИИ затрагивает несколько файлов, возникают побочные эффекты. Чтобы этого избежать, используйте ветки не как хранилище, а как рабочие контейнеры. Разделение веток по функционалу позволяет изолировать ИИ, чтобы он учитывал только последние изменения.
- Даже для реализации одной функции входа, создавайте отдельную ветку, например: feature/auth-validation.
- Перед завершением сессии обязательно выполните /compact, а оставшиеся задачи запишите в файл current-handover.md.
- При начале новой сессии очищайте предыдущую историю с помощью /clear и заново загружайте только необходимые файлы схем и документы по передаче задач (handover).
Это поможет избежать порчи кода из-за ненужного ИИ прошлого контекста.
makedream
12:38