8.7 KiB
8.7 KiB
ПРОТОКОЛЫ РАБОТЫ ДЛЯ 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
✅ КОММУНИКАЦИЯ
□ Объяснил что сделал и почему
□ Указал на важные изменения
□ Предупредил о потенциальных рисках
□ Дал рекомендации по дальнейшим действиям
🎖️ ДОПОЛНИТЕЛЬНЫЕ РЕКОМЕНДАЦИИ
ДЛЯ ПОЛЬЗОВАТЕЛЯ:
- 📋 Создавайте подробные задачи - чем больше контекста, тем лучше результат
- 🎯 Указывайте приоритеты - что критично, а что можно отложить
- ⚠️ Предупреждайте об ограничениях - технических, временных, бизнесовых
- 🔄 Давайте обратную связь - что работает хорошо, что нужно улучшить
ДЛЯ МЕНЯ:
- 🛑 Принцип "Стоп и подумай" перед каждой сложной задачей
- 📊 Параллельный сбор информации вместо последовательного
- ❓ Активное уточнение при малейших сомнениях
- 🔄 Итеративная проверка на каждом этапе
- 📝 Документирование процесса для улучшения в будущем
🚀 АКТИВАЦИЯ ПРОТОКОЛОВ
Данные протоколы активируются автоматически на основе сложности задачи. Я буду следовать им при каждой работе с проектом Sfera.
КРИТЕРИЙ УСПЕХА: Количество пропущенных важных деталей = 0