Планирование Prometheus: Сбор требований в формате интервью и генерация плана работ
Что вы сможете делать после изучения
- Запускать сессии планирования Prometheus через режим интервью для уточнения требований проекта
- Понимать основной принцип Prometheus "только планирование, без реализации"
- Генерировать высококачественный, безупречный план работ в сотрудничестве с Metis и Momus
- Использовать команду
/start-workдля передачи плана на исполнение Atlas
Ваша текущая ситуация
Представьте: вы даёте AI сложную задачу: "Помоги мне рефакторить систему аутентификации".
Через 5 минут AI начинает писать код. Вы рады, что сэкономили время.
Через 30 минут вы понимаете:
- AI не спросил вас, какую библиотеку аутентификации использовать (JWT? NextAuth? Session?)
- AI сделал много предположений о требованиях (например, "обязательно поддержка OAuth", хотя вам это не нужно)
- Код написан наполовину, направление неправильное, всё переделывать
- При тестировании обнаружилось, что основная логика несовместима с существующей системой
Это типичная проблема "смешения планирования и выполнения": AI начинает работу, не уточнив требования, что приводит к множеству переделок.
Когда использовать Prometheus
Когда использовать
Сценарии применения Prometheus:
- Сложная разработка функций (например, "добавить систему аутентификации пользователей")
- Масштабный рефакторинг (например, "рефакторинг всего уровня доступа к данным")
- Проектирование архитектуры (например, "проектирование микросервисной архитектуры")
- Задачи, требующие строгого контроля качества
Сценарии прямого использования Sisyphus:
- Простое исправление ошибок (например, "исправить опечатку в кнопке входа")
- Ясные небольшие функции (например, "добавить форму с 3 полями ввода")
🎒 Подготовка к началу
Убедитесь, что выполнили следующие настройки:
- [ ] Агент Prometheus включён (включён по умолчанию)
- [ ] Настроен хотя бы один AI Provider (Anthropic, OpenAI и др.)
- [ ] Понимаете базовые концепции агентов (пройдено «Команда AI-агентов: Обзор 10 экспертов»)
Проверка доступности Prometheus:
bash
# Введите в чате OpenCode
@prometheus
# Должны увидеть приветствие Prometheus:
# "Привет, я Prometheus — стратегический консультант. ..."Основная концепция
Основные ограничения идентичности Prometheus
Какая самая важная особенность Prometheus? Он никогда не пишет код.
| Функция | Prometheus | Sisyphus | Atlas |
|---|---|---|---|
| Сбор требований | ✅ | ❌ | ❌ |
| Генерация плана работ | ✅ | ❌ | ❌ |
| Реализация кода | ❌ | ✅ | ✅ (делегирование) |
| Выполнение задач | ❌ | ✅ | ✅ (делегирование) |
Почему это важно?
- Планировщик ≠ Исполнитель: Как и менеджер продукта, который не пишет код, задача Prometheus — "как сделать", а не "сделать"
- Предотвращение предположений: Если бы Prometheus мог писать код, он мог бы "угадывать" при неясных требованиях
- Принуждение к мышлению: Будучи лишён возможности писать код, Prometheus должен уточнить все детали
Трёхэтапный рабочий процесс
mermaid
flowchart LR
A[Ввод требований] --> B[Этап 1: Режим интервью]
B -->|Требования ясны?| C[Этап 2: Генерация плана]
C --> D[Консультация Metis]
D -->|Нужна высокая точность?| E[Цикл валидации Momus]
E -->|План готов| F[Генерация .sisyphus/plans/*.md]
C -->|Не нужна высокая точность| F
F --> G[/start-work выполнение]Обязанности на каждом этапе:
- Этап 1 — Режим интервью: Сбор требований, исследование кодовой базы, непрерывное обновление черновика
- Этап 2 — Генерация плана: Консультация с Metis, генерация полного плана, представление сводки
- Этап 3 — Выполнение: Передача через
/start-workна исполнение Atlas
Давайте попробуем
Шаг 1: Запуск сессии планирования Prometheus
Зачем Запуск Prometheus через ключевые слова или команды для входа в режим интервью.
Действие
Введите в чате OpenCode:
@prometheus помоги спланировать систему аутентификации пользователейВы должны увидеть:
- Подтверждение Prometheus о входе в режим интервью
- Первый вопрос (например, "Какой технологический стек у вашего приложения?")
- Создание чернового файла
.sisyphus/drafts/user-auth.md
Ключевая особенность: Черновой файл
Prometheus непрерывно обновляет файлы в .sisyphus/drafts/. Это его "внешняя память":
- Запись решений каждого обсуждения
- Сохранение исследованных паттернов кода
- Отметка чётких границ (ВКЛЮЧЕНО/ИСКЛЮЧЕНО)
Вы можете в любое время просмотреть черновик, чтобы проверить, правильно ли Prometheus всё понял.
Шаг 2: Отвечайте на вопросы, позвольте Prometheus собрать контекст
Зачем Prometheus должен "понять" ваш проект, чтобы сгенерировать выполнимый план. Он не угадывает, а получает обоснование через исследование кодовой базы и изучение лучших практик.
Действие
Отвечайте на вопросы Prometheus, например:
Ввод пользователя:
Моё приложение — Next.js 14, App Router, сейчас нет аутентификации.
Хочу поддержку входа по email/паролю и GitHub OAuth.Что сделает Prometheus:
- Использует агента
exploreдля анализа существующей структуры кода - Использует агента
librarianдля поиска лучших практик аутентификации - Обновляет разделы "Requirements" и "Technical Decisions" в черновом файле
Вы должны увидеть:
Я запустил агента исследования для анализа структуры вашего проекта...
1. explore: Поиск существующих паттернов сессий
2. librarian: Поиск лучших практик NextAuth
Дождитесь возврата результатов, и я продолжу задавать вопросы.Шаг 3: Просмотр чернового файла (опционально)
Зачем Черновик — это "внешняя память" Prometheus, вы можете в любое время проверить, правильно ли он всё понял.
Действие
bash
# Просмотр содержимого черновика в терминале
cat .sisyphus/drafts/user-auth.mdВы должны увидеть примерно следующее:
markdown
# Draft: user-auth
## Requirements (подтверждено)
- Технологический стек: Next.js 14, App Router
- Способы аутентификации: email/пароль + GitHub OAuth
- Текущее состояние: нет реализации аутентификации
## Technical Decisions
- Нет решений
## Research Findings
- Агент исследования запущен...Шаг 4: Продолжайте отвечать, пока требования не станут ясными
Зачем У Prometheus есть "Clearance Checklist", и только когда все пункты отмечены, происходит автоматический переход к генерации плана.
Критерии оценки Prometheus:
CLEARANCE CHECKLIST (ВСЕ должны быть YES для автоматического перехода):
□ Ясна ли основная цель?
□ Определены ли границы (ВКЛЮЧЕНО/ИСКЛЮЧЕНО)?
□ Нет ли оставшихся ключевых двусмысленностей?
□ Определён ли технический подход?
□ Подтверждена ли стратегия тестирования (TDD/ручное)?
□ Нет ли блокирующих проблем?Действие
Продолжайте отвечать на вопросы Prometheus, пока он не скажет:
Все требования ясны. Консультируюсь с Metis и генерирую план...Вы должны увидеть:
- Вызов Prometheus агента Metis
- Анализ Metis возможных упущений
- Корректировку понимания Prometheus на основе обратной связи от Metis
Шаг 5: Просмотр сгенерированного плана
Зачем Файл плана — это конечный результат Prometheus, содержащий все задачи, зависимости и критерии приёмки.
Действие
bash
# Просмотр сгенерированного плана
cat .sisyphus/plans/user-auth.mdВы должны увидеть полную структуру:
markdown
# User Authentication System
## Context
[Описание исходных требований]
[Резюме интервью]
[Результаты анализа Metis]
## Work Objectives
- Основная цель: реализовать вход по email/паролю и GitHub OAuth
- Конкретные результаты: страница входа, API endpoints, управление сессиями
- Определение завершения: пользователи могут входить и получать доступ к защищённым маршрутам
## Verification Strategy
- Инфраструктура существует: YES
- Пользователь хочет тесты: TDD
- Фреймворк: vitest
## TODOs
- [ ] 1. Установить NextAuth.js и настроить
- References:
- https://next-auth.js.org/getting-started/installation
- Acceptance Criteria:
- [ ] npm run test → PASS (1 test)
- [ ] 2. Создать API route [...nextauth]/route.ts
- References:
- src/lib/session.ts:10-45 - существующие паттерны сессий
- Acceptance Criteria:
- [ ] curl http://localhost:3000/api/auth/... → 200
- [ ] 3. Реализовать UI страницы входа
- References:
- src/app/login/page.tsx - существующая структура страницы входа
- Acceptance Criteria:
- [ ] Playwright проверка: видна форма входа
- [ ] Скриншот сохранён в .sisyphus/evidence/
...Шаг 6: Выбор способа выполнения
Зачем Prometheus предложит вам два варианта: быстрый старт или проверка с высокой точностью.
Отображение Prometheus (с использованием инструмента Question):
## План сгенерирован: user-auth
**Принятые ключевые решения:**
- Использование NextAuth.js (хорошо интегрируется с Next.js App Router)
- Провайдер GitHub OAuth + email/пароль
**Область:**
- ВКЛЮЧЕНО: функционал входа, управление сессиями, защита маршрутов
- ИСКЛЮЧЕНО: функция регистрации, сброс пароля, редактирование профиля пользователя
**Применённые ограничения:**
- Должно соответствовать существующим паттернам сессий
- Не изменять основную бизнес-логику
План сохранён в: `.sisyphus/plans/user-auth.md`
---
**Следующий шаг**
Как продолжить?
1. **Start Work**: Выполнить /start-work. План выглядит надёжным.
2. **High Accuracy Review**: Попросить Momus строго проверить каждую деталь. Увеличивает цикл проверки, но гарантирует точность.Действие
Выберите один из вариантов (нажмите кнопку в OpenCode или введите опцию).
Если выберете "Start Work":
- Prometheus удалит черновой файл
- Подскажет запустить
/start-work
Если выберете "High Accuracy Review":
- Prometheus войдёт в цикл Momus
- Постоянно исправляет отзывы, пока Momus не скажет "OKAY"
- Затем подскажет запустить
/start-work
Шаг 7: Выполнение плана
Зачем План — это выход Prometheus, выполнение — обязанность Atlas.
Действие
bash
# Введите в OpenCode
/start-workВы должны увидеть:
- Atlas читает
.sisyphus/plans/user-auth.md - Создание файла состояния
boulder.json - Последовательное выполнение каждой задачи TODO
- Делегирование задач специализированным агентам (например, UI-работа делегируется Frontend)
Проверочная точка ✅
- Файл
boulder.jsonсоздан - Atlas начал выполнять задачу 1
- После завершения каждой задачи статус обновляется
Предупреждения о подводных камнях
Подводный камень 1: Требования сказаны наполовину, но уже хотят план
Проблема:
Пользователь: @prometheus сделай систему аутентификации
Пользователь: Не спрашивай пока так много, сразу генерируй планПоследствия: План полон предположений, при выполнении нужно постоянно вносить изменения.
Правильный подход:
Пользователь: @prometheus сделай систему аутентификации
Prometheus: Какой технологический стек у вашего приложения? Сейчас есть аутентификация?
Пользователь: Next.js 14, App Router, нет аутентификации
Prometheus: Какие способы входа нужно поддерживать?
Пользователь: Email/пароль + GitHub OAuth
...
(Продолжайте отвечать, пока Prometheus не перейдёт автоматически)Запомните этот принцип
Время на планирование ≠ Потраченное время
- Потратив 5 минут на уточнение требований, можно сэкономить 2 часа на переделки
- Режим интервью Prometheus "экономит" деньги вашего будущего я
Подводный камень 2: Не просматривать черновой файл
Проблема: Prometheus записывает в черновик много решений и границ, вы не смотрите и сразу просите сгенерировать план.
Последствия:
- План содержит ошибочное понимание
- При выполнении обнаруживается "Как я не сказал, что это нужно?"
Правильный подход:
1. После запуска планирования постоянно следите за файлами в .sisyphus/drafts/
2. При обнаружении недопонимания немедленно исправьте: "Нет, мне не нужен OAuth, а простой JWT"
3. Продолжайте после исправленияПодводный камень 3: Генерация плана по частям
Проблема:
Пользователь: Этот проект слишком большой, давайте сначала спланируем первую фазуПоследствия:
- Контекст между первой и второй фазой разрывается
- Архитектурные решения несогласованы
- Требования упускаются в нескольких сессиях
Правильный подход:
✅ Принцип единого плана: Какой бы большой ни была задача, все TODO в одном файле .mdПочему?
- Prometheus и Atlas могут обрабатывать большие планы
- Единый план гарантирует консистентность архитектуры
- Избегает фрагментации контекста
Подводный камень 4: Забыть роль Metis
Проблема:
Пользователь: Требования сказаны, быстро генерируй план
Prometheus: (генерирует напрямую, пропуская Metis)Последствия:
- В плане могут отсутствовать ключевые границы
- Нет чёткого "Must NOT Have" для определения исключённой области
- При выполнении появляется AI slop (чрезмерное проектирование)
Правильный подход:
✅ Консультация с Metis обязательна, не торопитесьЧто сделает Metis?
- Выявит вопросы, которые Prometheus должен был задать, но не задал
- Предложит границы, которые нужно уточнить
- Предотвратит чрезмерную инженерию AI
Подводный камень 5: Игнорировать решение о стратегии тестирования
Проблема: Prometheus спрашивает "Нужны ли тесты?", вы говорите "Без разницы" или пропускаете.
Последствия:
- Если есть инфраструктура тестирования, но не используется TDD, упускаете возможность
- Если тестов нет, и нет подробных шагов ручной проверки, высокая вероятность провала выполнения
Правильный подход:
Prometheus: Я вижу у вас фреймворк тестирования vitest. Должна ли работа включать тесты?
Пользователь: YES (TDD)Влияние:
- Prometheus структурирует каждую задачу как: RED → GREEN → REFACTOR
- Acceptance Criteria TODO будут явно включать команды тестирования
- Atlas при выполнении будет работать по процессу TDD
Резюме урока
Основная ценность Prometheus:
- Разделение планирования и выполнения: Через принудительное ограничение "не писать код", обеспечивается ясность требований
- Режим интервью: Постоянные вопросы, исследование кодовой базы, обновление черновиков
- Гарантия качества: Консультация Metis, валидация Momus, принцип единого плана
Типичный рабочий процесс:
- Введите
@prometheus [требование]для запуска планирования - Отвечайте на вопросы, просматривайте черновики
.sisyphus/drafts/ - Дождитесь автоматического перехода Prometheus (Clearance Checklist полностью отмечен)
- Просмотрите сгенерированный
.sisyphus/plans/{name}.md - Выберите "Start Work" или "High Accuracy Review"
- Запустите
/start-workдля передачи на исполнение Atlas
Лучшие практики:
- Тратите время на понимание требований, не торопитесь получить план
- Постоянно просматривайте черновые файлы, своевременно исправляйте недопонимание
- Следуйте принципу единого плана, не разделяйте большие задачи
- Определяйте стратегию тестирования, влияющую на структуру всего плана
Анонс следующего урока
На следующем уроке мы изучим Фоновые параллельные задачи: Работа как команда.
Вы узнаете:
- Как заставить несколько агентов работать параллельно для значительного повышения эффективности
- Настройку ограничений параллелизма, чтобы избежать ограничений API
- Управление фоновыми задачами, получение результатов и отмена операций
- Координацию нескольких экспертных агентов как "реальную команду"
Приложение: Ссылка на исходный код
Нажмите, чтобы развернуть и посмотреть расположение исходного кода
Время обновления: 2026-01-26
| Функция | Путь файла | Номера строк |
|---|---|---|
| Системный промпт Prometheus | src/agents/prometheus-prompt.ts | 19-1184 |
| Конфигурация прав Prometheus | src/agents/prometheus-prompt.ts | 1187-1197 |
| Агент Metis | src/agents/metis.ts | - |
| Агент Momus | src/agents/momus.ts | - |
| Документ по оркестрации | docs/orchestration-guide.md | 67-90 |
Основные константы:
PROMETHEUS_SYSTEM_PROMPT: Полный системный промпт, определяющий личность, рабочий процесс и ограничения Prometheus
Ключевые функции/инструменты:
PROMETHEUS_PERMISSION: Определяет разрешения на использование инструментов Prometheus (разрешено редактирование только файлов .md)
Бизнес-правила:
- Режим по умолчанию Prometheus: INTERVIEW MODE (режим интервью)
- Условие автоматического перехода: Clearance Checklist полностью YES
- Консультация Metis: обязательная, выполняется перед генерацией плана
- Цикл Momus: опциональный режим высокой точности, цикл пока не будет "OKAY"
- Принцип единого плана: какая бы большая ни была задача, все TODO в одном файле
.md - Управление черновиками: непрерывное обновление
.sisyphus/drafts/{name}.md, удаление после завершения плана