design

/polisade:design [PRD-XXX | SPEC-XXX] — Doc-as-code design package через субагент

Создание набора doc-as-code артефактов (C4, sequence, ERD, OpenAPI, AsyncAPI, ADR, glossary, state, deployment) на основе PRD или SPEC. Все артефакты — Markdown с Mermaid/YAML, нативно рендерятся в GitHub/GitLab/Notion.

⚠️ DESIGN-NNN силосы — deprecated для brownfield. Per-SPEC пакет DESIGN-NNN-<slug>/ (изолированный силос) на существующем корпусе устаревает: intent-подмножество (ADR, NFR/QAS, glossary, context-map, C4 L1, deployment) ведётся в едином живом корпусе docs/architecture/ (/polisade:design-corpus строит его best-effort с громкой пометкой INFERRED/GAP, а не молча выдаёт за проверенный), а derived (C4 L2/L3, ER, state, sequences) — регенерируется, руками не пишется. Greenfield-путь полного DESIGN (новый модуль с нуля) остаётся живым — deprecated значит «помечен и не развивается», не «удалён». Классификация силоса intent/derived (read-only отчёт) — scripts/polisade_migrate_design.py --report. Living-корпус — /polisade:design-corpus (experimental, за settings.experimental.designCorpus).

Силос → корпус. Живой корпус docs/architecture/ — источник правды по архитектуре. Пакет docs/architecture/DESIGN-NNN-<slug>/ — legacy-силос: сначала ищи факт в корпусе (model/, c4/, glossary/, quality/, flows/, contracts/, decisions/), и только если там его нет — читай силос. Прочитал силос — скажи вслух, отдельной строкой в выводе: ⚠️ переходное чтение силоса: <путь> (источник правды — корпус docs/architecture/). Молчаливое чтение силоса — дефект, а не экономия: PM не видит, что решение принято по устаревшему укладу. Если в пакете есть MIGRATED.md, его карта домов обязательна к прочтению, и читается она так: из силоса перестают читать ТОЛЬКО файлы таблицы «Перенесено 1:1» — они уже лежат в корпусе целиком. Файлы таблицы «Ещё НЕ в корпусе» не переносились: там назван целевой дом, которого ещё нет, и единственная копия факта — в силосе. Такой файл читают отсюда (громко), пока модель не свернула его в корпус; считать его устаревшим — потерять факт. Перевод силоса на корпус — ${POLISADE_PYTHON:-python3} scripts/polisade_migrate_silo.py <пакет> (dry-run по умолчанию, запись — явным --apply, конфликты — выбор человека, не скрипта).

⛔ Если вызов скрипта на этом шаге ты СДЕЛАЛ, и он отклонён или не запустился (Command references protected path / Install directory is read-protected / Filesystem Guard / the tool's default permission is 'deny', отказ песочницы, ненулевой exit без вывода) — STOP. Вызова не было — отказа нет: сначала выполни команду; этот блок описывает её вывод и сам ответом не служит. Процитируй отказ дословно. НЕ пересказывай по исходнику, что скрипт «сделал бы»; НЕ собирай dry-run вручную; НЕ переходи к apply/push/pr-create. НЕ транскрибируй скрипт (прочитать → записать копию в /tmp или в проект → запустить копию): копия не байт-идентична — уезжают классы символов в regex, форма возврата функций, пропадают целые функции — и молча меняется набор применённых изменений. Отказ инструмента — это отказ, а не результат. Доложи PM дословный текст отказа и назови следствие: без рабочего вызова скрипта этот шаг выполнить нечем. Причину не придумывай — её называет только сам текст отказа.

⛔ Живой корпус docs/architecture/ пишет ОДИН исполнитель — ${POLISADE_PYTHON:-python3} {plugin_root}/scripts/polisade_corpus_io.py (stdlib-only). Ни Write, ни Edit, ни cp, ни mv, ни > в корпус не идут: примитив даёт пофайловую атомарность, блокировку от второго писателя, журнал оборванной промоции, проверяемый манифестом backup и отказ на симлинках и побегах пути. Ручное копирование обходит всё перечисленное — это регресс, а не «то же самое».

Хэш-контракт. Всё, что ты проверил ДО вызова, к моменту записи могло устареть, поэтому объявляй примитиву, каким ты ВИДЕЛ цель, — он сверит это сам, вплотную к записи: --expect-absent для нового файла (публикация идёт атомарным linkat, занятое имя отвергает ядро) и --expect-sha256 <hex> для правки существующего (ключ — из ПРОЧИТАННЫХ байтов, не из размера и не из даты); для promote — карта --expect-from <json> вида {путь: sha256|absent}. Отказ E-expect-* значит, что файл правил кто-то ещё: не повторяй с --force, покажи расхождение PM.

Исключение ровно одно, и оно названо, а не умолчано: legacy-силос docs/architecture/DESIGN-NNN-<slug>/ пишет /polisade:design своим Write-инструментом. Силос deprecated и переносится в корпус скриптом scripts/polisade_migrate_silo.py, а не развивается.