sfera/work-protocols.md

# ПРОТОКОЛЫ РАБОТЫ ДЛЯ AI АССИСТЕНТА

## 🎯 ПРОТОКОЛ ДЛЯ ЗАДАЧ СРЕДНЕЙ СЛОЖНОСТИ

### ОПРЕДЕЛЕНИЕ СРЕДНЕЙ СЛОЖНОСТИ:

- Работа с 2-3 файлами
- Изменение логики в 1-2 модулях
- Добавление новых функций без изменения архитектуры
- Задачи, требующие анализа зависимостей

### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:

#### 1. 🔍 **ЭТАП АНАЛИЗА** (STOP & THINK)

```
ПЕРЕД НАЧАЛОМ ЗАДАТЬ СЕБЕ:
□ Какие файлы нужно изучить? (перечислить ВСЕ)
□ Какие правила из rules2.md применимы?
□ Есть ли зависимости между компонентами?
□ Что может пойти не так?
□ Нужны ли уточнения от пользователя?
```

#### 2. 📋 **СОЗДАНИЕ ПЛАНА**

```
□ Разбить задачу на подзадачи (не более 5)
□ Определить порядок выполнения
□ Выявить критические точки
□ Создать TODO список
```

#### 3. 🔄 **ВЫПОЛНЕНИЕ С ПРОВЕРКАМИ**

```
ПОСЛЕ КАЖДОГО ШАГА:
□ Соответствует ли результат rules2.md?
□ Не нарушены ли связи с другими модулями?
□ Работает ли измененный код?
□ Нужно ли обновить documentation?
```

#### 4. ✅ **ФИНАЛЬНАЯ САМОПРОВЕРКА**

```
□ Прочитать изменения еще раз
□ Проверить development-checklist.md
□ Убедиться в полноте решения
□ Задать вопрос: "Что еще я мог упустить?"
```

---

## 🔥 ПРОТОКОЛ ДЛЯ ЗАДАЧ ВЫСОКОЙ СЛОЖНОСТИ

### ОПРЕДЕЛЕНИЕ ВЫСОКОЙ СЛОЖНОСТИ:

- Работа с 4+ файлами
- Изменение архитектуры системы
- Создание новых модулей/компонентов
- Задачи, влияющие на несколько кабинетов
- Изменения в правилах или workflow

### ОБЯЗАТЕЛЬНЫЕ ЭТАПЫ:

#### 1. 🛑 **СТОП! ГЛУБОКИЙ АНАЛИЗ**

```
ОБЯЗАТЕЛЬНЫЕ ВОПРОСЫ ПОЛЬЗОВАТЕЛЮ:
□ Уточнить ВСЕ требования и ожидания
□ Выяснить приоритеты и ограничения
□ Узнать о связях с другими системами
□ Понять критерии успеха
```

#### 2. 🔍 **ИССЛЕДОВАТЕЛЬСКАЯ ФАЗА**

```
□ Изучить ВСЕ связанные файлы параллельно
□ Построить карту зависимостей
□ Найти все правила в rules2.md
□ Выявить потенциальные конфликты
□ Проанализировать влияние на систему
```

#### 3. 📊 **СОЗДАНИЕ ДЕТАЛЬНОГО ПЛАНА**

```
□ Разбить на этапы с промежуточными проверками
□ Определить точки возврата (rollback points)
□ Создать план тестирования
□ Предусмотреть обновление документации
```

#### 4. 🎯 **ПОЭТАПНОЕ ВЫПОЛНЕНИЕ**

```
ПОСЛЕ КАЖДОГО ЭТАПА:
□ Проверка работоспособности
□ Валидация против всех правил
□ Промежуточная демонстрация пользователю
□ Корректировка плана при необходимости
```

#### 5. 🔄 **ИТЕРАТИВНАЯ ПРОВЕРКА**

```
□ Полное тестирование системы
□ Проверка всех затронутых модулей
□ Обновление всей связанной документации
□ Финальное согласование с пользователем
```

---

## ❓ СИСТЕМА ОБЯЗАТЕЛЬНЫХ УТОЧНЕНИЙ

### КОГДА ВСЕГДА СПРАШИВАТЬ:

#### 🔴 **КРИТИЧЕСКИЕ СИТУАЦИИ** (ОБЯЗАТЕЛЬНО):

- Обнаружил противоречие в правилах
- Задача может нарушить архитектуру системы
- Неясно как применить правило к конкретной ситуации
- Есть несколько способов решения с разными последствиями
- Изменения затрагивают критические бизнес-процессы

#### 🟡 **ВАЖНЫЕ СИТУАЦИИ** (РЕКОМЕНДУЕТСЯ):

- Задача требует создания новых типов данных
- Нужно изменить существующий workflow
- Есть сомнения в интерпретации требований
- Решение может повлиять на производительность
- Требуется интеграция с внешними системами

### ФОРМАТ УТОЧНЯЮЩИХ ВОПРОСОВ:

```
🎯 КОНТЕКСТ: Что именно я делаю
❓ ВОПРОС: Что конкретно неясно
⚖️ ВАРИАНТЫ: Какие есть альтернативы (если применимо)
⚠️ РИСКИ: Что может пойти не так
💡 ПРЕДЛОЖЕНИЕ: Мой рекомендуемый подход
```

---

## 🛠️ СИСТЕМА САМОПРОВЕРКИ

### ЧЕК-ЛИСТ ПОСЛЕ КАЖДОЙ ЗАДАЧИ:

#### ✅ **СООТВЕТСТВИЕ ПРАВИЛАМ**

```
□ Проверил против rules2.md (ВСЕ применимые разделы)
□ Обновил development-checklist.md если нужно
□ Не нарушил критические запреты
□ Соблюдены принципы ТОВАР ≠ ПРОДУКТ
□ Workflow статусы корректны
```

#### ✅ **ТЕХНИЧЕСКОЕ КАЧЕСТВО**

```
□ Код следует принципам SOLID
□ Добавлены необходимые проверки и валидации
□ Обработаны ошибки
□ Производительность не пострадала
□ Безопасность данных соблюдена
```

#### ✅ **ПОЛНОТА РЕШЕНИЯ**

```
□ Решены ВСЕ аспекты задачи
□ Обновлена документация
□ Проверены связанные компоненты
□ Нет "технических долгов"
□ Готово к production
```

#### ✅ **КОММУНИКАЦИЯ**

```
□ Объяснил что сделал и почему
□ Указал на важные изменения
□ Предупредил о потенциальных рисках
□ Дал рекомендации по дальнейшим действиям
```

---

## 🎖️ ДОПОЛНИТЕЛЬНЫЕ РЕКОМЕНДАЦИИ

### ДЛЯ ПОЛЬЗОВАТЕЛЯ:

1. **📋 Создавайте подробные задачи** - чем больше контекста, тем лучше результат
2. **🎯 Указывайте приоритеты** - что критично, а что можно отложить
3. **⚠️ Предупреждайте об ограничениях** - технических, временных, бизнесовых
4. **🔄 Давайте обратную связь** - что работает хорошо, что нужно улучшить

### ДЛЯ МЕНЯ:

1. **🛑 Принцип "Стоп и подумай"** перед каждой сложной задачей
2. **📊 Параллельный сбор информации** вместо последовательного
3. **❓ Активное уточнение** при малейших сомнениях
4. **🔄 Итеративная проверка** на каждом этапе
5. **📝 Документирование процесса** для улучшения в будущем

---

## 🚀 АКТИВАЦИЯ ПРОТОКОЛОВ

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

**КРИТЕРИЙ УСПЕХА**: Количество пропущенных важных деталей = 0