Product Loop

---
name: product-loop
description: >
  Продуктовый контур: паспорт продукта (правда на сегодня), сценарии (пути
  пользования) и управление изменением через смету до согласия. Владеет стеком
  обязательств, правилом одного направления правды, разделением лент работы и
  различением «правка красит красным» ⊥ «правка порождает задачи». Активируется на:
  «паспорт продукта», «правда о продукте», «что продукт делает сейчас», «круги по
  воде», «распространить правку», «сколько будет стоить это изменение», «смета
  изменения», «сценарий пользования», «путь пользователя шагами», «что сломается,
  если поменять», «продуктовый контур», «замкнуть sdlc», «product passport»,
  «change radius».
---

# Продуктовый контур

Продукт описан в десятке мест, и каждое считает себя правдой. Контур существует, чтобы
**правда жила ровно на одном слое**, а изменение доезжало вниз с названной ценой.

## Стек обязательств

Каждый слой что-то обещает соседу сверху. У каждого — свой прибор проверки.

| Слой | Что обещает | Прибор проверки |
|---|---|---|
| **Тезисы** | утверждения о мире (рынок, закон, поведение) | замер, который их опровергает |
| **Паспорт продукта** | правда на сегодня | «Круги по воде» при правке |
| **Сценарии** | пути пользования | **кадр Смотровой** |
| **Требования** | что система умеет | покрытие полем `covers` в спеке |
| **Спеки модулей** | что модуль обещает соседям | тест контракта |
| **Код** | исполнение контракта | юнит и интеграционный тест |

**Смотровая стоит сбоку, а не снизу.** Внизу код; она доказывает, что проходится **сценарий**.
Поставив её под кодом, подразумеваешь «код → кадр», а на деле «сценарий → кадр».

## Два предмета, которые в стек не входят

**Фича — срез, а не слой.** Спека делит продукт **по ответственности**, фича делит работу **по
доставляемой ценности**. Разложения ортогональны: одна фича трогает пять модулей, один модуль
участвует в десяти фичах. Поставив фичу слоем, получаешь узел со многими родителями — и
инвалидация разойдётся веером в обе стороны. Это первый источник шторма.

**Эпик ⊥ сценарий.** Эпик — контейнер работы. Сценарий — описание пользования. Слепив их,
получаешь артефакт, который одновременно планируется и проверяется и правится по двум
несовместимым причинам.

Оба живут в **лентах работы**, ортогональных стеку.

## Правило одного направления правды

> Формулировка живёт ровно на одном слое. Появилась ниже — помечается долгом и поднимается
> наверх.

Иначе спека становится сама себе заказчиком, и проверять её нечем.

## Вход не всегда сверху — и это главное отличие от водопада

Цепочка «идея → паспорт → сценарии → спеки → код» верна ровно **один раз**, для первой сборки.
Дальше вход бывает с любого слоя, и чаще всего снизу:

- **Смотровая показала неправду** → вверх: код → спека → возможно требование → возможно сценарий
  → в редком случае тезис («мы обещали то, чего не можем»).
- **Новый сценарий** → вниз: требования → спеки → код → кадры.
- **Изменился закон** → входит в тезисы, идёт вниз до кода.
- **Замер опроверг тезис** → вверх, и это самая дорогая правка.

Механика одна в обе стороны. Направление меняет только то, какие узлы задеты.

> Водопад ломается не на первом проходе, а на втором. Конструкция обязана работать **из любой
> точки входа**, иначе она — водопад с обратной связью на бумаге.

## Правка не порождает задачи

Это главное правило контура, и оно контринтуитивно.

| Порождение задач | Вывод из красного |
|---|---|
| задачи пишутся руками → бывают неполными | красное считается машиной → полнота по построению |
| задача может устареть и остаться в списке | гард позеленел — строка исчезла сама |
| цена правки видна после | **цена правки видна ДО** |
| список расходится с реальностью | список **и есть** реальность |

Замер, ради которого правило записано: механизм «правка идеи порождает сорок задач» дал реестр
дрейфа на 108 записей. Порождение задач быстрее их закрытия — арифметическое определение потери
управляемости.

**Следствие: смета до согласия.** «Эта правка гасит 3 сценария, 11 модулей и 40 кадров» —
сказанное человеку **перед** тем, как он согласится. Он вправе сказать «сузить» или «не сейчас».
Управление штормом — не разгребание после, а отказ его вызывать. Как считается — `references/radius.md`.

## Инвалидация — состояние, а не задача

Красный узел значит «согласованность с родителем больше не доказана». Это **не** значит «нужно
работать». Три исхода:

| Вид | Что это | Кто снимает |
|---|---|---|
| **Снимается прогоном** | обязательство то же, надо переподтвердить | **машина, без человека** |
| **Требует правки** | контракт противоречит новому родителю | исполнитель |
| **Принято как долг** | расхождение осознанно оставлено | человек, **с датой и условием возврата** |

Бо́льшая часть инвалидации — первый вид. Шторм возникает, когда все три считают задачами.

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

## Ленты работы — делить по тому, кто разблокирует

Не по теме и не по возрасту.

| Лента | Что там | Кто закрывает | Как наполняется |
|---|---|---|---|
| **Красное** | гарды, упавшие после правки слоя выше | агент | **машиной, руками не пишется** |
| **Задачи** | работа, которую агент может сделать сейчас | агент | из красного и из решений |
| **К человеку** | решение · деньги · доступ · юридическое · продуктовая развилка | **только человек, с датой** | руками, каждая с последствием бездействия |
| **Долг** | осознанно отложенное, с причиной и условием возврата | по решению | руками |

**Почему «к человеку» — отдельная лента с датой.** Задача, отправленная с вопросом внутри,
тонет: вопрос в общем беклоге не имеет ни владельца, ни срока. Замер: решение человека лежало
без кода четыре дня, развилки уровня требований висели пять сессий.

## Что этот навык делает, а что — нет

**Делает:** паспорт продукта и его правку через «Круги по воде» · форму сценария и его связь с
кадрами · смету изменения до согласия · разводку находок по лентам.

**Не делает:** не ведёт дерево спецификации модулей (это `project-spec`) · не снимает кадры
(это `smotrovaya`) · не планирует исполнение (это `planner`). Контур называет **связи** между
слоями, а слои закрывают инструменты своих точек.

## Отложено сознательно

**Инвалидация по отпечаткам обязательства** (`promise_hash` + `depends_on`, где узел краснеет,
когда записанный отпечаток родителя разошёлся с текущим) — механизм, который делает смету
точной вместо приблизительной. **Не включён**, и вот почему:

1. **Отпечатки руками не живут.** Если их считает человек или агент «по совести», механизм
   сгниёт за месяц и станет тем самым дрейфом, который лечит. Нужен скрипт — иначе не начинать.
2. **На свежем проекте всё красное.** Слои ещё не устоялись, тотальная инвалидация читается как
   шум, и механизм отключают в первую неделю. Включать — после первой стабилизации.

До тех пор смета считается по названным связям (`covers`, `touches`) и честно называется
**нижней границей**: она говорит «задето не меньше стольких узлов».