01.LAB · PROJECT NAVIGATOR

PN-01-TEC — Project Navigator

Техническое решение · домен ИСП · согласование ПД/РД с эксплуатирующими организациями Москвы

КодPN-01-TECТипTECСтатусDraft / DesignФреймворк01.labСгенерировано10.11.2026 15:38Скилыhtml-doc · ui-mock · researcher

Как работать с документом

Этот документ — не «ТЗ для чтения», а рабочий сценарий: вы даёте модели сырой текст, она задаёт вопросы и предлагает варианты, вы фиксируете решения. Всё остальное (архитектура, беклог, фазы) — следствие этих решений.

Шаг 1
Забросить текст
бриф, письмо заказчика, описание объекта, замечания — как есть
Шаг 2
Попросить вопросы
3–5 вопросов из §54 + варианты ответа и цена каждого
Шаг 3
Выбрать вариант
или «другое» своей формулировкой → это станет DEC
Шаг 4
Зафиксировать
DEC и открытые вопросы в контекст; гейт не пройден — стоп

Сценарий за 20 минут

  1. Забросьте текст в чат. Не редактируйте и не сокращайте: модели нужны формулировки заказчика, включая противоречия.
  2. Попросите вопросы, а не решение. Модель обязана выбрать вопросы из банка §54 (с ID) и для каждого дать 2–4 варианта ответа с последствиями.
  3. Ответьте вариантом. «Обсудим потом» — не ответ. Либо выбор варианта, либо явное «не знаю, нужен research» (тогда вопрос уходит в Q-статус research).
  4. Зафиксируйте и проверьте гейт. Ответы → 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 остаётся методологическим ядром, домен — продаваемым пакетом.

Рабочая гипотеза MVP: гибрид A + B, но с жёстким сужением домена — Москва, семь эксплуатирующих организаций, один-два типа объектов. Проверяем две метрики: сокращение срока согласования и снижение числа отказов по формальным причинам.
Ключевой вопрос выбора: PN — это инструмент одного проектировщика, рабочее место проектного бюро или платформа для застройщика? От ответа зависят хранение контекста, роли, API, деплой и границы MVP (см. B04, B12, O03 в §54).

Project Navigator — проектирование, настройка и развёртывание агента

ВОПРОСЫ ДЛЯ РЕШЕНИЙ · РАБОЧИЙ РАЗДЕЛ, ВЫНЕСЕН В НАЧАЛО

54. Вопросы для принятия архитектурных, функциональных, бизнес-, организационных и доменных решений

Банк вопросов — рабочий интерфейс между заказчиком и PN: каждый вопрос имеет варианты ответа, влияние на проект и связи с другими вопросами. Пока вопрос не отвечен, связанные части архитектуры и MVP остаются в статусе ⚠️ draft. Раздел вынесен в начало как рабочая панель: сначала вопросы и решения, затем модель, реализация и метрики.

Порядок важен не полностью: бизнес-часть (54.3) исследуется параллельно функциональной (54.2), а не после утверждения технической архитектуры. Ответ на B04 («продукт или инструмент») и B12 («SaaS или on-prem») может изменить A01–A04 — поэтому их нельзя фиксировать раньше.
54.1 Архитектура
12
платформа, LLM, Context, гейты, границы агента
54.2 Функции
18
сценарии, вопросы, стадии, артефакты, вертикали
54.3 Бизнес
24
ЦА, боль, модель, тарифы, PMF, развитие
54.4 Организация
14
доступы, LLM-аккаунты, хостинг, команда, продажи
54.5 Домен
14
нормативка, источники, артефакты, экспертиза
Всего
82
5 волн снятия — см. ниже

Как читать таблицы

  • 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-бюджет.

Карта зависимостей (ключевые кластеры)

КластерКорневой вопросЗависимые вопросы
Продукт или инструментB04A01, A11, F16, B07, B12, B23
Контур развёртыванияB12 · B13A01, A04, A02
Границы MVPB19F02, F13, A07, A09
Модель ContextA04F06, F07, F12, F17
Human-in-the-loopA10A05, A06, F10
LLM и стоимостьA02 · A03A08, F04, B11, B21
ВертикалиB06, B14–B16F14, F15
Валидация ценностиB17B18 → B20 → B21
Доступы и деньги на APIO01 · O02A02, A03, B21
ИнфраструктураO03A01, A04, O04–O08, B12
Команда и подрядчикиO09 · O10O11, B21, сроки MVP
Юр. обвязка, продажи, поддержкаO11–O13B07, B08, B17, B23
Данные и приватностьO14A04, B12, B13, O08
Домен и нормативкаD03D04, D09, D13
Доменная экспертизаD02D08, D12, D14
Домен в продуктеD01 · D06D05, D07, D10, B19

54.1. Технические и архитектурные вопросы 12

IDВопросВарианты ответаВлияние на проектСвязи
A01Где должен работать PN?OpenCode-агент (скилл/CLI)отдельный сервис с APIweb-appdesktopкомбинацияОпределяет наличие UI, API и авторизации, стек и состав экранов §19.
A02Какая LLM основная и какие дополнительные?одна модель (OpenAI / Anthropic / Gemini)роутинг моделей по ролямлокальная / self-hostedгибридКачество вопросов и стоимость; активирует §13 мультимодельный режим.
A03PN сам вызывает LLM API или только генерирует промпты?только промпты для внешних агентовпрямые вызовы через проксигибрид (MVP на промптах)Биллинг, квоты, хранение ключей, задержки; включает Research Engine §12.
A04Где и в каком виде хранится Project Context?файлы в git (markdown/yaml)SQLitePostgresobject storageгибридМодель данных §21, event-driven §20, версии, многопользовательский режим.
A05Нужна ли автоматическая инициализация Git-репозитория?нет, вручнуюпо подтверждению человекаавтоматически при регистрации проектаPhase 9 и DoD; риск необратимых действий в чужом проекте.
A06Нужен ли авто-deploy или только генерация проекта?нет, только артефактыгенерировать проект + инструкцииdeploy по подтверждениюполный deployГраницы Phase 10 и матрицы §28, требования к окружениям.
A07Нужна ли работа с PDF / DOCX / XLSX / изображениями в MVP?неттолько чтение/парсингполный ingest с OCRОбъём MVP, качество FACT, стоимость парсеров.
A08Нужен ли web-research уже в первой версии?нет, только ручные источникиограниченный allow-list источниковполноценный researchОбъём Research Engine, стоимость и юридические риски.
A09Насколько Gantt обязателен для MVP?только Flow + Context Mapупрощённый Ganttполноценный GanttОбъём UI §10.2 и приоритет экранов §19.
A10Какие действия PN делает только после подтверждения человека?минимальный список (git init, deploy)расширенный (публикация, внешние API, удаление)все изменения ContextМатрица §28: безопасность против скорости итераций.
A11Где граница между PN и обычным coding-agent?PN — контекст и решенияPN + генерация промптовPN запускает coding-agentКлючевой ответ для §3 и §57: объём MVP и интеграции.
A12Какие части 01.lab PN использует напрямую?конвенции + скилы + шаблонытолько конвенциисвой стек без 01.labЗависимости §31, §56, скорость сборки и риск дублирования.

54.2. Функциональные вопросы 18

IDВопросВарианты ответаВлияние на проектСвязи
F01Какой первый реальный объект станет тестовым кейсом PN?жилой ЖК в Москвереконструкция зданияобъект инженерной инфраструктурыучебный кейс на реальном объектеDoD, выбор домен-пака, приоритет скилов.
F02Какие основные сценарии PN должен поддерживать в MVP?discovery до SDDполный цикл до deployтолько вопросытолько researchГраницы MVP §25 и состав экранов §19.
F03Должен ли PN сам формировать и приоритизировать вопросы?да, полностьюполуавтомат (человек подтверждает)нет, вопросы задаёт человекЯдро Question Engine §8–9, UX экрана 3.
F04Должен ли PN автоматически запускать research по выбранным вопросам?дапо подтверждениюнет§12 и стоимость: research — главный генератор расходов на LLM.
F05Как результаты research попадают в Project Context?авто-FACT с provenanceпредложения на ревьюручной вводУровень доверия к контексту, §6.5, UX экрана 5.
F06Может ли человек вручную править и подтверждать факты, решения, требования?да, любые записитолько подтверждениенет, только агентHITL, аудит и экран 5; влияет на A10.
F07Нужна ли история изменений Project Context?git-версииevent logснимки/снапшотынетОткат, аудит, §20; стоимость хранения.
F08Должен ли PN объяснять, почему задал вопрос или предложил решение?обязательно для всех записейтолько для критичныхне нужноДоверие и объём текста; влияет на отчёт §42.
F09Какие артефакты PN обязан генерировать?минимум: brief, context, SDD, backlogрасширенно: + CJM, ADR, promptsполный набор + кодDefinition of Done §46 и объём фаз §32–§41.
F10Должен ли PN сам переводить проект между стадиями IDEA → … → DEPLOY?автоматическипо гейтам с подтверждениемтолько вручную§16 гейты, UX, риск «поехали не туда».
F11Как пользователь видит состояние проекта и следующий шаг?dashboardотчёт по запросутолько чатЭкраны 1–2 и требования к UI.
F12Должен ли PN возвращаться на стадию назад при новых фактах?да, автоматическипо подтверждениюнетМодель состояний §16 и стоимость переработки.
F13Что входит именно в MVP, а что в следующие версии?минимум: вопросы + контекстрасширенно: + research + SDDполный циклСрок MVP и метрики §43.
F14Является ли Construction Navigator первым вертикальным пакетом?данет, сначала общий кейсвторой после пилотаДомен-пак S21 и приоритет рынка B06.
F15Какие функции Construction реализуются первыми?нормы/СП + чек-листысмета и ресурсыдокументооборотвсё сразуОбъём домен-пака и KB §27.
F16Как PN взаимодействует с системами заказчика (сметы, BIM, ЭДО)?общий протокол/APIобмен файлами ContextнезависимоЦелевая архитектура §48 и модель Context §29.
F17Нужна ли единая модель Project Context для всех ассистентов?да, общая схемапрофиль на ассистентасвоя у каждого§6 и миграции; прямо влияет на A04.
F18Должен ли PN создавать и полный набор инструкций для coding-agent?только контекст и инструкцииинструкции + кодполный цикл с проверкойГраница с coding-agent (A11) и скилы S14/S22.

54.3. Бизнес-вопросы: рынок, модель, тарифы и развитие 24

IDВопросВарианты ответаВлияние на проектСвязи
B01Для кого PN создаётся в первую очередь?индивидуальные разработчикипредприниматели/фаундерыкомандыкомпаниикорпорацииUX, тарифы и глубина контекста.
B02Какую проблему пользователь готов решать за деньги?хаос в требованияхпотеря контекста проектадолгий и дорогой discoveryконсультантыПозиционирование и акцент MVP.
B03Кто покупатель и кто конечный пользователь?совпадаютпокупатель — руководительпокупатель — инвестор/фондТарифы, отчёты, роли в UI.
B04PN — самостоятельный продукт, внутренний инструмент или платформа?внутренний инструмент 01.labсамостоятельный продуктплатформа для вертикалейгибридКлючевой вопрос: определяет архитектуру, деплой, лицензии и весь скоуп.
B05Чем PN принципиально отличается от AI coding agents и PM-решений?контекст и решения, а не кодвертикальные домен-пакиоркестрация скиловцена и простотаДифференциация и состав MVP.
B06Какой рынок первый?AI-разработкауправление проектамистроительствоконсалтингдругойДомен-пак, кейс F01, каналы.
B07Какая бизнес-модель?подпискаpay-per-useза проектза токеныкомбинированнаяБиллинг, лимиты, архитектура квот.
B08Какие тарифные планы нужны на старте?один тарифfree + proтри уровня (free/pro/team)enterprise по запросуUI биллинга, лимиты, go-to-market.
B09Что ограничивается тарифом?проектыобъём контекстаresearch-квотычисло LLMcollaborationdeployМодель данных квот и реальная стоимость обслуживания.
B10Нужен ли бесплатный тариф или trial?free с лимитами14 дней trialтолько demoнетКонверсия, стоимость LLM, антиабьюз.
B11Должна ли цена зависеть от потребления LLM/API?фиксированная ценаметрика токеновгибрид: база + оверджРоутинг моделей §13 и маржа; связано с A02/A03.
B12SaaS, on-premise или оба варианта?SaaSon-premiseгибрид (SaaS + private)Ключевой вопрос: хранилище A04, безопасность, поддержка.
B13Нужна ли корпоративная версия с изолированным контуром?да, в roadmapтолько on-premнетТребования к приватности и локальным LLM.
B14Как монетизировать вертикальные пакеты?отдельная подпискааддон к PNвключено в старший тарифлицензия на доменУпаковка, биллинг, партнёрства.
B15Вертикали продаются отдельно или в едином тарифе?отдельные продуктыединый тарифмикс: core + packsКаталог, UX покупки, цены.
B16Можно ли продавать knowledge/domain packs отдельно?да, маркетплейсда, но курирует 01.labнетЛицензирование контента, юридика, качество.
B17Кто первый потенциальный клиент и где его искать?свой круг и партнёрыстроительные компанииакселераторы и фондыонлайн-сообществаКейс F01, каналы, сроки валидации.
B18Как проверить product-market fit до разработки?5–10 интервью + ручной прогонлендинг и waitlistплатный пилототкрытый MVPЧто именно строить в MVP и какие метрики снимать.
B19Какой минимальный набор функций показывает ценность?вопросы + контекст + отчёт+ research+ SDD/backlogполный циклОпределение MVP; напрямую связано с F02/F13.
B20Какие KPI определят успех MVP?время до SDDчисло снятых вопросов% принятых решенийвозвраты/NPSпилотыМетрики §43 и приоритеты итераций.
B21Горизонт окупаемости и бюджет MVP?3–6 мес · до 10k$6–12 мес · 10–50k$12+ мес · >50k$Глубина MVP, объём research (A08), число моделей.
B22Каких конкурентов исследовать до выбора архитектуры?coding agentsPM/discovery-инструментыAI-orchestrationвертикальные консалтингиДифференциация и выбор архитектуры.
B23Какая стратегия выхода на рынок?собственный продуктB2B-пилотыпартнёрствовнутренний инструмент → продуктКлючевой вопрос: roadmap, команда, маркетинг.
B24Как должен выглядеть путь развития?PN Core → вертикали → экосистема → платформасразу платформатолько одна вертикаль§48–49 и архитектурные границы.

54.4. Организационные и инфраструктурные вопросы 14

Это не «техника» и не «бизнес»: без этих ответов проект просто не стартует — нет аккаунтов Claude/OpenAI, нет оплаты API, нет хостинга, домена, репозитория, команды и канала продаж. Волна 0 снимается параллельно всему остальному.

IDВопросВарианты ответаВлияние на проектСвязи
O01Есть ли аккаунты LLM: Claude (Anthropic), OpenAI, Google, локальные модели?есть всечастично (1–2 вендора)нет, оформляемдоступ через прокси/реселлераСроки старта и стоимость; определяет A02 (выбор моделей) и A03 (прямые вызовы API).
O02Как оплачиваются зарубежные API и сервисы?корпоративная картаюрлицо-нерезидентреселлер/агентнет платёжного средстваЮридические риски, лимиты и бюджет; без оплаты не работает ни research, ни LLM-режим.
O03Где размещается инфраструктура?VPS в РФ (Beget/Timeweb)VPS за рубежом (Hetzner и др.)облако (Yandex/Selectel/AWS)on-premОпределяет A01 (где работает PN), A04 (хранение Context) и B12 (SaaS/on-prem).
O04Какие домены, DNS и SSL выделены?основной домен + поддоменытолько поддомендоменов нетDNS у подрядчикаДеплой, почта, брендирование и доверие; блокирует публичный запуск.
O05Где живут репозитории и CI?GitHub + ActionsGitea (self-hosted)GitLabещё нетВлияет на A05 (git bootstrap), S16 и на передачу проекта между людьми.
O06Какие системы мониторинга, аналитики и логов нужны?минимум: логи + uptimeAPM/Sentryпродуктовая аналитика (Plausible/Umami)Grafana/метрикиЭксплуатация и KPI §43; без аналитики нельзя измерить ценность MVP.
O07Что бэкапим и с какими RPO/RTO?ежедневный бэкап БДбэкап Context + БД + конфиговтолько git-артефактыне продуманоРиск потери контекста проекта — главного актива PN; влияет на доверие и тарифы.
O08Как устроены доступы и безопасность?пароли + 2FASSOсекреты в vaultключи в .env на сервереA10 (подтверждения), B13 (корпоративный контур), требования аудита.
O09Кто в команде и какие роли закрыты?1 человек (всё сам)продукт + разработка+ дизайн+ тестирование/QAСроки MVP и распределение скилов S01–S23; определяет, что автоматизировать первым.
O10Нужны ли внешние подрядчики и какой бюджет?нет, только своидизайн на аутсорсеразработка на аутсорсеюр/бух — на аутсорсеСтоимость MVP, скорость, риски качества и передачи знаний.
O11Какая юридическая обвязка есть и нужна?ИП/ООО естьдоговор с клиентом + NDAоферта для SaaSлицензии на ПО/данныеB07/B12 (модель и контур), продажи и защита от претензий.
O12Кто и как продаёт? Каналы и CRMоснователь продаёт сампартнёры/интеграторысообщества и контентCRM/воронка уже естьB17/B23 (первый клиент, стратегия выхода); напрямую влияет на план пилота.
O13Как устроена поддержка пользователей?Telegram-чатпочта + база знанийSLA по тарифамподдержки нетЭксплуатационная нагрузка и упаковка тарифов B08.
O14Где хранятся данные клиентов и как соблюдается приватность?152-ФЗ: серверы в РФGDPR/ЕСгибрид по тарифамне проработаноB12/B13, A04 (хранение), договорённости с LLM-провайдерами; риск блокировки продукта.

54.5. Доменная специфика и экспертиза 14

Общие вопросы не описывают предметную область. Без домена PN выдаёт «правильные» вопросы общего вида: нормативка, первоисточники, типовые артефакты и проверка корректности — это то, что отличает доменный пак от просто промпта.

IDВопросВарианты ответаВлияние на проектСвязи
D01Какой тип объекта берём первым для доменного пака?жилой объектобъект инженерной инфраструктурыпромышленный объектреконструкция зданияНаполнение KB §27, скил S21 и первый тестовый кейс F01.
D02Кто доменный эксперт и доступен ли он проекту?в командепартнёр по договорувнешний консультантэксперта нетДостоверность фактов и приёмка доменного пака; влияет на O09 и O10.
D03Какая нормативная база обязательна?СП / ГОСТ / ФЗприказы и положения фондовотраслевые регламентынормативка не нужнаИсточники FACT и структура чек-листов; определяет D04 и D09.
D04Какие первоисточники домена и как их получать?открытые API и реестрыофициальные выгрузкипарсинг сайтоввручную, экспертомСтоимость и юридическая чистота research (A08); качество FACT S05.
D05Какие типовые артефакты домена PN обязан порождать?ТЗ / техзаданиесмета и расчётКП / коммерческое предложениеакт / заключениеСостав артефактов F09 и шаблонов доменного пака.
D06Какой уровень детализации домена нужен в MVP?термины + чек-листы+ нормы и ссылки+ расчёты и сметыполная модель доменаОбъём доменного пака и срок MVP (B19, F13); риск переусложнить первую версию.
D07Нужны ли интеграции с отраслевыми системами?1С / ERPBIM / Revit / CADExcel и файлыне нужныАрхитектура A01 и объём работ; влияет на A07 (форматы файлов).
D08Как проверяется доменная корректность ответов PN?ревью экспертаформальные правила и справочникитесты на реальных кейсахне проверяетсяДоверие к продукту и метрика correctness §38; определяет D14.
D09Нужен ли глоссарий и онтология домена?да, полный глоссарийминимальный словарь терминовбез глоссарияКачество вопросов и поиска; влияет на структуру KB §27.
D10Как домен влияет на упаковку и цену?отдельный платный паквключён в старший тарифлицензия на доменпока не влияетМонетизация B14–B16 и каталог продуктов.
D11Какие данные клиента доменно-чувствительны?коммерческая тайнаперсональные данныепроектная документацияпубличные данныеТребования к приватности O14 и хранению A04; риск утечки.
D12Кто владеет доменным контентом и его обновлением?01.labпартнёр-экспертсообщество практиковвладельца нетОтветственность за актуальность (D13) и юридические права на контент.
D13Как часто меняется нормативка и кто её отслеживает?ежеквартальнораз в годad hocне отслеживаетсяРегламент обновлений доменного пака и стоимость поддержки.
D14Как выглядит приёмка доменного пака?кейс с экспертомчек-лист требованийметрики точности на выборкеприёмки нетDefinition of Done §46 и метрики B20; защита от «пак есть, а пользы нет».
До ответов на волну 1 архитектуру реализации следует считать ⚠️ 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 должен:

  1. принять исходную идею проекта;
  2. определить уровень неопределённости;
  3. задать недостающие вопросы;
  4. построить интерактивную карту проекта;
  5. разбить неопределённости на исследовательские задачи;
  6. генерировать prompts для других LLM и/или экспертов;
  7. принимать и структурировать полученные ответы;
  8. накапливать Project Context;
  9. выявлять противоречия, неизвестные и риски;
  10. после прохождения discovery-gates перейти к проектированию;
  11. сформировать CJM, use cases, требования, архитектуру, UI/UX и backlog;
  12. определить границы MVP;
  13. реализовать MVP по правилам 01.lab;
  14. проверить результат;
  15. развернуть MVP;
  16. сформировать отчёт и следующий цикл развития.

Главный принцип:

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/
01.labидея → синхронизация → требования → беклог → проектирование → реализация → проверки → Git/PR → CI → deploy → smoke → анализ → отчёт
PNIDEA → DISCOVERY → PROJECT CONTEXT → DESIGN → SPEC → MVP → BUILD → VERIFY → DEPLOY → OPERATE

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

Каждый слой отвечает на один вопрос и не подменяет остальные.

СлойВопросЧто хранит / делает
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-DD

6.2. Предположение

id: ASM-001
statement: "..."
reason: "..."
impact_if_wrong: high | medium | low
status: open | verified | rejected

6.3. Решение

id: DEC-001
decision: "..."
context: "..."
alternatives:
  - "..."
  - "..."
reason: "..."
owner: "..."
status: proposed | approved | rejected

6.4. Вопрос

id: Q-001
question: "..."
importance: critical | important | optional
blocks:
  - "REQ-..."
  - "DEC-..."
status: open | research | answered | rejected

6.5. Протокол источника

PN не принимает «LLM сказала X» за истину: утверждение проходит цепочку и попадает в контекст только как FACT или unresolved. Строже всего — к нормативам, срокам, ценам, API и внешним ограничениям.

Источник→ Утверждение→ Проверка→ Факт / предположение→ Документ / решение→ Задача
✕ LLM → истина  ·  ✓ claim → source/confidence → verification → fact | unresolved

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). Роли нельзя смешивать в одном контексте.

РольЧто делаетВыход
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)

Роль отвечает на вопрос «кто думает», скил — «что именно выполняется». Роли из §14 не дублируют логику: они вызывают скилы. Один скил может вызываться несколькими ролями и гейтами, и наоборот.

Скил — переиспользуемая единица поведения с фиксированным контрактом: триггер → вход → выход → артефакт. Скилы — то, что PN оркестрирует, а не переизобретает: часть берётся из 01.lab, часть реализуется проектом (§31, §56).

Скилов в банке
23
S01–S23, контракт зафиксирован
В MVP
9
S01–S04, S07, S08, S18–S20
Следующие версии
14
research, дизайн, сборка, deploy
Точек вызова
6 ролей · 7 гейтов · 10 фаз
см. §14, §16, §32–§41

Банк скилов

IDСкилТриггер / вызовВходВыход → артефакт
S01Intake / Брифованиеинтервью до проектароль: Navigatorгейт: D0
старт продукта, сырой запрос заказчика
запрос, контекст, ограничения, доменbrief, выбор варианта A/B/C
S02Project Registrationрегистрация проектароль: Curatorгейт: D0фаза 1
подтверждённый бриф, владелец
паспорт проекта, границы, ролиproject record, repo layout
S03Question Decompositionлюбой открытый вопросроль: Navigatorгейт: D1–D3фаза 2
вопрос верхнего уровня, класс (Goal/User/Scope/Process/Constraints/Risk/Verification)
подвопросы и критерии ответаQ-узлы, дерево вопросов
S04Next-Question Selectionкаждая итерацияроль: Navigatorгейт: D1–D3фаза 2
Context, важность, стоимость, гейт
один приоритетный вопрос + обоснованиеnext-Q, формула §9
S05Normative Researchпо выбранному вопросуроль: Curatorгейт: D2фаза 2
вопрос, домен, allow-list источников
факты с источником и confidenceFACT-*
S06Alternatives Researchперед решениемроль: Navigatorгейт: D3фаза 2
решение/вопрос, ограничения
варианты с trade-off и ценой ошибкиASM-*, DEC-*
S07Fact Extraction & Provenanceпосле любого источникароль: Verifierгейт: D2фаза 2
документ, ответ эксперта, LLM-вывод
FACT с source_type и verifiedFACT-*, provenance
S08Assumption Trackingпри пробеле в знанияхроль: Challengerгейт: D2–D4фаза 2
незакрытые вопросы, допущения
ASM с impact_if_wrong и статусомASM-*
S09CJM Mappingпроектирование продуктароль: Builderгейт: D4фаза 3
сегменты, роли, этапы
карта пути и этапов, точки болиCJM
S10Architecture Draftпосле закрытия D3роль: Builderгейт: D4фаза 4
требования, ограничения, FACT/DEC
слои, компоненты, ADR, границыarchitecture, ADR
S11Red Team / Challengeперед фиксацией решенияроль: Challengerгейт: D4–D5фаза 4
драфт решения, предположения
риски, контрдоводы, failure modesCHAL-*
S12Spec Writing (SDD)после утверждения дизайнароль: Builderгейт: D5фаза 5
DEC, REQ, границы MVP
спецификация: требования, сценарии, приёмкаSDD
S13Backlog Slicingпосле SDDроль: Curatorгейт: D6фаза 6
SDD, приоритеты, ресурсы
MUST / SHOULD / COULD / WON’Tbacklog
S14Build Orchestrationреализацияроль: Builderгейт: D6фаза 7
backlog, промпты, существующие скилы 01.lab
план сборки и задачи для coding-agentbuild plan
S15Verificationпосле сборкироль: Verifierгейт: D6фаза 8
артефакты, требования, метрики
completeness / correctness / coherenceverify report
S16Git / CI Bootstrapпосле подтверждения человекагейт: D6фаза 9
подтверждение, структура проекта
репозиторий, ветки, pipelineCI config
S17Deploy & Smokeпосле подтверждения человекагейт: D6фаза 10
артефакт сборки, целевое окружение
deploy-план, smoke-результатdeploy report
S18Context Curationпостояннороль: Curator
накопленные FACT / ASM / DEC / Q
дедупликация, связи, актуальность, архивContext snapshot
S19Synthesis & Reportконец итерациироль: Synthesizerфаза 42
весь Context, лог гейтов
отчёт, следующий шаг, открытые вопросыREPORT
S20Gate Checklist Evaluationкаждый гейт D0–D6роль: Verifierгейт: D0–D6
чек-лист гейта, Context
pass / fail + чего не хватаетgate log
S21Domain Pack Loadстарт проектароль: Curatorгейт: D0фаза 1
домен (например, Construction)
термины, нормы, шаблоны, типовые рискиdomain pack
S22Prompt Compilationпередача внешнему ассистентуроль: Synthesizerгейт: D6фаза 7
Context, целевой coding-agent
пакет промптов и инструкцийprompt bundle
S23Metrics & Retroконец MVP-итерациироль: Synthesizer
лог итераций, метрики §43
KPI, выводы, корректировка процессаmetrics, retro

MVP-колонка не выводится отдельной колонкой: скилы MVP помечены в §25 (MUST) и в самом первом MVP.

Скилы в гейтах

ГейтСкилыАртефакты на выходе
D0 — IdeaS01, S02, S20, S21brief, project record, domain pack
D1 — GoalS03, S04, S20цель, границы, критерии успеха
D2 — ContextS05, S07, S08, S18, S20FACT/ASM, карта источников
D3 — UncertaintyS04, S06, S08, S18, S20снятые/принятые неопределённости
D4 — DesignS09, S10, S11, S20CJM, архитектура, риски
D5 — SpecificationS11, S12, S20SDD, правила MVP
D6 — MVPS13, S14, S15, S16, S17, S22, S20backlog, сборка, проверка, 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 — DesignCJM, use cases, process, варианты архитектуры, направление UI/UX.Design, ADR
D5 — SpecificationТребования, acceptance criteria, что вне scope, риски, зависимости.SDD
D6 — MVPCore 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 (скилы).

ИНТЕРФЕЙСЫОРКЕСТРАЦИЯКОНТЕКСТ ПРОЕКТАИССЛЕДОВАНИЕ И ЗНАНИЯПЛАТФОРМА И ИНТЕГРАЦИИWeb Workbench: Основной интерфейс MVP: карточка объекта, пакеты документов по организациям, статусы и напоминания.Web Workbenchобъект · чек-листы · таймлайнCLI / OpenCode: Работа без web-интерфейса: скилы, промпты, генерация артефактов в репозиторий.CLI / OpenCodeрежим одного проектировщикаREST API: Интеграции с внешними системами: CRM проектного бюро, 1С, порталы согласований.REST APIвебхуки · интеграцииNavigator: Выбирает приоритетный вопрос, ведёт итерацию и не смешивает роли.Navigatorследующий вопрос §8–9Skill Registry: Банк навыков с контрактом: триггер → вход → выход → артефакт.Skill RegistryS01–S23Gate Engine: Проверка готовности стадии: pass/fail и чего не хватает для перехода.Gate EngineD0–D6Роли 01.lab: Разделение когнитивных ролей: проектирование и проверка не смешиваются.Роли 01.labBuilder · Challenger · Verifier · Curator · SynthesizerProject Context: Центральный объект системы: факты, предположения, решения, вопросы с provenance.Project ContextFACT · ASM · DEC · Q · REQQuestion Bank: Вопросы с вариантами, влиянием и связями; статусы open / research / answered.Question Bank82 вопроса · 54.1–54.5Artifacts: Версионируемые артефакты проектирования, приёмки и отчётности.ArtifactsSDD · ADR · backlog · отчётыEvent Log / Provenance: Журнал изменений контекста и источник каждого факта.Event Log / Provenanceкто · что · когда · на основании чегоResearch Engine: Оркестратор исследования: формирует запросы, собирает ответы, пишет FACT.Research Engineнормативка · альтернативы · market scanDomain Pack «Согласования Москвы»: Мосводоканал, Мосводосток, МОЭК, метрополитен, Россети, Моссвет, Мосгаз.Domain Pack «Согласования Москвы»7 организаций · пакеты · срокиKnowledge Base: Первоисточники со ссылками и датой проверки — основа фактов.Knowledge BaseСП · ГОСТ · регламенты · шаблоныMarket Scan: Сравнение с coding agents, PM-инструментами и сервисами согласований.Market Scanтекущие решения §12.4LLM Router: Выбор модели по роли и бюджету, квоты, деградация на локальную модель.LLM RouterClaude · OpenAI · localPrompt Compiler: Собирает минимальный контекст и формат ответа, а не весь проект.Prompt Compilerсборка контекста под вопросCache & Usage: Кеш ответов, учёт токенов, лимиты по тарифу.Cache & Usageстоимость · лимиты01.lab: Методологическое ядро: не дублировать, а оркестрировать.01.labконвенции · скилы · шаблоныGit / CI / Deploy: Репозиторий, пайплайн, окружения и smoke-проверка.Git / CI / Deployрепозиторий и выкладкаинтерфейсыоркестрацияконтекстисследованиеплатформаинтеграции
Кликните по блоку схемы — покажу его роль и связи.
  • Единая точка правды — 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, а не дизайн-макеты.

PN · Объект
ЖК «Северный», корпус 3D3 · контекст
18недель прогноз
7организаций
2отказа
Мосводоканалсогласовано
Мосводостокв работе
МОЭКотказ · нет акта
Метрополитенв работе
Россети · Моссвет · Мосгаз3 из 3
Следующий шаг: дослать акт по МОЭК — без него повторная подача не пройдёт.
Экран 1 · карточка объекта: прогноз срока и статусы по организациям.
PN · Вопрос
A01 · Где работает PNкритичный
Где должен работать PN в MVP?
Web Workbench для проектировщика
Гибрид: CLI + минимальный web
Только CLI / OpenCode
Другое (своя формулировка)
Влияние: интерфейс, авторизация, объём MVP · Связи: B04B12O03
Экран 3 · вопрос: варианты, влияние и связи; ответ становится DEC.
PN · Согласования
Таймлайн · 18 недельплан / факт
Мосводоканал
Мосводосток
МОЭК
Метрополитен
Россети
Моссвет
Мосгаз
Критический путь: МОЭК → повторная подача → экспертиза. Напоминание за 10 дней.
Экран 2 · таймлайн согласований: параллельные ветки и критический путь.
PN · Гейт D3
Готовность к проектированию4 / 6
✓ Известны организации и предмет согласования
✓ Определён тип объекта и стадия
✓ Есть перечень разделов ПД/РД
✓ Зафиксированы сроки заказчика
✗ Не подтверждён состав пакета МОЭК Q-118
✗ Нет норм по пересечению с метрополитеном research
Гейт не пройден: два вопроса блокируют переход к D4. Артефакт: gate-D3.md
Экран 6 · гейт: чек-лист pass/fail и блокирующие вопросы.

23. SDD

Спецификация — не текст «для галочки», а три связанных артефакта с проверяемыми требованиями (§35).

АртефактЧто содержитГотово, когда
spec.md
что делаем
Требования REQ-* с acceptance criteria, границы scope, риски, зависимости.Каждое требование проверяемо и имеет источник
plan.md
как делаем
Архитектурные решения, последовательность, тесты, миграции.Понятно, что делать первым и почему
tasks.md
кто и когда
Задачи из §24 с выходом, зависимостью и гейтом.Каждая задача имеет артефакт приёмки
ТребованиеФормулировка
REQ-001Система SHALL создавать Project Context при регистрации проекта.
REQ-002WHEN пользователь вводит описание, система SHALL разделить известное и неизвестное.
REQ-003WHEN найден критический unknown, система SHALL создать Question с вариантами ответа.
REQ-004WHEN вопрос требует внешнего исследования, система SHALL сформировать research-запрос.
REQ-005WHEN получен ответ, система SHALL сохранить его с источником и датой.
REQ-006IF утверждение не проверено, система SHALL помечать его как unverified.

24. Беклог PN — структура

Три секции: проектирование, разработка, исследования. Корневые коды PN-XX выдаёт мастер-беклог 01.lab. Задача без выхода и гейта в беклог не попадает.

24.1. Проектирование

Всё, что превращает сырой текст в проверяемые решения.

IDЗадачаВыходЗависит / гейт
PN-01Модель Project Contextсхема FACT / ASM / DEC / Q / REQбриф · D1
PN-02Question Bank 82 и статусывопросы с вариантами и связямиPN-01 · D1–D3
PN-03Discovery Gates D0–D6чек-листы pass/failPN-02 · D3
PN-04Navigator: следующий вопросформула §9 в кодеPN-02 · D3
PN-05Domain Pack «Согласования Москвы»7 организаций: пакеты, нормы, срокиPN-01 · D4
PN-06Генераторы SDD и беклогаspec.md, backlog.md с трассировкойPN-04 · D5–D6

24.2. Разработка

Реализация контура — по зависимостям, а не по желанию.

IDЗадачаВыходЗависит / гейт
PN-07Context store + event logAPI хранения, provenancePN-01 · D6
PN-08Web Workbench: объект, чек-листы, таймлайнэкраны 1–3, статусыPN-05 · D6
PN-09LLM router, prompt compiler, cacheвыбор модели, лимитыPN-01 · D6
PN-10Импорт/экспорт контекстаmd / yaml / jsonPN-07 · D6
PN-11Deploy: nginx + api + workerконтур §18.2, бэкап, мониторингPN-07 · D6
PN-12Доступ и роли (MVP: один пользователь)вход, сессии, праваPN-08 · —

24.3. Исследования

Исследование закрывается артефактом и DEC, а не «стало понятнее».

IDЗадачаВыходЗависит / гейт
PN-R1Market 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 → MVPIdea → вопросы → контекст → дизайн → спека → 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.182026-11-10Выделен отдельный документ PN-02-TSK: задача, пользователь (РПГ), 7 организаций, MVP с моками интеграций, нормативная база, демо-объект, метрики эффективности, роли и дисклеймер. Из §26 добавлена ссылка.
0.172026-11-10Домен сужен до строительства: в вопросах D01 и F01 убраны гранты, foodtech и нутрициология, заменены типами объектов; вопрос F16 переведён на системы заказчика (сметы, BIM, ЭДО). Восстановлена секция 30 и якоря слоёв/карты.
0.162026-11-10«Простыни» §1, §5, §8, §10, §12, §31 сжаты в таблицы и двухрядные цепочки (01.lab / PN): вместо стрелочных диаграмм — компактные строки, вместо списков — таблицы с бейджами.
0.152026-11-10Восстановлены и переведены в табличный вид разделы 19, 23–28, 30, 32–46 (экраны, SDD, беклог, MVP-скоуп, Construction, HITL, протокол итерации, фазы, отчёт, метрики, гипотеза, DoD); фавикон заменён на кисть (метафора очистки).
0.152026-11-10Восстановлены и переведены в табличный вид разделы 19, 23–28, 30, 32–46 (экраны, SDD, беклог, MVP-скоуп, Construction, HITL, протокол итерации, фазы, отчёт, метрики, гипотеза, DoD); фавикон заменён на кисть (метафора очистки).
0.142026-11-10«17. Артефакты PN» переведён в компактную таблицу (блок / состав / гейт); под каждым заголовком первого уровня добавлена кнопка «Промпт для LLM» — открывает попап с готовым промптом по разделу и копированием в буфер.
0.132026-11-10Из левого меню убран избыточный уровень детализации: удалены подпункты гейтов D0–D6, ролей, режимов и экранов — они теперь строками таблиц внутри своих разделов; в меню остались ссылки уровня разделов.
0.122026-11-10Разделы «роли», «режимы», «гейты», «экраны» и «фазы» переведены в компактный табличный вид по эталону CLEANUP_LOG (tbl-3 + colgroup + col-key/note/badge); десять тонких секций фаз 32–41 сведены в одну таблицу с сохранением якорей.
0.112026-11-10Табы переразмечены по смыслу: «Бизнес-постановка и функционал» — бриф, вопросы, модель, сценарии, экраны, гейты, беклог, фазы, метрики; «Идеи по реализации» — кодовая модель, архитектура и развёртывание, БД, стек, промпты, реализация через 01.lab, команды и критерии. Меню фильтрует ссылки по принадлежности раздела.
0.102026-11-10Секция «7. Источник → факт → документ» упразднена: протокол сжат в блок высотой 50 px внутри §6.5, справа от абзаца — закруглённый виджет-цитата с промптом для дальнейшей проработки утверждения.
0.92026-11-10Меню слева разделено на два таба («Бриф» / «Техника») и синхронизировано с табами документа: показываются только разделы активного таба. В шапке меню и в шапке документа добавлено время генерации (10.11.2026 13:18).
0.82026-11-10Документ разделён на два таба в шапке: «Бриф проекта · сбор информации и предложения» и «Техническое описание»; в технический таб добавлены wireframes четырёх экранов MVP (объект, вопрос, таймлайн согласований, гейт D3); переход по внутренним ссылкам автоматически переключает нужный таб.
0.72026-11-10в начале документа добавлен блок «Как работать с документом»: сценарий в 4 шага, четыре готовых промпта (первичный разбор сырого текста, добор вопросов, фиксация решений и беклога, проверка на прочность) и маршрут по разделам.
0.62026-11-10добавлены интерактивные схемы: 18.1 логическая архитектура (5 слоёв, клик по блоку подсвечивает связи) и 18.2 схема развёртывания (dev → CI → registry → VPS, бэкапы, мониторинг, внешние LLM и порталы).
0.52026-11-10убран дубль заголовка документа; бриф переписан под предметную задачу: согласование ПД/РД с эксплуатирующими организациями Москвы (Мосводоканал, Мосводосток, МОЭК, метрополитен, Россети, Моссвет, Мосгаз), место в цикле ИСП и сужение MVP до одного города и семи организаций; дублирующая секция брифа удалена.
0.42026-11-10банк вопросов вынесен в начало документа как рабочий раздел (нумерация 54 сохранена для совместимости ссылок); добавлена секция 54.5 «Доменная специфика и экспертиза» (14 вопросов, всего 82); добавлена секция 54.6 «Как обсуждать вопрос с LLM» — шаблон промпта, пример для O01 и правила разговора; таблицы переведены на фиксированную раскладку без горизонтального скролла (на узких экранах — карточки).
0.32026-11-10банк вопросов расширен: добавлена секция 54.4 «Организационные и инфраструктурные вопросы» (14 вопросов: аккаунты Claude/OpenAI, оплата API, хостинг, домены/SSL, репозиторий и CI, мониторинг, бэкапы, доступы, команда, подрядчики, юрлицо, продажи, поддержка, данные и приватность); итого 68 вопросов, добавлена «Волна 0 · организационная». В меню подсекции 54.1–54.4 вынесены отдельными пунктами.
0.22026-11-10меню перестроено в 12 блоков (бриф → модель → вопросы → карта → роли и скилы → режимы и гейты → экраны → артефакты → управление → фазы → метрики → решения); добавлена секция 14.7 «Скилы PN» (банк S01–S23, карта «скилы в гейтах», контракт скила); секция 54 переработана в банк из 54 вопросов: 54.1 — 12 архитектурных, 54.2 — 18 функциональных, 54.3 — 24 бизнес-вопроса, у каждого — варианты ответа, влияние на проект и связи; добавлены волны снятия вопросов и карта зависимостей.
0.12026-11-10первый проектный документ PN: концепция агента, state machine, Project Context, Question Engine, research orchestration, staging, discovery gates, MVP scope, SDD/backlog/deploy flow и Construction domain-pack.
↑