# ПРОТОКОЛЫ РАБОТЫ ДЛЯ 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