Как работать с документом
Этот документ — не «ТЗ для чтения», а рабочий сценарий: вы даёте модели сырой текст, она задаёт вопросы и предлагает варианты, вы фиксируете решения. Всё остальное (архитектура, беклог, фазы) — следствие этих решений.
Сценарий за 20 минут
- Забросьте текст в чат. Не редактируйте и не сокращайте: модели нужны формулировки заказчика, включая противоречия.
- Попросите вопросы, а не решение. Модель обязана выбрать вопросы из банка §54 (с ID) и для каждого дать 2–4 варианта ответа с последствиями.
- Ответьте вариантом. «Обсудим потом» — не ответ. Либо выбор
варианта, либо явное «не знаю, нужен research» (тогда вопрос уходит в Q-статус
research). - Зафиксируйте и проверьте гейт. Ответы →
DEC, незакрытые →Q. Если гейт D1–D3 не проходит, следующий шаг не начинается.
Примеры промптов
Промпт 1 · первичный разбор сырого текста
Ты архитектор продукта Project Navigator.
Ниже — сырой текст о проекте. Сделай только четыре вещи:
1) Выпиши, что уже известно (факты) и что неизвестно (пробелы) — двумя списками.
2) Выбери 3–5 вопросов из банка §54, которые блокируют следующий шаг. Укажи ID (A/F/B/O/D).
3) Для каждого вопроса: 2–4 варианта ответа, влияние на архитектуру, сроки и стоимость,
связи с другими вопросами (← зависит / → блокирует).
4) Ничего не решай за меня и не пиши код. Если данных нет — так и напиши.
Текст:
<вставить бриф / письмо / описание объекта>
Промпт 2 · добор вопросов и вариантов
Продолжаем проект PN.
Уже решено: <DEC-... списком>. Открыто: <ID вопросов>.
Что нужно:
1) Какие вопросы из §54 теперь закрыты, какие появились как следствие, какие стали критичными.
2) Для трёх самых критичных — варианты ответа, цена каждого и рекомендация
с условием, при котором она окажется неверной.
3) Список того, что нужно исследовать, чтобы снять оставшиеся вопросы (research-задачи).
Промпт 3 · фиксация решений и переход к беклогу
На основе решений <DEC-...> сформируй:
1) DEC-записи в YAML: decision, context, alternatives, reason, owner, status: proposed.
2) Чек-лист гейта (D1 / D3), который теперь можно пройти, — с отметками pass/fail.
3) 5–7 задач беклога: секция «Проектирование» / «Разработка» / «Исследования»,
для каждой — выход, зависимость и гейт.
Не выдумывай факты: неизвестное помечай [предположение] или выноси в вопрос.
Промпт 4 · проверка на прочность (по желанию)
Выбран вариант: <вариант>. Дай три аргумента против него и перечисли условия,
при которых он сработает. Затем скажи, какой факт сильнее всего изменит решение.
DEC. Полный шаблон обсуждения одного вопроса — в
§54.6.Маршрут по документу
| Задача | Куда смотреть |
|---|---|
| Понять продукт и домен | бриф, §2–§5, §26–§27 |
| Работать с вопросами и решениями | §54, §54.6 |
| Понять требования по согласованиям | §54.5, Domain Pack (§27) |
| Проектировать систему | §8–§16, §18.1 |
| Планировать работу | §24 (беклог), §25, фазы §32–§41 |
| Эксплуатировать | §18.2, §28, метрики §43 |
Краткий бриф: домен, задача и варианты системы
Project Navigator (PN) — ассистент, который ведёт проект по всему инвестиционно-строительному циклу: от идеи инвестора вложить средства до эксплуатации объекта. Первый прикладной сценарий — согласование проектной и рабочей документации с эксплуатирующими организациями Москвы: сегодня это один из самых трудоёмких и плохо прогнозируемых процессов цикла.
Предметная задача
Как это происходит сейчас
Согласование ПД/РД с Мосводоканалом, Мосводостоком, МОЭК, ГУП «Московский метрополитен», Россетями, Моссветом, Мосгазом идёт параллельно, по разным правилам и в разных форматах. Проектировщик не видит общей картины: какие пакеты нужны, в какой последовательности, что уже подано и что «висит».
Корень проблемы
Нет единого источника «организация → документы → нормы → сроки». Процесс не выстроен и не контролируется по датам, а значительная часть отказов формальна: в пакете не хватает одного документа или он оформлен не по регламенту. Повторная подача съедает недели.
Что даёт PN
Прозрачный маршрут согласований: чек-лист документов под каждую организацию, ссылки на СП/ГОСТ/регламенты, прогноз срока по каждому согласованию и по циклу, напоминания о критичных датах, разбор причин отказа и план их снятия.
Что должен делать помощник
- Пакет документов по организации. Для каждой из семи организаций — что входит в пакет, в каком виде, куда и в какой последовательности подаётся; чего обычно не хватает.
- Нормативно-технические требования. СП, ГОСТ, отраслевые регламенты и внутренние требования сетевых организаций — с привязкой к конкретному разделу проекта и со ссылкой на первоисточник.
- Прогноз сроков. Ориентировочная длительность каждого согласования и всего цикла с учётом параллельности; отдельно — что критично для сроков стройки.
- Контроль и напоминания. Статусы по каждому согласованию, предупреждения о приближении сроков, причины отказов и что сделать, чтобы повторная подача прошла.
- Память проекта. История решений и замечаний по объекту, чтобы следующая очередь или похожий объект не начинали с нуля.
Место в цикле ИСП
Идея инвестора → земельные вопросы → исходно-разрешительная документация → инженерные изыскания → проектирование → согласования с эксплуатирующими организациями → экспертиза → строительство → ввод в эксплуатацию → эксплуатация. Согласования — первый модуль: он даёт быстрый, измеримый эффект (срок и доля отказов), после чего тот же механизм контекста и гейтов распространяется на остальные стадии.
Варианты системы
Вариант A · Orchestrator
PN как meta-agent над 01.lab. Справочник «организация → документы → нормы», прогноз сроков и промпты для существующих LLM: минимум собственной инфраструктуры. Быстрый способ проверить ценность на одном проектировщике.
Вариант B · AI Workbench
PN как отдельное web-приложение. Карточка объекта, чек-листы по организациям, таймлайн согласований, статусы и напоминания. Основной кандидат для MVP: процесс виден целиком, а не по частям.
Вариант C · Platform / SaaS
PN как платформа. Multi-user для проектных бюро и застройщиков, domain packs по городам и организациям, тарифы, API. 01.lab остаётся методологическим ядром, домен — продаваемым пакетом.
Project Navigator — проектирование, настройка и развёртывание агента
54. Вопросы для принятия архитектурных, функциональных, бизнес-, организационных и доменных решений
Банк вопросов — рабочий интерфейс между заказчиком и PN: каждый вопрос
имеет варианты ответа, влияние на проект и
связи с другими вопросами. Пока вопрос не отвечен, связанные
части архитектуры и MVP остаются в статусе ⚠️ draft.
Раздел вынесен в начало как рабочая панель: сначала вопросы и решения, затем
модель, реализация и метрики.
Как читать таблицы
- A — технический/архитектурный, F — функциональный, B — бизнес, O — организационный/инфраструктурный, D — доменный. Нумерация сквозная (1–82).
- Варианты ответа — допустимые решения; ответ можно комбинировать,
но выбранный вариант должен быть зафиксирован как
DECв Context. - Влияние — что изменится в документе (раздел, артефакт, объём MVP).
- Связи —
←от чего зависит,→что блокирует.
Волны снятия вопросов
| Волна | Вопросы | Что определяется |
|---|---|---|
| Волна 0 · организационная сразу, параллельно | O01–O05, O08, O09 | аккаунты LLM и оплата, хостинг и домены, репозиторий, доступы, кто в команде |
| Волна 1 · до первой строки кода 1–2 недели | B04, B12, B23, B06, B01, B19, F01, F02, F13, A01, A02, A03 | продукт или инструмент, контур развёртывания, границы MVP, где работает агент, LLM |
| Волна 2 · доменная параллельно discovery | D01–D06, D09, D12 | первый домен, нормативная база, первоисточники, артефакты, уровень детализации |
| Волна 2.5 · функциональная 2–4 недели | F03–F12, F14–F18, A04–A10 | модель Context, стадии и гейты, HITL, домен-пак, интерфейс |
| Волна 3 · после первого пилота по результатам | B07–B16, B20–B22, A07–A09, F15 | тарифы и упаковка, вертикали, PDF/OCR, Gantt, research-объёмы |
Правило: вопрос переводится в research только когда
известен его «владелец» и цена ошибки. Иначе он остаётся открытым и не тратит
LLM-бюджет.
Карта зависимостей (ключевые кластеры)
| Кластер | Корневой вопрос | Зависимые вопросы |
|---|---|---|
| Продукт или инструмент | B04 | A01, A11, F16, B07, B12, B23 |
| Контур развёртывания | B12 · B13 | A01, A04, A02 |
| Границы MVP | B19 | F02, F13, A07, A09 |
| Модель Context | A04 | F06, F07, F12, F17 |
| Human-in-the-loop | A10 | A05, A06, F10 |
| LLM и стоимость | A02 · A03 | A08, F04, B11, B21 |
| Вертикали | B06, B14–B16 | F14, F15 |
| Валидация ценности | B17 | B18 → B20 → B21 |
| Доступы и деньги на API | O01 · O02 | A02, A03, B21 |
| Инфраструктура | O03 | A01, A04, O04–O08, B12 |
| Команда и подрядчики | O09 · O10 | O11, B21, сроки MVP |
| Юр. обвязка, продажи, поддержка | O11–O13 | B07, B08, B17, B23 |
| Данные и приватность | O14 | A04, B12, B13, O08 |
| Домен и нормативка | D03 | D04, D09, D13 |
| Доменная экспертиза | D02 | D08, D12, D14 |
| Домен в продукте | D01 · D06 | D05, D07, D10, B19 |
54.1. Технические и архитектурные вопросы 12
| ID | Вопрос | Варианты ответа | Влияние на проект | Связи |
|---|---|---|---|---|
| A01 | Где должен работать PN? | OpenCode-агент (скилл/CLI)отдельный сервис с APIweb-appdesktopкомбинация | Определяет наличие UI, API и авторизации, стек и состав экранов §19. | ← B04 · B12 · B23; → A03 · A04 · F02 |
| A02 | Какая LLM основная и какие дополнительные? | одна модель (OpenAI / Anthropic / Gemini)роутинг моделей по ролямлокальная / self-hostedгибрид | Качество вопросов и стоимость; активирует §13 мультимодельный режим. | ← B11 · B13; → A03 · S05 |
| A03 | PN сам вызывает LLM API или только генерирует промпты? | только промпты для внешних агентовпрямые вызовы через проксигибрид (MVP на промптах) | Биллинг, квоты, хранение ключей, задержки; включает Research Engine §12. | ← A01 · A02 · B11; → A08 · F04 |
| A04 | Где и в каком виде хранится Project Context? | файлы в git (markdown/yaml)SQLitePostgresobject storageгибрид | Модель данных §21, event-driven §20, версии, многопользовательский режим. | ← B12 · B13; → F06 · F07 · F17 |
| A05 | Нужна ли автоматическая инициализация Git-репозитория? | нет, вручнуюпо подтверждению человекаавтоматически при регистрации проекта | Phase 9 и DoD; риск необратимых действий в чужом проекте. | ← A10; → S16 |
| A06 | Нужен ли авто-deploy или только генерация проекта? | нет, только артефактыгенерировать проект + инструкцииdeploy по подтверждениюполный deploy | Границы Phase 10 и матрицы §28, требования к окружениям. | ← A10 · A11; → S17 |
| A07 | Нужна ли работа с PDF / DOCX / XLSX / изображениями в MVP? | неттолько чтение/парсингполный ingest с OCR | Объём MVP, качество FACT, стоимость парсеров. | ← F01 · F05; → S05 · S07 |
| A08 | Нужен ли web-research уже в первой версии? | нет, только ручные источникиограниченный allow-list источниковполноценный research | Объём Research Engine, стоимость и юридические риски. | ← A03 · F04 · B21; → F05 |
| A09 | Насколько Gantt обязателен для MVP? | только Flow + Context Mapупрощённый Ganttполноценный Gantt | Объём UI §10.2 и приоритет экранов §19. | ← F02 · B19; → S13 |
| A10 | Какие действия PN делает только после подтверждения человека? | минимальный список (git init, deploy)расширенный (публикация, внешние API, удаление)все изменения Context | Матрица §28: безопасность против скорости итераций. | ← F06; → A05 · A06 · F10 |
| A11 | Где граница между PN и обычным coding-agent? | PN — контекст и решенияPN + генерация промптовPN запускает coding-agent | Ключевой ответ для §3 и §57: объём MVP и интеграции. | ← B04 · B05; → A06 · F18 |
| A12 | Какие части 01.lab PN использует напрямую? | конвенции + скилы + шаблонытолько конвенциисвой стек без 01.lab | Зависимости §31, §56, скорость сборки и риск дублирования. | ← A11; → S21 · S22 |
54.2. Функциональные вопросы 18
| ID | Вопрос | Варианты ответа | Влияние на проект | Связи |
|---|---|---|---|---|
| F01 | Какой первый реальный объект станет тестовым кейсом PN? | жилой ЖК в Москвереконструкция зданияобъект инженерной инфраструктурыучебный кейс на реальном объекте | DoD, выбор домен-пака, приоритет скилов. | ← B17 · B19; → F14 |
| F02 | Какие основные сценарии PN должен поддерживать в MVP? | discovery до SDDполный цикл до deployтолько вопросытолько research | Границы MVP §25 и состав экранов §19. | ← A01 · B19; → F09 · F10 · A09 |
| F03 | Должен ли PN сам формировать и приоритизировать вопросы? | да, полностьюполуавтомат (человек подтверждает)нет, вопросы задаёт человек | Ядро Question Engine §8–9, UX экрана 3. | ← A01; → F08 · S04 |
| F04 | Должен ли PN автоматически запускать research по выбранным вопросам? | дапо подтверждениюнет | §12 и стоимость: research — главный генератор расходов на LLM. | ← A03 · A08; → F05 |
| F05 | Как результаты research попадают в Project Context? | авто-FACT с provenanceпредложения на ревьюручной ввод | Уровень доверия к контексту, §6.5, UX экрана 5. | ← F04 · A07; → F06 · S07 |
| F06 | Может ли человек вручную править и подтверждать факты, решения, требования? | да, любые записитолько подтверждениенет, только агент | HITL, аудит и экран 5; влияет на A10. | ← A04 · F05; → F07 · A10 |
| F07 | Нужна ли история изменений Project Context? | git-версииevent logснимки/снапшотынет | Откат, аудит, §20; стоимость хранения. | ← A04 · F06; → F12 |
| F08 | Должен ли PN объяснять, почему задал вопрос или предложил решение? | обязательно для всех записейтолько для критичныхне нужно | Доверие и объём текста; влияет на отчёт §42. | ← F03; → S19 |
| F09 | Какие артефакты PN обязан генерировать? | минимум: brief, context, SDD, backlogрасширенно: + CJM, ADR, promptsполный набор + код | Definition of Done §46 и объём фаз §32–§41. | ← F02; → F10 · S12 · S13 |
| F10 | Должен ли PN сам переводить проект между стадиями IDEA → … → DEPLOY? | автоматическипо гейтам с подтверждениемтолько вручную | §16 гейты, UX, риск «поехали не туда». | ← F02 · F09 · A10; → F12 · S20 |
| F11 | Как пользователь видит состояние проекта и следующий шаг? | dashboardотчёт по запросутолько чат | Экраны 1–2 и требования к UI. | ← A01; → F10 |
| F12 | Должен ли PN возвращаться на стадию назад при новых фактах? | да, автоматическипо подтверждениюнет | Модель состояний §16 и стоимость переработки. | ← F07 · F10; → S18 |
| F13 | Что входит именно в MVP, а что в следующие версии? | минимум: вопросы + контекстрасширенно: + research + SDDполный цикл | Срок MVP и метрики §43. | ← B19; → F14 · A07 |
| F14 | Является ли Construction Navigator первым вертикальным пакетом? | данет, сначала общий кейсвторой после пилота | Домен-пак S21 и приоритет рынка B06. | ← F01 · B06; → F15 |
| F15 | Какие функции Construction реализуются первыми? | нормы/СП + чек-листысмета и ресурсыдокументооборотвсё сразу | Объём домен-пака и KB §27. | ← F14; → S21 |
| F16 | Как PN взаимодействует с системами заказчика (сметы, BIM, ЭДО)? | общий протокол/APIобмен файлами Contextнезависимо | Целевая архитектура §48 и модель Context §29. | ← B04 · B23; → F17 |
| F17 | Нужна ли единая модель Project Context для всех ассистентов? | да, общая схемапрофиль на ассистентасвоя у каждого | §6 и миграции; прямо влияет на A04. | ← F16; → A04 |
| F18 | Должен ли PN создавать и полный набор инструкций для coding-agent? | только контекст и инструкцииинструкции + кодполный цикл с проверкой | Граница с coding-agent (A11) и скилы S14/S22. | ← A11 · F09; → S14 |
54.3. Бизнес-вопросы: рынок, модель, тарифы и развитие 24
| ID | Вопрос | Варианты ответа | Влияние на проект | Связи |
|---|---|---|---|---|
| B01 | Для кого PN создаётся в первую очередь? | индивидуальные разработчикипредприниматели/фаундерыкомандыкомпаниикорпорации | UX, тарифы и глубина контекста. | ← B04; → B02 · B07 |
| B02 | Какую проблему пользователь готов решать за деньги? | хаос в требованияхпотеря контекста проектадолгий и дорогой discoveryконсультанты | Позиционирование и акцент MVP. | ← B01; → B05 · B19 |
| B03 | Кто покупатель и кто конечный пользователь? | совпадаютпокупатель — руководительпокупатель — инвестор/фонд | Тарифы, отчёты, роли в UI. | ← B01; → B08 · B13 |
| B04 | PN — самостоятельный продукт, внутренний инструмент или платформа? | внутренний инструмент 01.labсамостоятельный продуктплатформа для вертикалейгибрид | Ключевой вопрос: определяет архитектуру, деплой, лицензии и весь скоуп. | → A01 · A11 · F16 · B07 · B12 · B23 |
| B05 | Чем PN принципиально отличается от AI coding agents и PM-решений? | контекст и решения, а не кодвертикальные домен-пакиоркестрация скиловцена и простота | Дифференциация и состав MVP. | ← B02 · B22; → B06 |
| B06 | Какой рынок первый? | AI-разработкауправление проектамистроительствоконсалтингдругой | Домен-пак, кейс F01, каналы. | ← B05 · B23; → F14 |
| B07 | Какая бизнес-модель? | подпискаpay-per-useза проектза токеныкомбинированная | Биллинг, лимиты, архитектура квот. | ← B04 · B01; → B08 · B09 · B11 |
| B08 | Какие тарифные планы нужны на старте? | один тарифfree + proтри уровня (free/pro/team)enterprise по запросу | UI биллинга, лимиты, go-to-market. | ← B07 · B10; → B09 |
| B09 | Что ограничивается тарифом? | проектыобъём контекстаresearch-квотычисло LLMcollaborationdeploy | Модель данных квот и реальная стоимость обслуживания. | ← B07 · B08; → B11 |
| B10 | Нужен ли бесплатный тариф или trial? | free с лимитами14 дней trialтолько demoнет | Конверсия, стоимость LLM, антиабьюз. | ← B08; → B18 |
| B11 | Должна ли цена зависеть от потребления LLM/API? | фиксированная ценаметрика токеновгибрид: база + овердж | Роутинг моделей §13 и маржа; связано с A02/A03. | ← A02 · B07 · B09 |
| B12 | SaaS, on-premise или оба варианта? | SaaSon-premiseгибрид (SaaS + private) | Ключевой вопрос: хранилище A04, безопасность, поддержка. | ← B04 · B13; → A01 · A04 |
| B13 | Нужна ли корпоративная версия с изолированным контуром? | да, в roadmapтолько on-premнет | Требования к приватности и локальным LLM. | ← B12; → A02 |
| B14 | Как монетизировать вертикальные пакеты? | отдельная подпискааддон к PNвключено в старший тарифлицензия на домен | Упаковка, биллинг, партнёрства. | ← B15 · B16; → B23 |
| B15 | Вертикали продаются отдельно или в едином тарифе? | отдельные продуктыединый тарифмикс: core + packs | Каталог, UX покупки, цены. | ← B14; → B16 |
| B16 | Можно ли продавать knowledge/domain packs отдельно? | да, маркетплейсда, но курирует 01.labнет | Лицензирование контента, юридика, качество. | ← B14 · B15 |
| B17 | Кто первый потенциальный клиент и где его искать? | свой круг и партнёрыстроительные компанииакселераторы и фондыонлайн-сообщества | Кейс F01, каналы, сроки валидации. | ← B06; → B18 · F01 |
| B18 | Как проверить product-market fit до разработки? | 5–10 интервью + ручной прогонлендинг и waitlistплатный пилототкрытый MVP | Что именно строить в MVP и какие метрики снимать. | ← B17 · B19; → B20 |
| B19 | Какой минимальный набор функций показывает ценность? | вопросы + контекст + отчёт+ research+ SDD/backlogполный цикл | Определение MVP; напрямую связано с F02/F13. | ← B02 · B18; → F02 · F13 · A09 |
| B20 | Какие KPI определят успех MVP? | время до SDDчисло снятых вопросов% принятых решенийвозвраты/NPSпилоты | Метрики §43 и приоритеты итераций. | ← B18 · B19; → B21 |
| B21 | Горизонт окупаемости и бюджет MVP? | 3–6 мес · до 10k$6–12 мес · 10–50k$12+ мес · >50k$ | Глубина MVP, объём research (A08), число моделей. | ← B07 · B20; → A08 |
| B22 | Каких конкурентов исследовать до выбора архитектуры? | coding agentsPM/discovery-инструментыAI-orchestrationвертикальные консалтинги | Дифференциация и выбор архитектуры. | ← B05 · B06 |
| B23 | Какая стратегия выхода на рынок? | собственный продуктB2B-пилотыпартнёрствовнутренний инструмент → продукт | Ключевой вопрос: roadmap, команда, маркетинг. | ← B04 · B06; → A01 · F16 |
| B24 | Как должен выглядеть путь развития? | PN Core → вертикали → экосистема → платформасразу платформатолько одна вертикаль | §48–49 и архитектурные границы. | ← B04 · B14 · B23 |
54.4. Организационные и инфраструктурные вопросы 14
Это не «техника» и не «бизнес»: без этих ответов проект просто не стартует — нет аккаунтов Claude/OpenAI, нет оплаты API, нет хостинга, домена, репозитория, команды и канала продаж. Волна 0 снимается параллельно всему остальному.
| ID | Вопрос | Варианты ответа | Влияние на проект | Связи |
|---|---|---|---|---|
| O01 | Есть ли аккаунты LLM: Claude (Anthropic), OpenAI, Google, локальные модели? | есть всечастично (1–2 вендора)нет, оформляемдоступ через прокси/реселлера | Сроки старта и стоимость; определяет A02 (выбор моделей) и A03 (прямые вызовы API). | ← B21; → A02 · A03 · O02 |
| O02 | Как оплачиваются зарубежные API и сервисы? | корпоративная картаюрлицо-нерезидентреселлер/агентнет платёжного средства | Юридические риски, лимиты и бюджет; без оплаты не работает ни research, ни LLM-режим. | ← A03 · B21; → O01 · O14 |
| O03 | Где размещается инфраструктура? | VPS в РФ (Beget/Timeweb)VPS за рубежом (Hetzner и др.)облако (Yandex/Selectel/AWS)on-prem | Определяет A01 (где работает PN), A04 (хранение Context) и B12 (SaaS/on-prem). | ← B12; → O04 · O05 · O08 |
| O04 | Какие домены, DNS и SSL выделены? | основной домен + поддоменытолько поддомендоменов нетDNS у подрядчика | Деплой, почта, брендирование и доверие; блокирует публичный запуск. | ← O03; → O06 · O12 |
| O05 | Где живут репозитории и CI? | GitHub + ActionsGitea (self-hosted)GitLabещё нет | Влияет на A05 (git bootstrap), S16 и на передачу проекта между людьми. | ← O03; → A05 · O08 |
| O06 | Какие системы мониторинга, аналитики и логов нужны? | минимум: логи + uptimeAPM/Sentryпродуктовая аналитика (Plausible/Umami)Grafana/метрики | Эксплуатация и KPI §43; без аналитики нельзя измерить ценность MVP. | ← B20 · O04; → O07 · B20 |
| O07 | Что бэкапим и с какими RPO/RTO? | ежедневный бэкап БДбэкап Context + БД + конфиговтолько git-артефактыне продумано | Риск потери контекста проекта — главного актива PN; влияет на доверие и тарифы. | ← A04 · O06; → O08 |
| O08 | Как устроены доступы и безопасность? | пароли + 2FASSOсекреты в vaultключи в .env на сервере | A10 (подтверждения), B13 (корпоративный контур), требования аудита. | ← O03 · O05; → A10 · O14 |
| O09 | Кто в команде и какие роли закрыты? | 1 человек (всё сам)продукт + разработка+ дизайн+ тестирование/QA | Сроки MVP и распределение скилов S01–S23; определяет, что автоматизировать первым. | ← B21; → O10 · O11 |
| O10 | Нужны ли внешние подрядчики и какой бюджет? | нет, только своидизайн на аутсорсеразработка на аутсорсеюр/бух — на аутсорсе | Стоимость MVP, скорость, риски качества и передачи знаний. | ← O09 · B21; → O11 |
| O11 | Какая юридическая обвязка есть и нужна? | ИП/ООО естьдоговор с клиентом + NDAоферта для SaaSлицензии на ПО/данные | B07/B12 (модель и контур), продажи и защита от претензий. | ← B04 · B07; → O12 · O14 |
| O12 | Кто и как продаёт? Каналы и CRM | основатель продаёт сампартнёры/интеграторысообщества и контентCRM/воронка уже есть | B17/B23 (первый клиент, стратегия выхода); напрямую влияет на план пилота. | ← B17 · B23 · O04; → O13 |
| O13 | Как устроена поддержка пользователей? | Telegram-чатпочта + база знанийSLA по тарифамподдержки нет | Эксплуатационная нагрузка и упаковка тарифов B08. | ← O12 · B08; → B09 |
| O14 | Где хранятся данные клиентов и как соблюдается приватность? | 152-ФЗ: серверы в РФGDPR/ЕСгибрид по тарифамне проработано | B12/B13, A04 (хранение), договорённости с LLM-провайдерами; риск блокировки продукта. | ← B12 · A04 · O02; → O08 |
54.5. Доменная специфика и экспертиза 14
Общие вопросы не описывают предметную область. Без домена PN выдаёт «правильные» вопросы общего вида: нормативка, первоисточники, типовые артефакты и проверка корректности — это то, что отличает доменный пак от просто промпта.
| ID | Вопрос | Варианты ответа | Влияние на проект | Связи |
|---|---|---|---|---|
| D01 | Какой тип объекта берём первым для доменного пака? | жилой объектобъект инженерной инфраструктурыпромышленный объектреконструкция здания | Наполнение KB §27, скил S21 и первый тестовый кейс F01. | ← B06 · F14; → D02 · D03 · D06 |
| D02 | Кто доменный эксперт и доступен ли он проекту? | в командепартнёр по договорувнешний консультантэксперта нет | Достоверность фактов и приёмка доменного пака; влияет на O09 и O10. | ← O09 · O10; → D08 · D12 · D14 |
| D03 | Какая нормативная база обязательна? | СП / ГОСТ / ФЗприказы и положения фондовотраслевые регламентынормативка не нужна | Источники FACT и структура чек-листов; определяет D04 и D09. | ← D01; → D04 · D09 · D13 |
| D04 | Какие первоисточники домена и как их получать? | открытые API и реестрыофициальные выгрузкипарсинг сайтоввручную, экспертом | Стоимость и юридическая чистота research (A08); качество FACT S05. | ← D03 · A08; → D11 · D13 |
| D05 | Какие типовые артефакты домена PN обязан порождать? | ТЗ / техзаданиесмета и расчётКП / коммерческое предложениеакт / заключение | Состав артефактов F09 и шаблонов доменного пака. | ← F09 · D01; → D06 · D14 |
| D06 | Какой уровень детализации домена нужен в MVP? | термины + чек-листы+ нормы и ссылки+ расчёты и сметыполная модель домена | Объём доменного пака и срок MVP (B19, F13); риск переусложнить первую версию. | ← B19 · F13 · D01; → D05 · D14 |
| D07 | Нужны ли интеграции с отраслевыми системами? | 1С / ERPBIM / Revit / CADExcel и файлыне нужны | Архитектура A01 и объём работ; влияет на A07 (форматы файлов). | ← O03 · A07; → D05 |
| D08 | Как проверяется доменная корректность ответов PN? | ревью экспертаформальные правила и справочникитесты на реальных кейсахне проверяется | Доверие к продукту и метрика correctness §38; определяет D14. | ← D02 · S15; → D14 · B20 |
| D09 | Нужен ли глоссарий и онтология домена? | да, полный глоссарийминимальный словарь терминовбез глоссария | Качество вопросов и поиска; влияет на структуру KB §27. | ← D03; → D12 |
| D10 | Как домен влияет на упаковку и цену? | отдельный платный паквключён в старший тарифлицензия на доменпока не влияет | Монетизация B14–B16 и каталог продуктов. | ← B14 · B16; → D12 |
| D11 | Какие данные клиента доменно-чувствительны? | коммерческая тайнаперсональные данныепроектная документацияпубличные данные | Требования к приватности O14 и хранению A04; риск утечки. | ← O14 · A04 · D04; → D07 |
| D12 | Кто владеет доменным контентом и его обновлением? | 01.labпартнёр-экспертсообщество практиковвладельца нет | Ответственность за актуальность (D13) и юридические права на контент. | ← D02 · D09 · D10; → D13 |
| D13 | Как часто меняется нормативка и кто её отслеживает? | ежеквартальнораз в годad hocне отслеживается | Регламент обновлений доменного пака и стоимость поддержки. | ← D03 · D04 · D12; → D14 |
| D14 | Как выглядит приёмка доменного пака? | кейс с экспертомчек-лист требованийметрики точности на выборкеприёмки нет | Definition of Done §46 и метрики B20; защита от «пак есть, а пользы нет». | ← D02 · D05 · D08 · D13; → B20 |
⚠️ draft. Ответы фиксируются как DEC-* в Project Context
(§6.3) и проверяются на гейтах D1–D3.54.6. Как обсуждать вопрос с LLM — шаблон промпта
Правило: один вопрос — один диалог. Модель не выбирает за
человека: она обязана показать варианты, последствия и рекомендацию с условиями
(§28). Ответ, который нельзя превратить в DEC, — бесполезный ответ.
Шаблон запроса
Роль: ты архитектор продукта PN (Project Navigator) и мой оппонент, а не исполнитель.
Контекст: <продукт/инструмент, домен, стадия, бюджет, сроки, ограничения>
Вопрос: <ID> — <формулировка из §54>
Рассматриваю варианты: <1–4 варианта из таблицы>
Связи: <зависит от / блокирует — из колонки «Связи»>
Что нужно:
1. Для каждого варианта — последствия: архитектура, стоимость, сроки, риски (2–3 тезиса).
2. Что сломается в связанных вопросах <ID>, если выбрать этот вариант.
3. Твоя рекомендация и условие, при котором она станет неверной.
4. Каких данных не хватает для решения — максимум 3 вопроса.
5. Итог: DEC-запись в YAML: decision, context, alternatives, reason, owner, status: proposed.
Ограничения:
— не выдумывай факты, неизвестное помечай [предположение];
— не предлагай «оба варианта» без критерия выбора;
— не предлагай решение без цены (что перестаём делать);
— не более 400 слов.
Пример: O01 — аккаунты LLM
Роль: ты архитектор продукта PN и мой оппонент, а не исполнитель.
Контекст: MVP-навигатор по программам поддержки; 1 разработчик; бюджет до 10k$;
запуск через 6 недель; персональных данных клиентов нет; домен — строительство.
Вопрос: O01 — есть ли аккаунты Claude / OpenAI / Google / локальные модели?
Варианты: (а) есть все, (б) частично (1–2 вендора), (в) нет, оформляем,
(г) доступ через прокси/реселлера.
Связи: ← B21 (бюджет); → A02 (выбор моделей), A03 (прямые вызовы API), O02 (оплата).
Нужно: последствия каждого варианта для срока запуска и стоимости; что сломается
в A02/A03; рекомендация + условие её опровержения; DEC в YAML.
DEC с условием пересмотра. Если модель выдала текст без вариантов и
цены — промпт не сработал, повторите с «предложи возражения против собственной
рекомендации».Правила разговора
- Вопросы задавайте по одному: смешение A/B/O/D даёт «средний» ответ без пользы.
- Требуйте источник или явную пометку
[предположение]— иначе FACT попадёт в контекст как факт (§6.5). - Просите возражения против выбранного ответа — это работа Challenger (§14), а не Builder.
- Фиксируйте ответ как
DEC-*и обновляйте 54.x: вопрос закрывается только при выполненном условии гейта (D1–D3). - Открытые вопросы не копятся: 3 неотвеченных вопроса — стоп-сигнал для гейта.
0. Назначение документа
Документ описывает, как спроектировать и настроить ИИ-агента Project Navigator (PN), который не просто отвечает на вопросы и не является обычным coding-agent, а ведёт пользователя от исходной идеи сложного проекта к спроектированной системе управления этим проектом и затем самостоятельно проходит цикл создания MVP.
PN должен:
- принять исходную идею проекта;
- определить уровень неопределённости;
- задать недостающие вопросы;
- построить интерактивную карту проекта;
- разбить неопределённости на исследовательские задачи;
- генерировать prompts для других LLM и/или экспертов;
- принимать и структурировать полученные ответы;
- накапливать Project Context;
- выявлять противоречия, неизвестные и риски;
- после прохождения discovery-gates перейти к проектированию;
- сформировать CJM, use cases, требования, архитектуру, UI/UX и backlog;
- определить границы MVP;
- реализовать MVP по правилам 01.lab;
- проверить результат;
- развернуть MVP;
- сформировать отчёт и следующий цикл развития.
Главный принцип:
PN сначала проектирует понимание проекта, затем проектирует систему, и только после этого реализует MVP.
PN не должен преждевременно превращать неполную идею в код.
1. Контекст и место PN в 01.lab
01.lab — фреймворк параллельной разработки с ИИ-агентами: документация — источник истины, задача трассируема от беклога до деплоя, спорные решения подтверждает человек. PN встраивается в него, а не строит параллельный процесс.
| Что берём из 01.lab | Что добавляет PN | Граница |
|---|---|---|
| Конвейер идея → … → отчёт | Discovery / Context-слой перед проектированием | PN не заменяет dev-flow |
| Роли Builder · Challenger · Verifier · Curator · Synthesizer | Staging, гейты D0–D6, скилы S01–S23 | Роли не смешиваются |
| Скилы /explore, /arch, /sdd, /deploy | Вызов скилов + состояние, provenance, трассировка | Скилы не дублируются |
| Артефакты беклог, PR, CI, deploy | Project Context, FACT / ASM / DEC / Q | Код — только в code/ |
PN — не замена конвейера, а его интеллектуальный слой навигации.
2. Концепция продукта
2.1. Что такое Project Navigator
Project Navigator — агент и рабочее пространство для проектирования сложных проектных систем.
Он помогает пройти путь:
неясная идея
↓
структурированные вопросы
↓
карта проекта
↓
исследования
↓
накопленный контекст
↓
решения
↓
требования
↓
архитектура
↓
MVP
↓
работающая система
Название Navigator здесь принципиально: PN не обязан сам выполнять всю интеллектуальную работу. Его задача — направлять поток информации, решений, задач и исполнителей.
3. Что PN НЕ должен делать
PN не должен:
- начинать программирование после первого описания идеи;
- додумывать отсутствующие требования;
- считать ответ одной LLM доказанным фактом;
- смешивать исследование и реализацию;
- создавать задачи без источника;
- создавать корневые backlog-коды самостоятельно вне мастер-беклога;
- принимать архитектурное решение без рассмотрения альтернатив при существенном риске;
- смешивать роли Builder и Challenger;
- автоматически принимать спорное решение без human gate;
- превращать весь накопленный контекст в один гигантский prompt;
- использовать проектный Gantt как единственный источник истины.
Главное правило:
Неизвестное должно быть обозначено как неизвестное, а не заполнено правдоподобным текстом.
4. Основная модель PN
PN работает как state machine.
IDEA
│
▼
INTAKE
│
▼
DISCOVERY
│
├── QUESTIONS
├── RESEARCH
├── ALTERNATIVES
└── VALIDATION
│
▼
CONTEXT
│
▼
SYNTHESIS
│
▼
DESIGN
│
├── CJM
├── UC
├── PROCESS
├── UIX
└── ARCH
│
▼
SPEC
│
├── REQUIREMENTS
├── ACCEPTANCE
└── SCOPE
│
▼
MVP
│
├── BACKLOG
├── PLAN
└── TASKS
│
▼
BUILD
│
▼
VERIFY
│
▼
DEPLOY
│
▼
OPERATE
│
└──────────────→ новый цикл
Каждое состояние имеет:
- вход;
- разрешённые действия;
- обязательные артефакты;
- критерии выхода;
- человека, принимающего спорные решения.
5. Три слоя PN
Каждый слой отвечает на один вопрос и не подменяет остальные.
| Слой | Вопрос | Что хранит / делает |
|---|---|---|
| Navigator Layer что дальше |
Что сделать дальше, чтобы уменьшить неопределённость? | Вопросы, next best question/action, зависимости, альтернативы, приоритизация |
| Context Layer что знаем |
Что мы уже знаем о проекте? | Факты, источники, решения, предположения, требования, ограничения, риски, задачи, открытые вопросы |
| System Design Layer что строим |
Какую систему необходимо построить? | CJM, use cases, процессы, UI/UX, архитектура, ADR, MVP scope, backlog, тесты, план деплоя |
6. Project Context — центральный объект системы
Project Context не должен быть просто большим Markdown-файлом.
Минимальная логическая модель:
Project
├── Goal
├── Users
├── Stakeholders
├── Constraints
├── Assumptions
├── Questions
├── Research
│ ├── Prompt
│ ├── Source
│ ├── Response
│ └── Verification
├── Facts
├── Decisions
├── Alternatives
├── Risks
├── Processes
├── Requirements
├── Use Cases
├── Design
├── Tasks
├── Dependencies
└── Releases
6.1. Факт
id: FACT-001
statement: "..."
source: "..."
source_type: official | expert | llm | project | assumption
confidence: high | medium | low
verified: true | false
updated: YYYY-MM-DD6.2. Предположение
id: ASM-001
statement: "..."
reason: "..."
impact_if_wrong: high | medium | low
status: open | verified | rejected6.3. Решение
id: DEC-001
decision: "..."
context: "..."
alternatives:
- "..."
- "..."
reason: "..."
owner: "..."
status: proposed | approved | rejected6.4. Вопрос
id: Q-001
question: "..."
importance: critical | important | optional
blocks:
- "REQ-..."
- "DEC-..."
status: open | research | answered | rejected6.5. Протокол источника
PN не принимает «LLM сказала X» за истину: утверждение проходит цепочку и попадает в контекст только как FACT или unresolved. Строже всего — к нормативам, срокам, ценам, API и внешним ограничениям.
8. Question Engine
Задавать не максимум вопросов, а минимально необходимое число с максимальной ценностью информации.
| Подход | Что происходит |
|---|---|
| Плохой анкета | Задать пользователю 50 вопросов подряд — контекст не растёт, доверие падает. |
| Правильный цикл | Найти неизвестность, которая сильнее всего влияет на архитектуру / scope / стоимость / сроки / риск → задать один вопрос → обновить Context → пересчитать зависимости → выбрать следующий. |
8.2. Классы вопросов
| Класс | Что выясняет |
|---|---|
| Goal | Зачем создаётся проект; какой результат считается успехом. |
| User | Кто пользователь, кто платит, кто принимает решение, кто работает ежедневно. |
| Scope | Что обязательно, что можно отложить, что точно вне MVP. |
| Process | Как процесс работает сейчас; где ручной труд, ошибки, задержки. |
| Constraints | Бюджет, сроки, технологии, нормативы, доступы, интеграции, безопасность. |
| Risk | Что может сделать проект бесполезным; что блокирует запуск; какая ошибка дороже всего. |
| Verification | Какой первоисточник, кто владелец знания, как проверить утверждение. |
9. Формула выбора следующего вопроса
Для каждого открытого вопроса PN оценивает:
Priority =
Impact × Uncertainty × Dependency × CostOfWrongAnswer
где:
- Impact — влияние на проект;
- Uncertainty — степень неизвестности;
- Dependency — сколько решений зависит от ответа;
- CostOfWrongAnswer — цена ошибочного решения.
При равных условиях сначала выбирается вопрос с максимальным приоритетом.
10. Project Map
Flow и Gantt — не две системы, а два представления одной Project Graph.
| Представление | Что показывает | Когда нужно |
|---|---|---|
| 10.1 Flow View путь знания |
GOAL → USER → PROBLEM → PROCESS → UNKNOWN → RESEARCH → FACT → DECISION → REQUIREMENT → TASK → MVP | Понять, где проект «застрял» |
| 10.2 Timeline / Gantt время |
Задачи, зависимости, исследования, гейты, milestones, сроки, блокировки | Планировать сроки и ресурсы |
| 10.3 Context Map связи |
Goal → User / Process / Constraint / Risk → Requirement → Feature → Task | Проверить, что каждая задача обоснована |
10.4. Трассируемость вместо декоративного Gantt
Обычный Gantt отвечает:
Когда выполняется задача?
PN должен отвечать:
Почему эта задача существует и какое знание/решение делает её возможной?
Например:
TASK-17
"Сделать API согласований"
│
├── derived from → REQ-04
│
├── derived from → UC-03
│
├── depends on → DEC-07
│
├── depends on → Q-12
│
└── validated by → TST-09
Это делает roadmap трассируемым, а не декоративным.
12. Research Engine
Вопрос → RESEARCH-n → промпты → ответы → FACT с источником.
Исследование закрывается артефактом, а не «стало понятнее».
| Тип research | Когда | Формат ответа |
|---|---|---|
| Нормативный обязательно |
Нужны требования, сроки, формы, регламенты | Claim → Source → Evidence → Confidence → Notes; отдельно обязательные требования и рекомендации; дата актуальности; неопределённости явно |
| Альтернативы перед решением |
Нужно сравнить варианты | Минимум 3 варианта: принцип, плюсы, минусы, стоимость, сложность, риски, зависимости. Решение не выбирается автоматически |
| Market scan до D4 |
Выбор архитектуры и позиционирования | Таблица сравнения решений и вывод, где PN дополняет, а где конкурирует (§12.4) |
12.4. Исследование текущих решений (market scan)
До выбора архитектуры (гейт D4) нужно понять, что уже существует и почему проектировщик этим не пользуется. Задача — не «посмотреть конкурентов», а найти место PN: где он дополняет, а где конкурирует.
| Категория | Что проверяем | Кандидаты (проверить) | Вывод для PN |
|---|---|---|---|
| AI-агенты для кода | умеют ли вести контекст и требования, а не только писать код | Cursor, Claude Code, Aider, Devin | не конкурировать: PN отдаёт им спецификацию и беклог |
| Discovery / PM | проверяют ли достаточность требований и знают ли домен | Linear, Jira Product Discovery, Productboard, Notion AI | сильны в задачах, слабы в «чего не хватает» |
| Стройдокументация и согласования | объясняют ли состав пакета и причины отказа | ИСОГД, порталы ведомств, системы электронного согласования, Procore / PlanRadar-класс | фиксируют факт подачи, но не учат подавать |
| Вертикальные консультанты | есть ли знание и масштабируется ли оно | профильные бюро, чек-листы, внутренние базы | знание есть, памяти и повторяемости нет |
| Внутренний 01.lab | что уже закрыто конвенциями и скилами | конвенции, скилы, шаблоны | не дублировать, а оркестрировать (§31) |
Критерии сравнения: порог входа для проектировщика · знание домена согласований · приватность и хранение данных · экспорт контекста · интеграции (1С, BIM, Excel) · цена владения · скорость первого результата.
Выход: RSR-market.md с таблицей и DEC
по позиционированию (вопрос B05, B22). Списки кандидатов — гипотезы для проверки,
а не утверждения о продуктах.
13. Мультимодельный режим
PN должен уметь направлять один вопрос нескольким исполнителям.
Question
│
├── LLM A
├── LLM B
├── LLM C
├── Web / official source
└── Human expert
↓
Responses
↓
Compare
↓
Verify
↓
Synthesis
Ответы не смешиваются до этапа сравнения.
Это особенно важно, поскольку 01.lab запрещает смешивать когнитивные роли в одном контексте: Builder, Challenger, Verifier и Synthesizer должны оставаться отдельными перспективами.
14. Staging PN
PN использует существующие роли 01.lab. Роль отвечает на вопрос «кто думает», скил — «что выполняется» (§14.7). Роли нельзя смешивать в одном контексте.
| Роль | Что делает | Выход |
|---|---|---|
| Navigator поиск направления |
Ищет альтернативы, аналогии, дополнительные направления исследования; готовит вопросы. | Черновик вариантов, research-запросы |
| Builder проектирование |
Проектирует решение: CJM, архитектура, требования, SDD. | Design, ADR, SDD |
| Challenger разрушение решения |
Ищет противоречия, failure modes, скрытые предположения; спорит с Builder. | Риски, CHAL-записи |
| Verifier проверка |
Проверяет факты, аргументацию, замечания Challenger и ответы Builder. | Verify-report, pass/fail |
| Curator приоритизация |
Приоритизирует critical / important / optional; чистит и связывает контекст. | Приоритеты, Context snapshot |
| Synthesizer сведение |
Сводит цикл в решение, отчёт и следующий шаг. | DEC, отчёт, next step |
Navigator → Builder → Challenger → Verifier → Curator → Synthesizer
14.7. Скилы PN (skills)
Скил — переиспользуемая единица поведения с фиксированным контрактом:
триггер → вход → выход → артефакт. Скилы — то, что PN
оркестрирует, а не переизобретает: часть берётся из 01.lab,
часть реализуется проектом (§31, §56).
Банк скилов
| ID | Скил | Триггер / вызов | Вход | Выход → артефакт |
|---|---|---|---|---|
| S01 | Intake / Брифованиеинтервью до проекта | роль: Navigatorгейт: D0 старт продукта, сырой запрос заказчика | запрос, контекст, ограничения, домен | brief, выбор варианта A/B/C |
| S02 | Project Registrationрегистрация проекта | роль: Curatorгейт: D0фаза 1 подтверждённый бриф, владелец | паспорт проекта, границы, роли | project record, repo layout |
| S03 | Question Decompositionлюбой открытый вопрос | роль: Navigatorгейт: D1–D3фаза 2 вопрос верхнего уровня, класс (Goal/User/Scope/Process/Constraints/Risk/Verification) | подвопросы и критерии ответа | Q-узлы, дерево вопросов |
| S04 | Next-Question Selectionкаждая итерация | роль: Navigatorгейт: D1–D3фаза 2 Context, важность, стоимость, гейт | один приоритетный вопрос + обоснование | next-Q, формула §9 |
| S05 | Normative Researchпо выбранному вопросу | роль: Curatorгейт: D2фаза 2 вопрос, домен, allow-list источников | факты с источником и confidence | FACT-* |
| S06 | Alternatives Researchперед решением | роль: Navigatorгейт: D3фаза 2 решение/вопрос, ограничения | варианты с trade-off и ценой ошибки | ASM-*, DEC-* |
| S07 | Fact Extraction & Provenanceпосле любого источника | роль: Verifierгейт: D2фаза 2 документ, ответ эксперта, LLM-вывод | FACT с source_type и verified | FACT-*, provenance |
| S08 | Assumption Trackingпри пробеле в знаниях | роль: Challengerгейт: D2–D4фаза 2 незакрытые вопросы, допущения | ASM с impact_if_wrong и статусом | ASM-* |
| S09 | CJM Mappingпроектирование продукта | роль: Builderгейт: D4фаза 3 сегменты, роли, этапы | карта пути и этапов, точки боли | CJM |
| S10 | Architecture Draftпосле закрытия D3 | роль: Builderгейт: D4фаза 4 требования, ограничения, FACT/DEC | слои, компоненты, ADR, границы | architecture, ADR |
| S11 | Red Team / Challengeперед фиксацией решения | роль: Challengerгейт: D4–D5фаза 4 драфт решения, предположения | риски, контрдоводы, failure modes | CHAL-* |
| S12 | Spec Writing (SDD)после утверждения дизайна | роль: Builderгейт: D5фаза 5 DEC, REQ, границы MVP | спецификация: требования, сценарии, приёмка | SDD |
| S13 | Backlog Slicingпосле SDD | роль: Curatorгейт: D6фаза 6 SDD, приоритеты, ресурсы | MUST / SHOULD / COULD / WON’T | backlog |
| S14 | Build Orchestrationреализация | роль: Builderгейт: D6фаза 7 backlog, промпты, существующие скилы 01.lab | план сборки и задачи для coding-agent | build plan |
| S15 | Verificationпосле сборки | роль: Verifierгейт: D6фаза 8 артефакты, требования, метрики | completeness / correctness / coherence | verify report |
| S16 | Git / CI Bootstrapпосле подтверждения человека | гейт: D6фаза 9 подтверждение, структура проекта | репозиторий, ветки, pipeline | CI config |
| S17 | Deploy & Smokeпосле подтверждения человека | гейт: D6фаза 10 артефакт сборки, целевое окружение | deploy-план, smoke-результат | deploy report |
| S18 | Context Curationпостоянно | роль: Curator накопленные FACT / ASM / DEC / Q | дедупликация, связи, актуальность, архив | Context snapshot |
| S19 | Synthesis & Reportконец итерации | роль: Synthesizerфаза 42 весь Context, лог гейтов | отчёт, следующий шаг, открытые вопросы | REPORT |
| S20 | Gate Checklist Evaluationкаждый гейт D0–D6 | роль: Verifierгейт: D0–D6 чек-лист гейта, Context | pass / fail + чего не хватает | gate log |
| S21 | Domain Pack Loadстарт проекта | роль: Curatorгейт: D0фаза 1 домен (например, Construction) | термины, нормы, шаблоны, типовые риски | domain pack |
| S22 | Prompt Compilationпередача внешнему ассистенту | роль: Synthesizerгейт: D6фаза 7 Context, целевой coding-agent | пакет промптов и инструкций | prompt bundle |
| S23 | Metrics & Retroконец MVP-итерации | роль: Synthesizer лог итераций, метрики §43 | KPI, выводы, корректировка процесса | metrics, retro |
MVP-колонка не выводится отдельной колонкой: скилы MVP помечены в §25 (MUST) и в самом первом MVP.
Скилы в гейтах
| Гейт | Скилы | Артефакты на выходе |
|---|---|---|
| D0 — Idea | S01, S02, S20, S21 | brief, project record, domain pack |
| D1 — Goal | S03, S04, S20 | цель, границы, критерии успеха |
| D2 — Context | S05, S07, S08, S18, S20 | FACT/ASM, карта источников |
| D3 — Uncertainty | S04, S06, S08, S18, S20 | снятые/принятые неопределённости |
| D4 — Design | S09, S10, S11, S20 | CJM, архитектура, риски |
| D5 — Specification | S11, S12, S20 | SDD, правила MVP |
| D6 — MVP | S13, S14, S15, S16, S17, S22, S20 | backlog, сборка, проверка, deploy |
Контракт скила
skill: <S-код> <название>
trigger: роль | гейт | фаза | команда (§52)
input: поля Context, которые скил читает (не больше, чем нужно)
output: типизированная запись: FACT | ASM | DEC | Q | ARTIFACT
side_effects: запись в Context, лог, метрика
guardrails: что скил НЕ делает без подтверждения человека (§28)
idempotent: true | false
owner: роль, отвечающая за качество результата
Правила банка скилов:
- скил не принимает решений за человека — он готовит варианты и обоснование;
- скил не пишет в разделы Context вне своего контракта;
- скил возвращает provenance и confidence, а не «мнение»;
- скил, который нельзя проверить (нет критерия приёмки), не считается скилом;
- появление нового скила фиксируется в этом банке до реализации, а не после.
15. Progressive Rigor
PN выбирает режим работы до изменения проекта. Режим определяет объём артефактов, а не важность задачи.
| Режим | Когда применяется | Результат |
|---|---|---|
| Quick низкий риск |
Ясная низкорисковая задача. | Краткий план, точечное изменение, focused check |
| Explore неясность |
Цель или решение неясны. | Факты, альтернативы, риски, вопросы; файлы проекта не меняются |
| Spec высокий риск |
Новая фича, API, архитектура, миграция, безопасность, несколько вертикалей. | Behavior contract, design, tasks, acceptance, verification |
| Bugfix дефект |
Наблюдаемая ошибка. | Current / expected behavior, причина, fix, regression check |
| Archive завершение |
После завершения изменения. | Source of truth, реестр, README, changelog |
16. Discovery Gates
PN не переходит в следующую фазу только потому, что пользователь сказал «делай». Гейт — это проверяемое состояние, а не ритуал.
| Гейт | Критерии прохождения | Артефакт |
|---|---|---|
| D0 — Idea | Рабочее название, проблема, предполагаемый пользователь, желаемый результат. | Brief |
| D1 — Goal | Цель, критерий успеха, scope и out of scope. | Goal card |
| D2 — Context | Ключевые факты и источники, ограничения, stakeholders, основные процессы. | Context map, FACT |
| D3 — Uncertainty | Критические неизвестности закрыты или осознанно приняты как assumption. | Список ASM, Q-статусы |
| D4 — Design | CJM, use cases, process, варианты архитектуры, направление UI/UX. | Design, ADR |
| D5 — Specification | Требования, acceptance criteria, что вне scope, риски, зависимости. | SDD |
| D6 — MVP | Core features, backlog, DoD, порядок реализации. | Backlog, DoD |
После D6 PN имеет право запускать build-flow. Провал гейта — это список того, чего не хватает, а не запрет навсегда.
17. Артефакты PN
Структура проекта PN соответствует конвенции 01.lab для AI-проекта: проектные документы, база знаний, промпты и код живут раздельно. Каждый артефакт появляется на своём гейте, а не «когда-нибудь».
| Блок | Состав | Когда появляется |
|---|---|---|
| Корень проекта паспорт |
README.md — цель, стадии, ссылки; Project_overview.md — продукт, пользователи, границы. |
D0–D1 |
| 01_general/ сквозные документы |
QST_questions.md, RSR_research.md, GLS_glossary.md,
CJM_customer_journey.md, NAV_navigation.md, UIX_design_ui_ux.md,
TEC_tech_solution.md. |
D1–D5, по мере гейтов |
| 02_project/ процесс |
PLN_backlog.md, PM_project_management.md, decisions/ (DEC),
reports/ (отчёты сессий). |
с D1, постоянно |
| 03_knowledge_base/ знание с provenance |
facts/ (FACT), sources/ (первоисточники), research/ (RSR),
decisions/ (обоснования). |
D2 и далее |
| 04_verticals/ доменные пакеты |
Construction (7 организаций, пакеты, нормы, сроки), Startup, Research, а также другие домены. | D4, после выбора домена |
| 05_references/ примеры и практики |
Эталонные заявки, презентации, чек-листы; разборы кейсов. | по необходимости |
| code/ реализация |
proxy/ (LLM-прокси), context/ (хранилище и API), navigator/ (вопросы, гейты),
ui/ (web-интерфейс). |
D6 |
Правило: артефакт без гейта и владельца не создаётся; документ без front-matter и записи в реестре не считается артефактом.
18. Кодовая модель
PN рекомендуется разделить на следующие компоненты:
pn/
├── domain/
│ ├── project.py
│ ├── question.py
│ ├── research.py
│ ├── fact.py
│ ├── decision.py
│ ├── requirement.py
│ └── task.py
│
├── context/
│ ├── store.py
│ ├── resolver.py
│ └── provenance.py
│
├── navigator/
│ ├── state_machine.py
│ ├── question_engine.py
│ ├── next_action.py
│ └── dependency_graph.py
│
├── prompts/
│ ├── generator.py
│ └── templates/
│
├── staging/
│ ├── navigator.py
│ ├── builder.py
│ ├── challenger.py
│ ├── verifier.py
│ ├── curator.py
│ └── synthesizer.py
│
├── design/
│ ├── cjm.py
│ ├── requirements.py
│ ├── architecture.py
│ └── backlog.py
│
└── api/
└── ...
18.1. Архитектура решения
Логическая архитектура: интерфейсы не знают, откуда берутся факты; оркестрация работает только через Project Context; домен и нормативка — это данные, а не код. Схема отражает §5 (три слоя), §14 (роли) и §14.7 (скилы).
- Единая точка правды — Project Context. Интерфейсы (web, CLI, API) и роли читают и пишут только через него; прямой доступ к БД минует provenance — запрещён (§20).
- Домен — данные. «Согласования Москвы» (Мосводоканал, Мосводосток, МОЭК, метрополитен, Россети, Моссвет, Мосгаз) подключаются как Domain Pack: пакеты документов, нормы, сроки, шаблоны (§27).
- Скилы оркестрируются, а не переписываются. 01.lab даёт конвенции, скилы и шаблоны; PN добавляет состояние, гейты и трассируемость (§31, §56).
- Модель выбирается по задаче. Дешёвые вопросы — flash-модель, архитектура и red team — сильная модель; кеш и учёт токенов обязательны (§13).
18.2. Схема развёртывания
Минимальный контур MVP: локальная разработка → репозиторий → CI → образ → один VPS с nginx и двумя контейнерами. Внешние зависимости — LLM-провайдеры и порталы организаций; ключи живут только на сервере, браузер их не видит.
Схема развёртывания — на вкладке «Развёртывание» в §18.1.
- Окружения: dev → verification → prod; prod-деплой только после подтверждения человека (§28).
- Секреты:
.envна сервере или vault, не в git; ключи LLM не попадают в контекст и логи (§O08). - Данные: volume
context.db+ артефакты; ночной бэкап в object storage, RPO сутки, проверка восстановления раз в месяц (§O07). - Наблюдаемость: uptime и алерты на 4xx/5xx, время ответа, стоимость LLM за сутки; логи без персональных данных (§O06).
- Масштабирование: сначала вертикально; pn-worker отделяется первым, когда research перестаёт помещаться в один процесс.
19. MVP интерфейс
Шесть экранов MVP: каждый отвечает на один вопрос пользователя и связан с гейтом.
| Экран | Что показывает | Действия |
|---|---|---|
| 1 — Project вход в работу D0–D1 | Проекты, текущая стадия, владелец, дата обновления. | Создать / открыть проект, сменить стадию |
| 2 — Navigator что дальше каждая итерация | Текущий вопрос, следующий шаг, прогресс по гейтам. | Ответить, отложить, отправить в research |
| 3 — Question принятие решения D1–D3 | Вопрос, варианты ответа, влияние, связи с другими вопросами. | Выбрать вариант, «другое», research |
| 4 — Research снятие незнания D2–D3 | Задачи исследования, источники, ответы, статусы. | Запустить, приложить источник, принять факт |
| 5 — Context состояние знания постоянно | Факты, предположения, решения, открытые вопросы. | Подтвердить, отредактировать, архивировать |
| 6 — Project Design результат D4–D6 | CJM, use cases, требования, архитектура, backlog. | Утвердить, экспорт в SDD / backlog |
19.7. Визуалы интерфейсов
Четыре экрана MVP в том виде, в котором их видит проектировщик: рабочие wireframes, а не дизайн-макеты.
gate-D3.md23. SDD
Спецификация — не текст «для галочки», а три связанных артефакта с проверяемыми требованиями (§35).
| Артефакт | Что содержит | Готово, когда |
|---|---|---|
| spec.md что делаем | Требования REQ-* с acceptance criteria, границы scope, риски, зависимости. | Каждое требование проверяемо и имеет источник |
| plan.md как делаем | Архитектурные решения, последовательность, тесты, миграции. | Понятно, что делать первым и почему |
| tasks.md кто и когда | Задачи из §24 с выходом, зависимостью и гейтом. | Каждая задача имеет артефакт приёмки |
| Требование | Формулировка |
|---|---|
REQ-001 | Система SHALL создавать Project Context при регистрации проекта. |
REQ-002 | WHEN пользователь вводит описание, система SHALL разделить известное и неизвестное. |
REQ-003 | WHEN найден критический unknown, система SHALL создать Question с вариантами ответа. |
REQ-004 | WHEN вопрос требует внешнего исследования, система SHALL сформировать research-запрос. |
REQ-005 | WHEN получен ответ, система SHALL сохранить его с источником и датой. |
REQ-006 | IF утверждение не проверено, система SHALL помечать его как unverified. |
24. Беклог PN — структура
Три секции: проектирование, разработка, исследования. Корневые коды PN-XX выдаёт мастер-беклог 01.lab. Задача без выхода и гейта в беклог не попадает.
24.1. Проектирование
Всё, что превращает сырой текст в проверяемые решения.
| ID | Задача | Выход | Зависит / гейт |
|---|---|---|---|
PN-01 | Модель Project Context | схема FACT / ASM / DEC / Q / REQ | бриф · D1 |
PN-02 | Question Bank 82 и статусы | вопросы с вариантами и связями | PN-01 · D1–D3 |
PN-03 | Discovery Gates D0–D6 | чек-листы pass/fail | PN-02 · D3 |
PN-04 | Navigator: следующий вопрос | формула §9 в коде | PN-02 · D3 |
PN-05 | Domain Pack «Согласования Москвы» | 7 организаций: пакеты, нормы, сроки | PN-01 · D4 |
PN-06 | Генераторы SDD и беклога | spec.md, backlog.md с трассировкой | PN-04 · D5–D6 |
24.2. Разработка
Реализация контура — по зависимостям, а не по желанию.
| ID | Задача | Выход | Зависит / гейт |
|---|---|---|---|
PN-07 | Context store + event log | API хранения, provenance | PN-01 · D6 |
PN-08 | Web Workbench: объект, чек-листы, таймлайн | экраны 1–3, статусы | PN-05 · D6 |
PN-09 | LLM router, prompt compiler, cache | выбор модели, лимиты | PN-01 · D6 |
PN-10 | Импорт/экспорт контекста | md / yaml / json | PN-07 · D6 |
PN-11 | Deploy: nginx + api + worker | контур §18.2, бэкап, мониторинг | PN-07 · D6 |
PN-12 | Доступ и роли (MVP: один пользователь) | вход, сессии, права | PN-08 · — |
24.3. Исследования
Исследование закрывается артефактом и DEC, а не «стало понятнее».
| ID | Задача | Выход | Зависит / гейт |
|---|---|---|---|
PN-R1 | Market scan текущих решений | таблица сравнения, вывод | — · D4 |
PN-R2 | Нормативная база по 7 организациям | KB со ссылками и датой | PN-05 · D4 |
PN-R3 | Интервью с проектировщиками (5–10) | боли, сроки, отказы | — · D1 |
PN-R4 | Бенчмарк моделей на вопросах банка | качество / цена | PN-09 · D3 |
PN-R5 | Проверка сроков на 2–3 объектах | калибровка прогноза | PN-R2 · D4 |
25. Самый первый MVP
Скоуп первого MVP по приоритетам. MUST — без этого продукта нет; WON’T — осознанно не делаем.
| Приоритет | Состав |
|---|---|
| MUST 12 пунктов |
Создание проекта · ввод идеи · определение неизвестностей · генерация вопросов с вариантами · интерактивный Project Flow · research-промпт · приём и сохранение ответа · выделение FACT/ASM/DEC · перестроение следующего шага · экспорт контекста · первичный SDD и беклог. |
| SHOULD 6 пунктов |
Gantt · Context Map · несколько LLM-провайдеров · staging-цикл · citations/provenance · визуальные зависимости. |
| COULD 7 пунктов |
Multimodal-файлы · голосовой ввод · BIM · автоматический web-research · интеграции с PM · автосоздание репозитория · автоматический deploy. |
| WON’T не делаем |
Полноценная ERP · BIM-coordination · бухгалтерия · CRM · юридически значимые авторешения · полная замена PM. |
Границы первого этапа: не строим Project OS, собственную LLM, сложный RAG, multi-agent swarm, BIM-интеграцию, 20 интеграций, Gantt-SaaS, ERP.
Первый доказуемый результат: проектировщик вводит объект → PN показывает, чего не хватает → задаёт вопросы → формирует пакет документов по организациям → считает срок → выдаёт чек-лист и беклог.
26. Особый сценарий Construction Navigator
Первый прикладной сценарий PN — согласования в строительстве Москвы. Домен задаётся пакетом, а не кодом.
Детали задачи, доменный пакет, метрики пилота и дисклеймер — в отдельном документе PN-02-TSK «Согласования Москвы».
| Параметр | Значение |
|---|---|
| Объект что ведём | Здание или сооружение в Москве; ПД/РД, стадия, очередь, заказчик, генпроектировщик. |
| Организации с кем согласуем | Мосводоканал · Мосводосток · МОЭК · ГУП «Московский метрополитен» · Россети · Моссвет · Мосгаз. |
| Пакет документов что подаём | Состав по каждой организации: разделы, справки, акты, ЭЦП, форматы; чего обычно не хватает. |
| Нормы на что ссылаемся | СП, ГОСТ, отраслевые регламенты, внутренние требования сетевых организаций — с датой проверки. |
| Сроки что прогнозируем | Оценка по каждому согласованию и по циклу с учётом параллельности; критический путь. |
| Артефакты что отдаём | Чек-лист пакета, таймлайн, напоминания, разбор отказа, отчёт по объекту. |
27. Construction Knowledge Base
Домен хранится как данные с provenance: каждая норма и срок имеют источник и дату.
| Раздел | Что содержит | Источник |
|---|---|---|
| Организации | Карточки 7 организаций: подразделения, контакты, каналы подачи, режим работы. | Официальные сайты, регламенты |
| Пакеты | Состав пакета на согласование, формы, требования к оформлению. | Регламенты организаций |
| Нормы | СП, ГОСТ, ФЗ и отраслевые требования с привязкой к разделу проекта. | НПА, дата проверки |
| Сроки | Нормативные и фактические сроки по типам согласований. | Регламенты + кейсы |
| Отказы | Типовые причины отказов и как их снять. | Практика, интервью |
| Артефакты | Шаблоны писем, чек-листы, примеры заполнения. | Проектная практика |
28. Human-in-the-loop
Три режима действий. Режим определяется ценой ошибки, а не удобством.
| Режим | Что можно | Условие |
|---|---|---|
| Autonomous без человека | Читать, анализировать, задавать вопросы, сохранять FACT с provenance. | Действие обратимо и не меняет проект. |
| Confirm подтверждение | Менять DEC/REQ, запускать research, формировать SDD и беклог. | Человек видит варианты и цену. |
| Forbidden запрещено | git init/push, deploy, удаление проекта, юридически значимые решения. | Только по явному подтверждению с формулировкой последствий. |
20. MVP должен быть event-driven по логике Context
Каждое существенное действие создаёт событие:
QuestionCreated
QuestionAnswered
ResearchStarted
ResearchReceived
FactAdded
FactVerified
DecisionProposed
DecisionApproved
RequirementCreated
TaskCreated
GatePassed
Это позволит в будущем строить:
- audit trail;
- историю проекта;
- аналитический слой;
- автоматические уведомления;
- восстановление состояния;
- agent memory.
21. Минимальная БД
Для первого MVP не следует сразу проектировать сложную распределённую систему.
Минимальные сущности:
projects
questions
research_runs
responses
sources
facts
assumptions
decisions
requirements
tasks
dependencies
artifacts
events
Связи:
Project
├── Questions
├── Research
├── Facts
├── Decisions
├── Requirements
├── Tasks
└── Artifacts
22. Технологический выбор
На первом этапе PN не должен заранее фиксировать конкретный стек без исследования.
Использовать /arch:
/arch: стек для Project Navigator MVP
Критерии:
- скорость MVP
- стоимость
- простота эксплуатации
- multimodal support
- streaming
- persistence
- безопасность
- возможность дальнейшего масштабирования
Обязательно сравнить минимум два реальных варианта.
После выбора создать ADR:
ADR-001: Architecture for Project Navigator MVP
29. System Prompt PN
Минимальная версия системного prompt:
Ты — Project Navigator, агент проектирования сложных проектных систем.
Твоя задача — не сразу реализовывать идею, а провести пользователя
от неопределённой постановки к проверенному проектному решению
и затем к MVP.
Всегда:
1. Сначала определи текущее состояние проекта.
2. Не додумывай отсутствующие требования.
3. Явно отделяй факт, предположение, решение и вопрос.
4. Выбирай следующий вопрос по его влиянию на проект.
5. При необходимости запускай исследование через отдельный prompt.
6. Сохраняй provenance полученных знаний.
7. Для архитектурных решений рассматривай альтернативы.
8. Используй Builder / Challenger / Verifier / Synthesizer как
отдельные когнитивные роли.
9. Не переходи к реализации до прохождения соответствующего gate.
10. Каждое существенное изменение должно быть связано с артефактом
или задачей backlog.
11. Для новой функциональности используй SDD.
12. Перед deployment выполняй verification и smoke checks.
13. Спорные решения передавай человеку.
Главный принцип:
не максимизируй количество сгенерированного текста;
максимизируй уменьшение неопределённости и трассируемость решений.
30. Протокол одной итерации PN
| Шаг | Действие | Выход |
|---|---|---|
| 1 | Понять, какая неизвестность дороже всего. | Один приоритетный вопрос с обоснованием |
| 2 | Задать вопрос и дать варианты ответа. | Q с 2–4 вариантами и связями |
| 3 | Если нужен research — сформировать запрос. | Research-задача с критерием приёмки |
| 4 | Получить ответ, извлечь FACT и ASM. | Записи с источником и confidence |
| 5 | Обновить контекст и пересчитать зависимости. | Context обновлён, связи актуальны |
| 6 | Проверить гейт и выбрать следующий вопрос. | Gate log, следующий шаг |
31. Реализация через 01.lab
Порядок запуска проекта PN в существующем фреймворке.
| Шаг | Действия | Проверка |
|---|---|---|
| Phase 0 · Bootstrap | Прочитать quick_start, general_rules, classification,
code_registry, staging, skills_reference,
SDD_spec_driven_development, prompting,
CONV_project_structure, FLOW. |
Рабочее место, git, Gitea, скилы, генерация HTML, CI/CD |
| Phase 1 · Registration | Создать проект PN в 01.lab; verticals: GEN, WWW, AI;
для web-MVP — составной проект; зарегистрировать код в code_registry. |
README.md, Project_overview.md созданы |
31.1. Скилы 01.lab, которые оркестрирует PN
/explore /discuss /process:cjm /process:uc
/process:bp /arch /sdd:specify /sdd:plan
/sdd:tasks /sdd:implement /backlog
/doc /html_doc /deploy /report
PN не дублирует эти скилы, а вызывает их и добавляет состояние, гейты и трассируемость. Если скил уже есть в 01.lab — в PN он не пишется заново.
32. Фазы 2–10
Фазы идут последовательно, но допускают возврат: новый факт может вернуть проект назад (§16).
| Фаза | Действия | Результат | Гейт |
|---|---|---|---|
| 32 · Research D2–D3 | Создать RSR / QST / GLS; исследовать пользователей, аналоги, архитектуры, модели контекста, LLM-оркестрацию, provenance, HITL, 01.lab. | RSR → вопросы → гипотезы | |
| 33 · CJM D3 | /process:cjm: путь от идеи до MVP и выкладки; точки боли и этапы. | CJM | |
| 34 · Architecture D4 | /arch: сравнить монолит, модульный монолит, event-oriented; для MVP — минимальная архитектура. | ADR, схема §18.1 | |
| 35 · SDD D5 | spec.md, plan.md, tasks.md; требования REQ-001…006 с acceptance. | SDD | |
| 36 · MVP Backlog D6 | Мастер-беклог MUST / SHOULD / COULD / WON’T; волны PN-01…16. | Беклог §24 | |
| 37 · Build D6 | Малые волны: spec → task → test → implementation → verify. Без big bang. | Работающий инкремент | |
| 38 · Verification D6 | Completeness · correctness · coherence. Замечания: CRITICAL / WARNING / SUGGESTION. | Verify-report | |
| 39 · Git / CI D6 | feat/<scope> → commit → push → PR → CI → Verifier → merge; protected main; lint, test, build. | Зелёный пайплайн | |
| 40 · Deployment D6 | /deploy:dev, :prod, :rollback, :status; dev → verification → prod. | Контур §18.2 | |
| 41 · Smoke test D6 | HTTP 200, вход, проект, вопрос, промпт, ответ, контекст, следующий шаг; UI рендерится, состояние сохраняется. | Smoke-чек-лист |
42. Отчёт PN
Отчёт — обязательный артефакт после каждой сессии, а не пересказ. Скил: /report.
| Блок | Что писать |
|---|---|
| Цель сессии | Один вопрос или решение, которое закрывали. |
| Исследовано / известно | Источники, факты; что подтвердилось, что осталось предположением. |
| Решено | DEC-записи с причиной и альтернативами. |
| Реализовано / проверено | Изменения и чем проверены: тест, кейс, эксперт. |
| Заблокировано | Открытые вопросы и что мешает пройти гейт. |
| Следующий шаг | Один вопрос, который берём в работу. |
43. Метрики MVP
| Метрика | Как считать | Ориентир |
|---|---|---|
| Discovery efficiency | Сколько вопросов до первого SDD и сколько времени. | ≤ 2 недель до SDD |
| Question quality | Доля ответов, ставших DEC, а не «переспросили». | ≥ 70% |
| Context quality | Доля FACT с источником и датой проверки. | ≥ 90% |
| Traceability | Доля задач беклога с REQ/DEC-связью. | 100% |
| MVP velocity | Закрытых задач беклога в неделю. | растёт |
| Rework | Доля переделок из-за поздних требований. | снижается |
44. Главная экспериментальная гипотеза
PN оценивается не как «ещё один AI PM», а как способ уменьшить переделки за счёт исследования и контекста до кода.
| Что сравниваем | Обычный путь | PN |
|---|---|---|
| Маршрут | Idea → coding agent → MVP | Idea → вопросы → контекст → дизайн → спека → MVP |
| Время | быстрее старт | дольше старт, меньше переделок |
| Требования | поздние находки | неизвестности снимаются до кода |
| Проверка | по ощущению | acceptance criteria и трассировка |
| Метрики | время до MVP | переделки, поздние требования, полнота acceptance |
46. Definition of Done первого PN MVP
| Критерий | Проверка |
|---|---|
| Контекст | Проект заводится, FACT/ASM/DEC/Q сохраняются с provenance. |
| Вопросы | PN задаёт следующий вопрос из банка §54 с вариантами и связями. |
| Research | Запрос формируется, ответ принимается как FACT или остаётся unresolved. |
| Артефакты | Генерируются SDD и беклог по трём секциям. |
| Домен | Для 7 организаций доступен пакет документов и прогноз срока. |
| Эксплуатация | Развёрнуто по §18.2, бэкап и мониторинг включены. |
47. Следующая итерация после MVP
После подтверждения MVP:
PN Core
│
├── Construction Pack
│ ├── organizations
│ ├── standards
│ ├── approvals
│ └── schedules
│
├── Startup Pack
│
├── Research Pack
│
└── Custom Domain Pack
Именно здесь можно начать превращать PN в общую платформу для ваших специализированных ассистентов.
47.1. Развитие по слоям
Развивать PN следует не по списку «фич», а по слоям — каждый следующий использует предыдущий:
L0 — Idea L5 — Design
L1 — Questions L6 — Specification
L2 — Research L7 — Backlog
L3 — Context L8 — Build
L4 — Decisions L9 — Deploy
L10 — Operate
Не строить L8, если L3–L6 не дают устойчивого результата.
48. Целевая архитектура экосистемы
PROJECT NAVIGATOR
│
┌──────────────┼──────────────┐
│ │ │
DISCOVERY DESIGN BUILD
│ │ │
└──────────────┼──────────────┘
│
PROJECT CONTEXT
│
┌──────────┴──────────┐
│ │
PROJECT SYSTEM SPECIALIZED
│ ASSISTANTS
│ │
├── Construction ─────┤
├── Startup ──────────┤
├── Nutrition ────────┤
└── Other ────────────┘
Таким образом, PN может стать верхним уровнем вашей группы проектов, а специализированные ассистенты — доменными системами, которые используют общий принцип Project Context и Navigator.
51. Первый запуск агента — инструкция оператору
При первом запуске PN оператор должен дать:
1. Название проекта
2. Исходное описание идеи
3. Что уже известно
4. Что уже существует
5. Кто пользователь
6. Какой желаемый результат
7. Ограничения
8. Существующие документы
9. Существующий код, если есть
10. Что считается MVP
После этого PN не должен начинать разработку.
Он должен вывести:
PROJECT STATUS
Goal:
...
Known:
...
Unknown:
...
Critical questions:
1. ...
2. ...
3. ...
Dependencies:
...
Recommended next action:
...
Current gate:
D1 — Goal
Required artifact:
QST_questions.md
И только после ответа пользователя продолжать цикл.
52. Команды PN
Рекомендуемый минимальный интерфейс:
pn:start
pn:status
pn:map
pn:questions
pn:research
pn:context
pn:decisions
pn:design
pn:spec
pn:backlog
pn:build
pn:verify
pn:deploy
pn:report
Дополнительно:
pn:why
Показывает:
Почему PN считает это следующим действием?
И:
pn:trace {id}
Показывает:
Goal
↓
Question
↓
Research
↓
Fact
↓
Decision
↓
Requirement
↓
Task
↓
Code
↓
Test
Это должно стать одной из ключевых функций системы.
53. Контрольный принцип для самого агента
Если PN не знает, что делать дальше, он не должен придумывать задачу.
Он должен выполнить:
1. Inspect current state
2. Find missing information
3. Rank unknowns
4. Ask or research
5. Update context
6. Re-evaluate
И только затем продолжить.
Это фундаментальная разница между Project Navigator и обычным «AI-агентом, который старается что-нибудь сделать».
55. Рекомендуемый ближайший порядок работ
STEP 1
Ответить на 15 открытых вопросов
↓
STEP 2
Создать QST + RSR
↓
STEP 3
Определить PN MVP
↓
STEP 4
CJM + Project Flow
↓
STEP 5
Architecture comparison + ADR
↓
STEP 6
SDD specification
↓
STEP 7
Master backlog
↓
STEP 8
Project Context prototype
↓
STEP 9
Question Engine
↓
STEP 10
Flow UI
↓
STEP 11
Research Prompt Engine
↓
STEP 12
Response ingestion
↓
STEP 13
Context / Decision layer
↓
STEP 14
SDD + backlog generation
↓
STEP 15
CI / deploy
↓
STEP 16
Construction Pack
57. Финальный критерий архитектуры
Project Navigator = Context Engineering + Project Design + AI Orchestration + Spec-Driven Delivery.
IDEA → QUESTIONS → RESEARCH → CONTEXT → DECISIONS → DESIGN → SPEC → BACKLOG → MVP
Если после реализации PN его можно заменить одним большим prompt:
"Проанализируй проект и сделай ТЗ"
— архитектура PN не удалась.
Если же PN способен:
- вести состояние;
- помнить решения;
- задавать следующий вопрос;
- понимать зависимости;
- запускать исследования;
- сравнивать ответы;
- сохранять provenance;
- строить карту;
- проходить gates;
- порождать SDD;
- порождать backlog;
- запускать существующие skills;
- проверять результат;
- возвращаться к незакрытым вопросам;
— тогда это действительно Project Navigator, а не чат с красивым интерфейсом.
Лист изменений
История версий документа. Новые записи — сверху.
| Версия | Дата | Изменения |
|---|---|---|
| 0.18 | 2026-11-10 | Выделен отдельный документ PN-02-TSK: задача, пользователь (РПГ), 7 организаций, MVP с моками интеграций, нормативная база, демо-объект, метрики эффективности, роли и дисклеймер. Из §26 добавлена ссылка. |
| 0.17 | 2026-11-10 | Домен сужен до строительства: в вопросах D01 и F01 убраны гранты, foodtech и нутрициология, заменены типами объектов; вопрос F16 переведён на системы заказчика (сметы, BIM, ЭДО). Восстановлена секция 30 и якоря слоёв/карты. |
| 0.16 | 2026-11-10 | «Простыни» §1, §5, §8, §10, §12, §31 сжаты в таблицы и двухрядные цепочки (01.lab / PN): вместо стрелочных диаграмм — компактные строки, вместо списков — таблицы с бейджами. |
| 0.15 | 2026-11-10 | Восстановлены и переведены в табличный вид разделы 19, 23–28, 30, 32–46 (экраны, SDD, беклог, MVP-скоуп, Construction, HITL, протокол итерации, фазы, отчёт, метрики, гипотеза, DoD); фавикон заменён на кисть (метафора очистки). |
| 0.15 | 2026-11-10 | Восстановлены и переведены в табличный вид разделы 19, 23–28, 30, 32–46 (экраны, SDD, беклог, MVP-скоуп, Construction, HITL, протокол итерации, фазы, отчёт, метрики, гипотеза, DoD); фавикон заменён на кисть (метафора очистки). |
| 0.14 | 2026-11-10 | «17. Артефакты PN» переведён в компактную таблицу (блок / состав / гейт); под каждым заголовком первого уровня добавлена кнопка «Промпт для LLM» — открывает попап с готовым промптом по разделу и копированием в буфер. |
| 0.13 | 2026-11-10 | Из левого меню убран избыточный уровень детализации: удалены подпункты гейтов D0–D6, ролей, режимов и экранов — они теперь строками таблиц внутри своих разделов; в меню остались ссылки уровня разделов. |
| 0.12 | 2026-11-10 | Разделы «роли», «режимы», «гейты», «экраны» и «фазы» переведены в компактный табличный вид по эталону CLEANUP_LOG (tbl-3 + colgroup + col-key/note/badge); десять тонких секций фаз 32–41 сведены в одну таблицу с сохранением якорей. |
| 0.11 | 2026-11-10 | Табы переразмечены по смыслу: «Бизнес-постановка и функционал» — бриф, вопросы, модель, сценарии, экраны, гейты, беклог, фазы, метрики; «Идеи по реализации» — кодовая модель, архитектура и развёртывание, БД, стек, промпты, реализация через 01.lab, команды и критерии. Меню фильтрует ссылки по принадлежности раздела. |
| 0.10 | 2026-11-10 | Секция «7. Источник → факт → документ» упразднена: протокол сжат в блок высотой 50 px внутри §6.5, справа от абзаца — закруглённый виджет-цитата с промптом для дальнейшей проработки утверждения. |
| 0.9 | 2026-11-10 | Меню слева разделено на два таба («Бриф» / «Техника») и синхронизировано с табами документа: показываются только разделы активного таба. В шапке меню и в шапке документа добавлено время генерации (10.11.2026 13:18). |
| 0.8 | 2026-11-10 | Документ разделён на два таба в шапке: «Бриф проекта · сбор информации и предложения» и «Техническое описание»; в технический таб добавлены wireframes четырёх экранов MVP (объект, вопрос, таймлайн согласований, гейт D3); переход по внутренним ссылкам автоматически переключает нужный таб. |
| 0.7 | 2026-11-10 | в начале документа добавлен блок «Как работать с документом»: сценарий в 4 шага, четыре готовых промпта (первичный разбор сырого текста, добор вопросов, фиксация решений и беклога, проверка на прочность) и маршрут по разделам. |
| 0.6 | 2026-11-10 | добавлены интерактивные схемы: 18.1 логическая архитектура (5 слоёв, клик по блоку подсвечивает связи) и 18.2 схема развёртывания (dev → CI → registry → VPS, бэкапы, мониторинг, внешние LLM и порталы). |
| 0.5 | 2026-11-10 | убран дубль заголовка документа; бриф переписан под предметную задачу: согласование ПД/РД с эксплуатирующими организациями Москвы (Мосводоканал, Мосводосток, МОЭК, метрополитен, Россети, Моссвет, Мосгаз), место в цикле ИСП и сужение MVP до одного города и семи организаций; дублирующая секция брифа удалена. |
| 0.4 | 2026-11-10 | банк вопросов вынесен в начало документа как рабочий раздел (нумерация 54 сохранена для совместимости ссылок); добавлена секция 54.5 «Доменная специфика и экспертиза» (14 вопросов, всего 82); добавлена секция 54.6 «Как обсуждать вопрос с LLM» — шаблон промпта, пример для O01 и правила разговора; таблицы переведены на фиксированную раскладку без горизонтального скролла (на узких экранах — карточки). |
| 0.3 | 2026-11-10 | банк вопросов расширен: добавлена секция 54.4 «Организационные и инфраструктурные вопросы» (14 вопросов: аккаунты Claude/OpenAI, оплата API, хостинг, домены/SSL, репозиторий и CI, мониторинг, бэкапы, доступы, команда, подрядчики, юрлицо, продажи, поддержка, данные и приватность); итого 68 вопросов, добавлена «Волна 0 · организационная». В меню подсекции 54.1–54.4 вынесены отдельными пунктами. |
| 0.2 | 2026-11-10 | меню перестроено в 12 блоков (бриф → модель → вопросы → карта → роли и скилы → режимы и гейты → экраны → артефакты → управление → фазы → метрики → решения); добавлена секция 14.7 «Скилы PN» (банк S01–S23, карта «скилы в гейтах», контракт скила); секция 54 переработана в банк из 54 вопросов: 54.1 — 12 архитектурных, 54.2 — 18 функциональных, 54.3 — 24 бизнес-вопроса, у каждого — варианты ответа, влияние на проект и связи; добавлены волны снятия вопросов и карта зависимостей. |
| 0.1 | 2026-11-10 | первый проектный документ PN: концепция агента, state machine, Project Context, Question Engine, research orchestration, staging, discovery gates, MVP scope, SDD/backlog/deploy flow и Construction domain-pack. |