Перенос контекста

# Промпт для сохранения и переноса контекста

[ для AGENT.MD пропусти `## SECTION`, если он НЕПРИМЕНИМ ]

Создай всеобъемлющий артефакт контекста, сохраняющий весь контекст разговора, прогресс, решения и структуры проекта для бесшовного продолжения работы между сессиями ИИ, платформами или агентами. Этот артефакт служит «флешкой контекста», позволяющей любому ИИ сразу понять и продолжить работу без повторов или потери контекста.

## Основные цели

Зафиксируй и структурируй все контекстные элементы текущей сессии, чтобы обеспечить:
1. **Непрерывность сессии** — возобновление разговоров на разных ИИ-платформах без повторных объяснений.
2. **Передачу агенту** — передачу незавершённых задач новым агентам с полной документацией прогресса.
3. **Перенос проекта** — воспроизведение всей культуры проекта, рабочих процессов и структур управления.

## Категории содержимого для сохранения

### Контекст разговора
- Первоначальные требования и развивающиеся пользовательские истории.
- Идеи, возникшие в ходе мозговых штурмов.
- Принятые решения с полными цепочками обоснования.
- Достигнутые договорённости и статус их проверки.
- Предложения и рекомендации с подтверждающим контекстом.
- Принятые допущения и их текущий статус.
- Ключевые выводы и прорывные моменты.
- Критически важные положения, служащие структурной основой.

### Документация прогресса
- Текущее состояние всех направлений работы.
- Выполненные задачи и подготовленные результаты.
- Ожидающие выполнения пункты и следующие шаги.
- Возникшие блокеры со стратегиями их смягчения.
- Достигнутые ограничения частоты запросов и обходные решения.
- Хронология значимых этапов.

### Архитектура проекта, когда применимо
- Методология и этапы жизненного цикла разработки ПО — SDLC.
- Экосистема агентов: основные агенты, субагенты, соседние агенты, агенты-наблюдатели.
- Правила, политики управления и стратегии.
- Структуры репозиториев: рабочие процессы .github, шаблоны.
- Повторно используемые формы промптов: декомпозиция эпиков, PRD, архитектурные планы, проектирование системы.
- Принятые шаблоны: форматы коммитов, промпты памяти, структуры журналов.
- Иерархия инструкций: варианты на уровне проекта, спринта и эпика.
- Конфигурации CI/CD: тестирование, форматирование, извлечение коммитов.
- Многоагентная оркестрация: цепочки промптов, распараллеливание, агенты-маршрутизаторы.
- Стандарты форматов результата и их варианты.

### Правила и протоколы
- Установленные рекомендации с определением области действия.
- Дополнительные инструкции, добавленные во время сессии.
- Заданные ограничения и границы.
- Стандарты качества и критерии приёмки.
- Механизмы согласования, удерживающие работу в нужном направлении.

# Шаги

1. **Просмотри историю разговора** — изучи всю ветку или сессию, все взаимодействия и контекст.
2. **Извлеки основные элементы** — определи и классифицируй информацию по категориям содержимого выше.
3. **Задокументируй состояние прогресса** — зафиксируй, что завершено, выполняется и ожидает выполнения.
4. **Сохрани цепочки решений** — включи обоснование всех значимых выборов.
5. **Обеспечь переносимость структуры** — организуй материал в универсально интерпретируемом формате.
6. **Добавь инструкции по передаче** — включи явные указания для следующего ИИ, агента или сессии.

# Формат результата

Создай структурированный документ Markdown со следующими разделами:

```
# АРТЕФАКТ КОНТЕКСТА: [Session/Project Title]
**Создан**: [Date/Time]
**Исходная платформа**: [AI Platform Name]
**Приоритет продолжения**: [Critical/High/Medium/Low]

## ОБЗОР СЕССИИ
[2-3 sentence summary of primary goals and current state]

## ОСНОВНОЙ КОНТЕКСТ
### Исходные требования
[Initial user requests and goals]

### Развитие и решения
[Key decisions made, with rationale - bulleted list]

### Текущий прогресс
- Завершено: [List]
- Выполняется: [List with % complete]
- Ожидает выполнения: [List]
- Заблокировано: [List with blockers and mitigations]

## БАЗА ЗНАНИЙ
### Ключевые выводы и договорённости
[Critical discoveries and consensus points]

### Установленные правила и протоколы
[Guidelines, constraints, standards set during session]

### Допущения и проверки
[What's been assumed and verification status]

## АРТЕФАКТЫ И РЕЗУЛЬТАТЫ
[List of files, documents, code created with descriptions]

## СТРУКТУРА ПРОЕКТА, если применимо
### Обзор архитектуры
[SDLC, workflows, repository structure]

### Экосистема агентов
[Description of agents, their roles, interactions]

### Повторно используемые компоненты
[Prompt templates, workflows, automation scripts]

### Управление и стандарты
[Instructions hierarchy, conventional patterns, quality gates]

## ИНСТРУКЦИИ ПО ПЕРЕДАЧЕ
### Для следующей сессии или агента
[Explicit steps to continue work]

### Контекст, который следует подчеркнуть
[What the next AI must understand immediately]

### Возможные трудности
[Known issues and recommended approaches]

## ЗАПРОС ДЛЯ ПРОДОЛЖЕНИЯ
[Suggested prompt for next AI: "Given this context artifact, please continue by..."]
```

# Примеры

**Пример 1: непрерывность сессии — передача мозгового штурма**

Вход: «Мы уже 2 часа обсуждаем идеи мобильного приложения. Мне нужно перейти на Claude. Создай артефакт контекста».

Выход:
```
# АРТЕФАКТ КОНТЕКСТА: планирование мобильного приложения FitTrack
**Создан**: 2026-01-07 14:30
**Исходная платформа**: Google Gemini
**Приоритет продолжения**: высокий

## ОБЗОР СЕССИИ
Обсудили идеи мобильного приложения для отслеживания физической активности для занятых специалистов. Выбрали минималистичный дизайн с ИИ-тренером. Готовы к этапу технической архитектуры.

## ОСНОВНОЙ КОНТЕКСТ
### Исходные требования
- Целевые пользователи: работающие специалисты 25–40 лет с ограниченным временем на спортзал.
- Обязательна синхронизация с Apple Watch и Fitbit.
- Бюджет: $50 тыс. на MVP.
- Срок: 3 месяца до запуска.

### Развитие и решения
- ✓ Название: «FitTrack Pro» (отклонены: «QuickFit», «PowerHour»).
- ✓ Основная функция: 15-минутные тренировки, персонализированные ИИ, а не типовые планы.
- ✓ Монетизация: Freemium (премиум за $9.99 в месяц).
- ✓ Технологический стек: React Native для одновременной разработки под iOS и Android.

### Текущий прогресс
- Завершено: приоритизация функций, портреты пользователей, модель монетизации.
- Выполняется: пока ничего.
- Ожидает выполнения: техническая архитектура, схема базы данных, проектирование API.
- Заблокировано: ничего.

## БАЗА ЗНАНИЙ
### Ключевые выводы и договорённости
- Пользователи предпочитают «умно и коротко», а не «долго и полно» — краткость является премиальной возможностью.
- ИИ-тренер должен ощущаться как собеседник, а не как набор роботизированных команд.
- Социальные функции отложены до v2, чтобы избежать разрастания объёма работ.

(... далее следует остальная структура)

## ЗАПРОС ДЛЯ ПРОДОЛЖЕНИЯ
«Учитывая этот артефакт контекста по планированию приложения FitTrack Pro, спроектируй техническую архитектуру, включая схему базы данных, конечные точки API и стратегию интеграции сторонних сервисов Apple Watch и Fitbit».
```

**Пример 2: передача агенту — автоматизация, остановленная ограничением частоты запросов**

Вход: «Браузерный агент достиг ограничения частоты запросов при сборе цен конкурентов. Создай документ для передачи».

Выход:
```
# АРТЕФАКТ КОНТЕКСТА: автоматизированный сбор цен конкурентов — не завершён
**Создан**: 2026-01-07 09:15
**Исходная платформа**: Browser Agent v2.1
**Приоритет продолжения**: критический

## ОБЗОР СЕССИИ
Автоматизированный сбор данных с 50 сайтов конкурентов для сравнения цен. До ограничения частоты запросов завершены 32 из 50. Необходимо немедленное продолжение, чтобы уложиться в срок к пятнице.

## ОСНОВНОЙ КОНТЕКСТ
### Исходные требования
- Собрать цены на «беспроводные наушники-вкладыши до $100» с 50 сайтов электронной торговли.
- Извлечь: название товара, цену, рейтинг, количество отзывов.
- Результат: единый CSV для анализа.
- Срок: пятница, 17:00.

### Развитие и решения
- ✓ После первых сбоев на сайтах с большим объёмом JS добавлена логика повторных попыток.
- ✓ Для лучшей совместимости выполнен переход с библиотеки requests на Chrome без графического интерфейса.
- ✓ Между запросами к одному домену введены задержки в 3 секунды.
- ✓ Пользователь добавил инструкцию: «Пропускать сайты, требующие входа».

### Текущий прогресс
- Завершено: успешно собраны данные с 32 из 50 сайтов — 2 847 товаров.
- Выполняется: ничего, работа остановлена ограничением частоты запросов.
- Ожидает выполнения: осталось 18 сайтов — список в разделе «Запрос для продолжения» ниже.
- Заблокировано: ограничение частоты запросов на доменах amazon.com, walmart.com, target.com; нужна пауза 2 часа.

## БАЗА ЗНАНИЙ
### Установленные правила и протоколы
- Без исключений соблюдать robots.txt.
- Не более 1 запроса за 3 секунды на домен.
- Пропускать товары без отзывов — шум в данных.
- Обрабатывать пагинацию максимум до 5 страниц на сайт.

### Трудности и меры смягчения
- Трудность: динамическое ценообразование — цены меняются во время сбора.
  Мера: добавлять временную метку к каждой записи.
- Трудность: антибот-CAPTCHA на 3 сайтах.
  Мера: пользователь одобрил ручной ввод данных для этих 3 сайтов.
- Трудность: ограничение частоты запросов.
  Мера: внедрить экспоненциальное увеличение задержки, менять User-Agent.

## ЗАПРОС ДЛЯ ПРОДОЛЖЕНИЯ
«Продолжи автоматизированный сбор цен. Осталось 18 сайтов: [bestbuy.com, newegg.com, ebay.com...]. Используй существующий CSV 'pricing_data_partial.csv' — 2 847 записей. Для доменов с ограничением частоты запросов нужно ожидание 2 часа. Сначала обрабатывай незаблокированные сайты. Применяй все установленные правила: задержки 3 секунды, пропуск товаров без отзывов, ограничение пагинации 5 страницами. Предоставь итоговый CSV к пятнице, 17:00».
```

**Пример 3: перенос проекта — полная передача культуры**

(Входной контекст: весь репозиторий проекта с SDLC, агентами и управлением.)

Выход: *(Сокращённый пример, показывающий структуру; реальный результат должен быть всеобъемлющим.)*
```
# АРТЕФАКТ КОНТЕКСТА: культура и архитектура проекта «SmartInventory»
**Создан**: 2026-01-07 16:00
**Исходная платформа**: GitHub Copilot + многоагентная система
**Приоритет продолжения**: средний — внедрение нового фреймворка ИИ-агентов

## ОБЗОР СЕССИИ
Корпоративная система управления запасами с культурой разработки на основе ИИ. Необходимо воспроизвести всю структуру проекта, экосистему агентов и управление для новой конфигурации автономных ИИ-агентов.

## СТРУКТУРА ПРОЕКТА
### Подход к SDLC
- Методология: Agile с двухнедельными спринтами.
- Этапы: планирование эпика → разработка → проверка наблюдателем → CI/CD → развёртывание.
- Все действия выполняются с помощью ИИ: генерация кода, тестирование, документация, генерация повествовательных описаний коммитов.

### Экосистема агентов
**Основные агенты:**
- DevAgent: генерация кода и реализация.
- TestAgent: автоматизированное тестирование и обеспечение качества.
- DocAgent: создание и сопровождение документации.

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

**Агенты CI/CD:**
- FormatterAgent: обеспечение соблюдения стиля кода.
- ReflectionAgent: извлекает коммиты → структурированные рефлексии, истории разработки, повествовательные результаты.
- DeployAgent: автоматизированные конвейеры развёртывания.

**Субагенты по функциональным областям:**
- InventorySubAgent, UserAuthSubAgent, ReportingSubAgent

**Оркестрация:**
- Координация нескольких агентов через блокноты .ipynb.
- Шаблоны: цепочки промптов, распараллеливание, агенты-маршрутизаторы.

### Структура репозитория (.github)
```
.github/
├── workflows/
│   ├── epic_breakdown.yml
│   ├── epic_generator.yml
│   ├── prd_template.yml
│   ├── architectural_plan.yml
│   ├── system_design.yml
│   ├── conventional_commit.yml
│   ├── memory_prompt.yml
│   └── log_prompt.yml
├── AGENTS.md (реестр агентов)
├── copilot-instructions.md (правила уровня проекта)
└── sprints/
    ├── sprint_01_instructions.md
    └── epic_variations/
```

### Управление и стандарты
**Иерархия инструкций:**
1. `copilot-instructions.md` — неизменяемые правила всего проекта.
2. Инструкции спринта — временные варианты для каждого спринта.
3. Инструкции эпика — вызовы, привязанные к конкретной цели.

**Принятые шаблоны:**
- Коммиты: `type(scope): description` согласно спецификации Conventional Commits.
- Промпт памяти: шаблон сохранения состояния сессии.
- Промпт журнала: формат структурированного отслеживания действий.

(... разделы продолжаются: повторно используемые компоненты, контрольные точки качества, инструкции по продолжению для воссоздания с новыми ИИ-агентами...)
```

# Примечания

- **Универсальность**: структура должна быть понятна любой ИИ-платформе — ChatGPT, Claude, Gemini и т. д.
- **Полнота и краткость**: соблюдай баланс между всеобъемлющим контекстом и удобством чтения; для глубокой детализации используй вложенные разделы.
- **Контроль версий**: включай временные метки и исходную платформу для отслеживания развития контекста при нескольких передачах.
- **Ориентация на действие**: всегда заканчивай понятным «Запросом для продолжения» — точным промптом для следующего ИИ.
- **Адаптация к масштабу проекта**: при полном переносе проекта, как в случае 3, значительно расширяй раздел «Структура проекта», сохраняя остальные разделы краткими.
- **Документирование неудач**: явно фиксируй, что не сработало и почему; это не позволит следующему ИИ повторять ошибки.
- **Сохранение правил**: если во время сессии устанавливались правила или протоколы, включай контекст того, ПОЧЕМУ они понадобились.
- **Проверка допущений**: для ясности отмечай допущения как «проверено», «ожидает проверки» или «опровергнуто».

- - ДЛЯ GEMINI / GEMINI-CLI / ANTIGRAVITY

Вот сверхкраткие версии:

GEMINI.md
"# ИИ-агент Gemini на разных платформах

workflow/agent/sample.toml
"# Шаблон промпта antigravity


MEMORY.md
"# Память Gemini

**Сессия**: 2026-01-07 | Спринт 01 (осталось 7 дней) | Эпик EPIC-001 (45%)  
**Активно**: TASK-001-03 CRUD API складского учёта (GET/POST готовы, PUT/DELETE ожидают выполнения)  
**Решения**: PostgreSQL + JSONB, RESTful /api/v1/, тестирование pytest  
**Далее**: завершить конечные точки PUT/DELETE, окончательно оформить схему"