Как улучшить инструкцию внешний материалом

• прочитать внешний материал, например https://www.anthropic.com/engineering, выделить блоки которые могут помочь прокачать инструкцию. Записать в _upgrade_instruction новую секцию с рецептами и советами как быть
• применить указанные рецепты на инструкцию
  • Сохранить истоничник рецепта
• обновить эту документацию с полученными уроками

Рецепты из Anthropic Engineering (январь 2026)

Источник: https://www.anthropic.com/engineering

1. Progressive Disclosure — раскрывай постепенно

Из статей: Agent Skills, Context Engineering

• Главное — в начале, детали — по ссылкам или ниже
• Не перегружать контекст сразу всей информацией
• Трёхуровневая структура: метаданные → основной контент → дополнительные файлы

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

2. Just-in-time информация

Из статьи: Effective Context Engineering

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

Применение: [[Ссылка на инструкцию]] вместо копирования текста. Указывать где искать, а не что там написано.

3. Конкретные примеры вместо абстракций

Из статей: Tool Use Examples, Writing tools for agents

• "Примеры — это картины, стоящие тысячи слов"
• Показать формат на реальном случае
• Неоднозначные параметры требуют примеров

Применение: Добавлять блоки Пример: после сложных шагов.

4. Документируй частые ошибки

Из статей: Demystifying Evals, Postmortem

• Собирать реальные провалы из production
• Описывать не только ошибку, но и как её избежать
• Регулярно пополнять на основе новых случаев

Применение: Секция "Частые ошибки" в конце каждой инструкции.

5. Одна задача за раз + прогресс

Из статьи: Effective Harnesses

• Инкрементальный подход: один шаг — одна задача
• Фиксировать прогресс (коммиты, чеклисты)
• Не пытаться сделать всё сразу

Применение: Нумерованные шаги. Чеклист для контроля выполнения.

6. Верификация результата

Из статей: Building agents with Agent SDK, Evals

• Определить чёткие критерии успеха
• Проверка через правила, визуальный осмотр, внешнюю оценку
• Чеклист перед завершением

Применение: Финальная проверка по чеклисту с отчётом по каждому пункту.

7. Семантические названия

Из статьи: Writing tools for agents

• Понятные названия вместо технических ID
• Явные связи между элементами
• Название должно объяснять назначение

Применение: Называть файлы и секции по смыслу действия, а не по техническому формату.

8. Итеративное улучшение

Из статей: Agent Skills, Writing tools

• Анализировать результаты после выполнения
• Фиксировать выученные уроки
• Дополнять инструкцию новыми случаями

Применение: Шаг "проанализировать уроки и дополнить инструкцию" в конце.