Управление контекстом при исследовании больших баз кода

Суть

Файлы-черновики (scratchpad) выносят находки наружу, чтобы пережить давление окна контекста: ссылайтесь на файл, а не на память в контексте. Делегирование субагентам: многословная разведка остаётся в их контексте, главный агент получает структурированные сводки.

Деградация контекста и восстановление по манифесту

При заполнении контекста (80%+) качество припоминания падает — модель ссылается на «типичные паттерны» вместо конкретных классов из фазы 1. При возобновлении после сбоя загружайте манифест состояния: что завершено, что устарело; повторяйте лишь прерванное/изменившееся.

.claude/scratchpad/exploration-state.md

# Состояние исследования

## Ключевые находки
- OrderService (src/orders/service.ts): транзакции через UnitOfWork.
- PaymentGateway (src/payments/gw.ts): идемпотентность по idempotency_key.

## Нерешённые вопросы
- Где валидируется лимит возврата?

## Проанализированные файлы
- src/orders/service.ts
- src/payments/gw.ts

## Фаза сессии: 2 / 4

Anti-patterns

Ловушка	Почему не работает	Верный паттерн
Полагаться на память в контексте за 3-часовую сессию	Контекст молча деградирует — модель ссылается на «типичные паттерны» вместо конкретных классов	Вести scratchpad-файлы; явно ссылаться на них в дальнейших вопросах
Вести многословную разведку в контексте главного агента	Многословный вывод забивает окно, не оставляя места координации	Делегировать разведку субагентам; главный получает сводки
Возобновлять сбойную многоагентную сессию без проверки изменений	Устаревшие результаты, если файлы менялись	Загрузить манифест; повторить лишь изменившееся

Exam traps

Ловушка	Почему не работает	Верный паттерн
Перезапуск сессии теряет ранние находки	Находки не сохранены	Scratchpad сохраняет их
Многословная разведка в контексте координации	Тратит критичное место	Делегировать субагентам
Возобновление без манифеста	Риск рассуждать по устаревшим данным	Загрузить манифест состояния

Практическое задание (T4)

Создать структуру scratchpad: ключевые находки, нерешённые вопросы, проанализированные файлы, фаза сессии.
Писать находки в scratchpad после каждого открытия; после 10 спросить про находку №3 — агент ссылается на scratchpad.
Забить контекст многословным выводом; применить /compact; проверить, что находки из scratchpad сохранились.
Реализовать разведку 3 субагентами с отдельными scratchpad; координатор читает все три при синтезе.
Смоделировать сбой посреди разведки; реализовать восстановление по манифесту; координатор возобновляет лишь прерванных агентов.

Проверка знаний

Деградация при 4-часовом исследовании базы

После 3 часов Claude даёт несогласованные ответы, ссылаясь на «типичный паттерн сервисного слоя» вместо конкретного класса OrderService, разобранного в первый час. Что сделать?

A Claude ошибается; перезапустить и переанализировать
B Деградация контекста; вести scratchpad-файлы, чтобы агенты явно ссылались на них в дальнейших вопросах
C Нужна модель с большим окном контекста
D Использовать /clear для сброса контекста

Насыщение контекста при поиске паттерна

Окно контекста заполнено на 80%+. Разработчик спрашивает: «Проверь, встречается ли этот паттерн ещё где-то в базе?» Ответ Claude становится бессвязным, пропускает два очевидных совпадения. Вероятная причина?

A Слишком высокая temperature
B Деградация контекста — качество припоминания падает при 80%+ заполнения; модель пропускает загруженные ранее паттерны
C Запрос был слишком расплывчат
D Claude не может искать паттерны по файлам без специального инструмента

Полный аудит монорепо (2000 TypeScript-файлов)

Нужно проверить 2000 TypeScript-файлов на устаревший паттерн API. Одна сессия исчерпает контекст. Самая надёжная архитектура?

A Очень большая модель, чтобы вместить все файлы
B Взять выборку 200 файлов и экстраполировать
C Grep для списка кандидатов; отдельные сессии Claude на файл/пачку для полноконтекстного анализа
D Попросить Claude самому выбрать, какие файлы смотреть