Parallel Streams

Разбить план на параллельные потоки

Вход: путь к утверждённому плану (спецификация, план реализации, список задач, раздел дорожной карты). Выход: карта зависимостей и по одному заданию на поток, которое свежая вкладка выполнит без всякого другого контекста.

Только карта — попросили «покажи карту», «как это разделится», «что можно вести параллельно»: делать шаги 1–4 и 6. Заданий не писать. Полная разбивка — попросили разделить план: делать шаги 0–6. Закрытие волны — попросили «закрой волну», «что от неё осталось», «сведи хвосты», «волна закончена?»: делать шаги 0, 1 и 7. Карту заново не строить, заданий не писать.

Шаг 0. Загрузить настройку проекта

Искать настройку .parallel-streams.md в корне репозитория. В ней сказано, как ИМЕННО ЭТОТ проект изолирует вкладки, какого размера бывает изменение, какой командой гоняются проверки и какой разбор идёт перед слиянием. Настройка есть — каждое задание обязано ей следовать.

Настройки нет — работать по умолчанию и сказать об этом ОДИН раз, в итоговом абзаце: изоляция отдельным рабочим деревом, один читаемый запрос на слияние на поток, проверки штатной командой проекта, разбор изменений перед слиянием. Подробности и полный список полей — references/configuration.md.

Постоянный файл правил. Раздел настройки ## Persistent rules называет файл, который вкладки этого проекта загружают в начале КАЖДОЙ сессии, — CLAUDE.md, AGENTS.md или что там читает эта среда. Правила, которые обязаны действовать независимо от того, выдал ли задание этот скилл, — как разговаривают с владельцем, во что превращается отчёт субагента, когда вкладка вообще пишет текстом, — живут в том файле, а не только в настройке: вкладка, работающая по задаче, набранной руками прямо в чате, не открывает ни настройку, ни этот скилл.

Проверить до того, как писать задания. Файл назван и существует — делать нечего. Назван и отсутствует либо не назван вовсе — сказать об этом один раз в итоговом абзаце, одной строкой, и предложить готовый блок из references/persistent-rules.md. В этот файл не писать без спроса — и молчать о нём тоже нельзя: молчание здесь неотличимо от «в проекте всё закрыто».

Канал согласования. Если в настройке есть раздел ## Coordination, у проекта есть способ, которым работающие вкладки достают друг друга: контекст соседа не виден никому, а план, поправленный после старта вкладки, до неё не доходит уже никогда. Команды оттуда копировать ДОСЛОВНО в блоки 4 и 9 каждого задания, заполненными под этот поток: объявить поток на старте, отправить находку живому соседу, закрыть пришедшее, спросить, чей это кусок, прежде чем предлагать работу за пределами своих задач, сдать поток последней командой — когда фиксировать больше нечего. Раздела нет — пропустить целиком и про согласование не говорить ни слова: скилл несёт порядок, а не механику.

Объявление — единственное здесь, что не уговор, а отказ: при установленном канале фиксация работы из потока, который не объявился, отклоняется, и отказ возвращает команду, которой это лечится. Поэтому объявление в блоке 4 — не вежливость: поток, который его пропустил, остановится на первой же фиксации.

Адрес потока в этом канале — <волна>/<номер потока>: волна из имени файла плана, номер из первой колонки таблицы. Имена веток и папок внутри волны расходятся с объявленными, номер в плане — нет, поэтому только он и продолжает работать.

Проект без волн и без файла плана тоже поддержан: канал выдаёт волну сам — по работе, идущей рядом, а если рядом нет ничего, то по сегодняшней дате, — и присваивает следующий свободный номер потока. Механика канала едет вместе со скиллом, в coordination/; как её ставят в проект — coordination/README.md.

Шаг 1. Прочитать план целиком

Открыть файл и прочитать его весь — каждый этап, каждый шаг. Не по памяти и не по конспекту. Непрочитанная зависимость — это конфликт слияния, в который упрёшься позже.

Если план лежит в папке, названной разделом ## Plans, он тоже носитель правил. Задание вставляют один раз; план — документ, который вкладка открывает сама, и задача, заново нарезанная из плана руками, несёт ровно то, что несёт план. Искать в нём раздел с правилами, действующими для всех потоков. Раздела нет — сказать об этом в итоге и предложить его добавить, собрав из настройки. Наблюдение 31.08.2026: план волны, написанный руками, такого раздела не имел; скилл и настройка были свежие, и обе говорили, что отчёт субагента владельцу не пересылается, — а каждая вкладка той волны печатала владельцу отчёты своих субагентов: пути, таблицы файлов, строчки настроек, и всё это человеку, который код не читает. Никто ничего не нарушал: правила просто не было там, куда эти вкладки смотрят.

Плану нужен ещё и раздел ## Wave Loose Ends — это адрес, на который канал уже отправляет. Несколько отказов канала называют его прямо: находка сданному потоку, находка потоку, у которого не стало рабочей папки, ящик, оставшийся от сданного потока. Раздела нет — каждый такой совет ведёт в никуда, и вкладке, идущей по нему, некуда деть то, что у неё в руках. Нет — сказать об этом один раз в итоге и предложить добавить; хватит пустого раздела с одной строкой о том, что в него кладут.

Шаг 2. Найти зависимости между потоками

Зависимость между потоками — не то же самое, что порядок шагов внутри плана. Считать зависимостью:

• Общая поверхность правки — два потока меняют один файл или один модуль. Один ждёт.
• Произведённый предмет — один поток пользуется тем, что заводит другой: таблица, миграция, адрес обращения, ключ настройки, сгенерированный клиент, новый пакет.
• Единственный владелец версии — оба поднимают одно и то же версионируемое: версию схемы, версию протокола, файл замка зависимостей, публичный интерфейс. Параллельно — никогда: слить в один поток или выстроить в очередь явно.

Не считать зависимостью: два потока трогают один пакет, но разные, непересекающиеся файлы. Это риск конфликта, а не зависимость — упомянуть в задании, но не выстраивать из-за этого работу в очередь.

Все три вопроса выше спрашивают, что поток меняет. Задать ещё один: чем каждый поток пользуется, пока проверяет себя? Одна местная база, которую мигрирует набор проверок, контейнер под фиксированным именем, замок сборки, общий кэш — два потока, запустившие проверки одновременно, делят всё это, и ломается оно совсем не как зависимость: красные проверки в потоке, который ничего похожего не менял, либо зелёные, купленные миграцией соседа. Это не «ждёт»: ответ — развести, а это строка в задании и строка под картой; ни колонкой, ни очередью это не записывается. Что бывает общим и куда какая строка идёт — references/dependency-analysis.md.

Полный список, включая ловушки, которые выглядят независимыми и таковыми не являются: references/dependency-analysis.md.

Шаг 3. Сгруппировать в потоки

• Максимум параллельности, который не нарушает шаг 2.
• Один поток = одна ветка = одно изолированное рабочее место = одна вкладка.
• Размер: один читаемый запрос на слияние или короткая цепочка небольших внутри одной ветки.
• Никогда не резать физически неделимое: миграция и её единственный потребитель едут вместе.

Шаг 4. Собрать карту: сперва таблица, потом схема

Обе, всегда, в этом порядке.

4.1 Таблица — ровно шесть колонок

• Ждёт / Держит симметричны: B ждёт A ⇔ A держит B. Сверять сравнением обеих колонок, а не на глаз.

• Усиленный режим — отрезок, который занимает более глубокий и дорогой режим: где начинается, где кончается и ради чего — «шаги 3–4», «весь поток», — либо «не нужен». Пустой ячейки не бывает. Именно отрезок, а не точка: режим включают руками и держат руками, поэтому начало без конца оставляет дорогой режим работать на всей рутине, которая идёт следом.

• Разбор — проверка из настройки, глубиной по тому, что поток трогает, и никогда — по ощущению «работа была простая»:

  Что трогает поток	Глубина
  Деньги, права доступа, ключи, персональные данные, всё, до чего дотягиваются снаружи	самая глубокая проверка из настройки плюс разбор безопасности
  Расползающаяся правка — сквозная замена, миграция, переименование — или новый договор, которым будут пользоваться соседние потоки	глубокий
  Одна область по образцу, который уже есть в репозитории	облегчённая проверка из настройки
  Изменение, которое не может изменить поведение: текст, переводы строк, комментарии, номер версии, файл, перемещённый без правок	«не нужен», с причиной в той же ячейке

  «Не нужен» — утверждение об изменении, а не о плане: задание с таким ответом обязано нести и строку, возвращающую проверку, если работа всё-таки затронет код. Настройка может запрещать «не нужен» вовсе — тогда проверку несёт каждый поток. Обе колонки принимают «не нужен» как ответ; ни одна не принимает пустоту. Правила глубины и запасные формулировки — references/brief-template.md.

• Не повторять транзитивные зависимости: если 9 ждёт 5–8, а те уже ждут 1–4, перечислить только 5, 6, 7, 8 и одной строкой под таблицей сказать, почему этого достаточно.

• Всё, что потоки делят на проверке, идёт одной строкой под таблицей — что развести и чем, — а не колонкой и не в «Ждёт». Разводить нечего — не писать ничего. Колонка тут почти в каждой строке ответила бы «нет», а запись в «Ждёт» выстроила бы в очередь часы работы ради того, что чинится строкой.

4.2 Схема — одна связная картинка, порождённая, а не набранная руками

Скормить сборщику только что написанную таблицу и вставить его вывод дословно:

python scripts/render_map.py map.md --format table --check

Тогда схема берётся из той же таблицы, которую видит читатель. Короткая запись тоже работает (4: 1, 2 значит «поток 4 ждёт потоки 1 и 2»), но сверять её с таблицей потом некому: таблица, говорящая одно, и схема, нарисованная с другого, пройдут обе — каждую проверяют отдельно.

--check здесь делает две работы. Проверяет рисунок — схема, которая выглядит хорошо и врёт на один символ, падает громко. И разбирает саму таблицу: шесть колонок в закреплённом порядке, «Ждёт» и «Держит» согласны друг с другом в обе стороны, нет пустых клеток там, где место ответу, нет транзитивных связей, нет ссылок на потоки, которых в таблице нет. Ничего из этого списку самопроверки больше не задают.

Колонка — это момент старта: всё, что стоит в самой левой, можно открывать прямо сейчас. Правила чтения, формат входа и что делать, когда Python недоступен, — references/diagram-rules.md.

Нарисованная руками схема уезжает на символ, и замечает это всегда только читатель. Руками не рисовать.

4.3 Состояние, когда план частично сделан

Если часть работы уже влита, карта без такой пометки вводит в заблуждение. Посмотреть историю слияний (git log --oneline origin/main) и добавить одну строку под схемой: какие потоки влиты, какие идут, какие не начинались. Проверка приблизительная — так и сказать; догадку за факт не выдавать.

Какие потоки идут ПРЯМО СЕЙЧАС — та половина, на которой догадка и ошибается: рабочее дерево, брошенное закрытой вкладкой, выглядит в точности как живое. Если настройка объявляет канал согласования — спросить у него: он отвечает по собственным заявкам вкладок, а не по именам папок.

Шаг 5. Написать по одному заданию на поток

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

1. Заголовок — действие, а не предмет («Завести очередь повторов», а не «Очередь повторов»).
2. Контекст — 3–5 строк: что и зачем, со ссылкой на раздел плана.
3. Зависимости — что должно быть влито раньше, либо «ничего, начинай сейчас».
4. Как работать — сперва завести изолированное рабочее место, затем объявить поток на канале согласования, если он есть в настройке (объявление и есть то, что делает вкладку достижимой, и задним числом оно бесполезно — ставить его до любой правки); чтение и разведку отдавать субагентам, а не вести в своём контексте, и так же отдавать выполнение каждой задачи, с отдельным субагентом, который сверяет готовую задачу с заданием — сделано ли то, о чём просили, а не охота за ошибками в логике, это работа проверки перед слиянием, — один раз на задачу, а не на каждый круг правок, либо один раз на весь поток, когда поток это две-три мелкие однородные задачи; на каждую задачу берётся свежий субагент, а не разбуженный прежний; модели — по уровням из настройки. Ветку, коммиты, запрос на слияние и само слияние вкладка ведёт сама и спрашивает только про решения из блока 8. Когда канал есть, этот же блок несёт: как находка доходит до живого соседа, что пришедшие записи надо закрывать и — прежде чем предлагать любую работу за пределами своих задач — как спросить, чей это кусок. Тот, кто утверждает работу, не может знать, что задачу планировали другому потоку; он скажет «да». Этот же блок решает, что доходит до владельца: отчёт субагента — сырьё для вкладки, а не текст на пересылку; от субагентов требуют максимума точности, и ничего из этого не попадает в чат — ни целиком, ни выжимкой, ни пересказом с сохранением имён из кода. Одного намерения вкладки для этого мало: последний ответ субагента владелец видит сам, отдельным сообщением, раньше вкладки, — поэтому задание субагенту называет два адреса, подробный отчёт в файл и несколько строк простыми словами в ответ. Владелец слышит собственные слова вкладки, и всего три раза: строка на задачу о том, за что взялись, самодостаточный вопрос на каждой развилке и итог в конце. Просьба про усиленный режим — включить перед отрезком и выключить в его конце — это вопрос на развилке, а не лишний статус: обе останавливают работу, пока не ответят.
5. Что делать — конкретные шаги из плана, относящиеся к этому потоку.
6. Усиленный режим — обязательно. Либо «не нужен» и почему, либо две просьбы: включить — с поводом и отрезком, который режим покрывает, и в конце этого отрезка остановиться и попросить выключить, потому что сам по себе режим не выключается.
7. Разбор — обязательная строка: какая проверка идёт перед слиянием, либо «не нужен» с причиной и условием, при котором проверка возвращается.
8. Решить со мной до реализации — настоящие развилки из этого плана для этого потока, плюс любые формулировки, которые увидит человек, простым языком, решение прежде кода; и постоянное приглашение возразить против самого задания до начала работы — бесплатно даже тогда, когда возражение отменяет распоряжение, — вместе с требованием в каждом отчёте отделять проверенное от предполагаемого.
9. Готово, когда — проверки пройдены, разбор сделан, запрос на слияние влит; а там, где в настройке есть канал согласования, — поток сдан: сдача и есть то, что заставляет спросить «всё ли пришедшее учтено», а больше об этом не спрашивает ничто. Сдача идёт САМОЙ ПОСЛЕДНЕЙ, когда фиксировать в этой папке больше нечего: после неё сторож не пропускает ни коммит, ни отправку, ни заведение запроса на слияние.

Шаблон и правила блоков 4 и 6–8: references/brief-template.md.

Шаг 6. Самопроверка до того, как что-то показывать

Карта:

Механическую половину закрывает сборщик: прогнанный по самой таблице, он отвечает за шесть колонок и их порядок, за согласие двух колонок зависимостей в обе стороны, за пустые клетки, транзитивные связи, ссылки на несуществующие потоки и за сам рисунок. Остаётся то, что требует суждения:

• render_map.py --format table --check прогнан по этой самой таблице и прошёл?
• глубина разбора у каждого выведена из того, что поток трогает, а не из того, насколько сложной казалась работа?
• «не нужен» в клетке несёт причину, а не одно слово?
• всё, что потоки делят на проверке, названо под таблицей вместе с тем, чем это развести, — либо разводить действительно нечего?
• если план частично сделан, состояние отмечено под схемой?

Каждое задание:

Каждый пункт — один вопрос. Что именно должно быть в ответе, сказано в шаге 5 и в шаблоне; повторить это здесь значило бы дать одному требованию две формулировки, а две формулировки расходятся.

• строка про делегирование есть целиком — и разведка, и выполнение, уровни моделей, один проверяющий на готовую задачу, каждый раз свежий?
• строка про отчётность есть целиком — включая два адреса, которые называет задание субагенту?
• строка про усиленный режим явная — «не нужен» с причиной либо отрезок с обеими остановками?
• строка про разбор явная — проверка либо «не нужен» с причиной и то, что её возвращает?
• развилки конкретные, взятые из плана, а не общие советы?
• в блоке 8 есть приглашение возразить до начала — бесплатное даже тогда, когда оно отменяет распоряжение, — и требование отделять проверенное от предполагаемого в отчётах?
• заголовок называет действие?
• читатель без всякого другого контекста сможет это выполнить?
• если в настройке есть канал согласования — объявление на старте (до любой правки) в блоке 4, сдача в блоке 9 и подставленный адрес именно этого потока, а не заглушка?

Доставка:

• постоянный файл правил из настройки проверен — существует, либо его отсутствие названо один раз в итоге, с предложением готового блока?
• план в папке из раздела ## Plans несёт раздел с правилами для всех потоков — либо его отсутствие названо один раз, с предложением его добавить?
• план несёт раздел ## Wave Loose Ends — адрес, на который ссылаются отказы самого канала, — либо его отсутствие названо один раз, с предложением его добавить?
• карта и задания напечатаны прямо в этом ответе, копируются без открытия файлов?
• каждое задание под заголовком, называющим момент запуска?

Любое «нет» — починить до показа. Черновик не показывать никогда.

Закрытие волны — только в этом режиме:

• состояние потоков спрошено у канала, а не угадано по именам папок и веток?
• каждый остаток — отдельным пунктом с готовым текстом запуска НОВОЙ вкладки?
• то, что выяснить не удалось, названо неизвестным, а не опущено?

Шаг 7. Закрыть волну: свести всё, что осталось

Волна заканчивается так же, как начиналась, — руками, и закрывающего вопроса не задаёт никто. Карта строится один раз, в начале, а вся механика набора работает, только пока вкладки ЖИВЫ.

То, что остаётся после, невидимо по устройству. Задача, которую поток бросил, не даёт ни конфликта слияния, ни красных тестов, ни двойной работы: её просто нет, и потеря всплывает волну спустя, если всплывает вообще. Находка, адресованная потоку, который успели сдать, остаётся на доске — получать её некому. Ящик, не разобранный при сдаче, уходит вместе с потоком.

Спрашивать канал — не угадывать и не читать состояние по именам папок:

• pwsh scripts/wave-board.ps1 -Mode Streams -Wave <волна> — кто какой поток вёл, какие сданы, у каких адресов две ведущие записи или ни одной;
• pwsh scripts/wave-board.ps1 -Mode Show — что осталось открытым на доске и что застряло, потому что адресат закрыт.

Затем сверить задачи плана с историей слияний, как в шаге 4.3, и прямо сказать, где сверка приблизительна.

Три вида остатка, каждый — отдельным пунктом:

• задача, которую никто не доделал и никто не ведёт сейчас, — в том числе оставленная сданным потоком незакрытой;
• находка на доске, адресат которой закрыт: она не придёт уже никогда;
• поток, сданный с непустым ящиком: то, что в нём лежало, не ушло никуда.

Каждый пункт кладётся в раздел плана ## Wave Loose Ends, и каждый несёт готовый текст запуска НОВОЙ вкладки. Строкой в чьей-то задаче тут не обойтись: потока, которому она принадлежала, больше нет, а правка плана до живых вкладок и так не доходит. Раздела нет — завести его или сказать об этом и предложить.

Тот же список напечатать в ответе и закончить единственной строкой, ради которой всё: волна закончена — или у неё есть открытые концы, и вот кому их подбирать.

Формат вывода

Карта и задания печатаются в самом ответе. Они и есть ответ, а не документ, написанный рядом: владелец копирует каждое задание прямо из окна перед собой в новую вкладку, не открывая сперва файл.

1. Итоговый абзац: сколько потоков, почему разбивка такая, нашлась ли настройка и — только если чего-то не хватает — что постоянного файла правил или раздела правил в плане нет.
2. Таблица.
3. Схема, плюс строка состояния, если план частично сделан.
4. По блоку на поток, в порядке номеров, каждый под заголовком вида «Поток N — начинать сейчас», когда его ничто не держит, или «Поток N — после слияния потока M», когда держит, с перечислением всех, кого он ждёт («Поток 8 — после слияния потоков 5, 6, 7»). Заголовок несёт момент запуска, поэтому по одним заголовкам видно, какие вкладки открывать сегодня; название работы — это собственный заголовок задания, первая строка внутри блока. Каждое задание в огороженном блоке, чтобы одним движением копировалось целиком. Пропускается, когда просили только карту.
5. Одна закрывающая строка: какие потоки можно открывать прямо сейчас.

Закрытие волны печатает совсем другое: состояние каждого потока так, как его называет канал, остатки по видам, куда каждый записан, и одну закрывающую строку — волна закончена либо у неё есть открытые концы и вот кому их подбирать. Ни карты, ни заданий.

Попросили ещё и файл — написать файл и всё равно напечатать всё здесь.

Порядок запуска прозой не пересказывать: его уже несут таблица, схема и заголовки.