state · diff

git:20261008.46339a7 to git:20261012.4b1b6a8

30 added, 9 removed. Audit A to A.

---

name: state

description: Show project status

---

# /polisade:state — Статус проекта

Показать полный статус проекта для PM.

## Использование

```

/polisade:state # Показать статус

```

## Алгоритм

- 1. Прочитай `.state/PROJECT_STATE.json`

- 2. Просканируй папки `docs/`, `backlog/`, `tasks/` на артефакты

- 3. Сверь статусы с PROJECT_STATE.json (синхронизируй если нужно)

+ 1. Живой статус задач — одной командой (статусы TASK бери ТОЛЬКО из неё:

+ не из корневого `.state/PROJECT_STATE.json` и не из корневых `tasks/*.md`):

+

+ > ⛔ **Если вызов скрипта на этом шаге ты СДЕЛАЛ, и он отклонён или не запустился** (`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 дословный текст отказа и назови следствие: без рабочего вызова скрипта этот шаг выполнить нечем. Причину не придумывай — её называет только сам текст отказа.

+

+ ```bash

+ env ${POLISADE_PYTHON:-python3} {plugin_root}/scripts/polisade_vcs.py tasks-live --project-root .

+ ```

+ В worktree-режиме статус задачи живёт в дереве её ветки

+ (`.worktrees/<dir>/`), а корень проекта стоит на трунке со старым статусом —

+ это штатно. Команда читает оба места и отвечает, где статус живой: поле

+ `lists` — TASK по статусам, `waiting_pm` — кто ждёт PM и с каким вопросом.

+ Строки, которые она напечатала («TASK-…: <статус> — дерево … », «вопрос:

+ …», «примечание: …»), выведи в блоках «ЖДУТ PM» / «В РАБОТЕ» **дословно**.

+ В корень эти статусы не переноси и сверку не запускай.

+ 2. Прочитай `.state/PROJECT_STATE.json` — для остальных артефактов (FEAT,

+ SPEC, PRD, ADR, BUG, …)

+ 3. Просканируй папки `docs/`, `backlog/` на артефакты

4. Собери статистику по состояниям

5. Выведи в структурированном формате

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

```

═══════════════════════════════════════════

СТАТУС ПРОЕКТА

═══════════════════════════════════════════

МОЖНО РЕАЛИЗОВАТЬ (N):

• BUG-001: Кнопка не работает (P1)

• TASK-001: Create API endpoint

• TASK-002: Add UI component

МОЖНО СОЗДАТЬ ЗАДАЧИ (N):

• FEAT-001 → /polisade:tasks FEAT-001

• SPEC-001 → /polisade:tasks SPEC-001

НУЖНА ПРОРАБОТКА (N):

• PRD-001 → /polisade:spec PRD-001

• SPEC-002 → /polisade:design SPEC-002 (опц., создать doc-as-code пакет)

АРХИТЕКТУРА:

Active ADRs: 4

Design packages: 2 (DESIGN-001, DESIGN-002)

ПРИЁМКА:

пар: 7; последний прогон: 6/7 зелёных; ⚠️ база разошлась: чеков 0, приборов 1

АРХИТЕКТУРНАЯ ДОКУМЕНТАЦИЯ (печатать ВСЕГДА — это состояние проекта):

Режим: silo (живой корпус выключен) — /polisade:design SPEC-NNN

Непереведённых силосов: 2 (DESIGN-001, DESIGN-002)

CORPUS-RUN (экспериментально — показывать только если есть ARCHRUN или corpus.mode=living):

Corpus mode: living

• ARCHRUN-001: ждёт PM — "synonym collision: Order vs PurchaseOrder"

→ /polisade:unblock, затем /polisade:design-corpus --resume=<runId>

• ARCHRUN-002: ready (resume required) → /polisade:design-corpus --resume=<runId>

───────────────────────────────────────────

ЖДУТ PM (N):

• TASK-003: "Какой лимит для rate limiting?"

(с 2024-01-15)

• FEAT-002: "Какой приоритет?"

(с 2024-01-14)

ЗАБЛОКИРОВАНО (N):

• TASK-008: Тесты падают после изменений в API

В РАБОТЕ (N):

• TASK-005: Implementing auth module

───────────────────────────────────────────

БЭКЛОГ:

Features: 3 (1 ready, 2 draft)

Bugs: 3 (1 ready, 1 in_progress, 1 not_actual)

Tech Debt: 5 (2 ready, 3 draft)

ЗАВЕРШЕНО ЗА СЕССИЮ:

• TASK-004, BUG-002

ЗАКРЫТО БЕЗ РЕАЛИЗАЦИИ (N; отдельно от завершённых):

• TASK-006: cancelled — <status_reason>

• BUG-003: not_actual — <status_reason>

НЕПРИМЕНИМЫЕ ADR (N; не superseded):

• ADR-004: not_applicable — <status_reason>

═══════════════════════════════════════════

РЕКОМЕНДАЦИЯ:

→ [Конкретное действие]

═══════════════════════════════════════════

```

## Логика рекомендаций

- 1. Если есть `waitingForPM`:

+ 1. Если поле `waiting_pm` команды шага 1 не пусто:

→ "Запусти /polisade:unblock чтобы ответить на N вопросов"

2. Если есть ready BUG:

→ "Есть баги для исправления. /polisade:continue или /polisade:implement BUG-XXX"

3. Если есть ready TASK:

→ "Запусти /polisade:continue для автономной работы"

4. Если есть ready FEAT/SPEC/PLAN без задач:

→ "Создай задачи: /polisade:tasks FEAT-XXX"

5. Если есть ready PRD без спеки:

→ "Создай спецификацию: /polisade:spec PRD-XXX"

5b. Если есть ready SPEC без DESIGN-PKG (опц. рекомендация):

→ "Можно создать дизайн-пакет: /polisade:design SPEC-XXX (C4/ERD/OpenAPI/ADR)"

6. Если всё `blocked`:

→ "Все задачи заблокированы. Детали выше."

7. Если все рабочие единицы `done`:

→ "Всё завершено! Добавь новую работу: /polisade:feature или /polisade:prd"

8. Если есть `cancelled`/`not_actual`, покажи их отдельно и причину из

`artifactIndex.status_reason`; не включай в счётчик реализованных задач или

исправленных багов. Для зависимых TASK с `depends_on:` на такие ID покажи

«требуется решение PM», даже если все остальные задачи `done`.

9. ADR `not_applicable` показывай отдельно от `accepted`, `deprecated` и

`superseded`; отсутствие заменяющего решения не превращай в superseded.

## Группировка артефактов

### По возможности действия

| Группа | Артефакты | Следующее действие |

|--------|-----------|-------------------|

| Можно реализовать | BUG, TASK, DEBT (ready) | /polisade:implement или /polisade:continue |

| Можно создать задачи | FEAT, SPEC, PLAN (ready) | /polisade:tasks |

| Нужна проработка | PRD (ready) | /polisade:spec |

| Можно спроектировать | SPEC (ready) без DESIGN-PKG | /polisade:design (опционально) |

| Архитектура | DESIGN-PKG, ADR | информационно — показывает количество в блоке "АРХИТЕКТУРА" |

| Corpus-run | ARCHRUN (waiting_pm / ready) | отдельная секция "CORPUS-RUN" — **НЕ** в "Можно реализовать"; resume через /polisade:design-corpus --resume, не implement |

### Источник строки блока "ПРИЁМКА"

Строка берётся ЦЕЛИКОМ из поля `summary` одной команды и не собирается

своими словами:

> ⛔ **Если вызов скрипта на этом шаге ты СДЕЛАЛ, и он отклонён или не запустился** (`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 дословный текст отказа и назови следствие: без рабочего вызова скрипта этот шаг выполнить нечем. Причину не придумывай — её называет только сам текст отказа.

```bash

${POLISADE_PYTHON:-python3} {plugin_root}/scripts/polisade_acceptance.py status --json --root "${POLISADE_WORK_DIR:-.}"

```

Чеки она НЕ исполняет — состояние читается из файла приёмки, зафиксированной

базы и отчёта последнего прогона. Тот же расчёт читают `/polisade:doctor`,

`/polisade:review-pr` и раздел `## Приёмка` в описании PR: четыре собственных

разбора одного файла разошлись бы молча.

Блок печатается ВСЕГДА, включая «приёмка не заведена»: её отсутствие — факт

о проекте, а не пустое место. Пометки `stale` (отчёт снят на другом коде) и

«база разошлась» не глотать — это ровно те два способа, которыми зелёная

приёмка перестаёт что-либо означать.

⛔ **Три формы, и третья обязательна**. Блок печатается так:

| когда | что печатать |

|---|---|

| команда отработала | строку `summary` **ДОСЛОВНО** |

| команда ответила `state: absent` | `приёмка не заведена` |

| команда НЕ отработала | `не удалось определить` + **дословный** отказ |

«Приёмка не заведена» — это ОТВЕТ ИНСТРУМЕНТА, а не заполнитель пустоты.

Замерено на живом прогоне: скрипт не запускался вовсе (ноль вхождений в

логе), модель придумала отказ, привела несуществующую причину, процитировала

капсулу exec-denied как прикрытие — и напечатала «не заведена» на проекте,

где приёмка ЗАВЕДЕНА и где она сама её двумя строками выше увидела.

Отсутствие ответа, отрендеренное как отрицательный ответ, — тот самый класс

F1, ради которого блок и заводился.

Дословная строка `summary` в отчёте и есть свидетельство, что команда

отработала: пересказ своими словами такого свидетельства не даёт.

### Источники цифр для блока "АРХИТЕКТУРА"

- **Active ADRs** — количество ADR со статусом `accepted` в

`artifactIndex`; `not_applicable` не входит ни в активные, ни в заменённые.

Если `architecture.activeADRs` или `architecture.deprecatedADRs` всё ещё

содержит такой ID, покажи предупреждение `adr_outcome_lists` от doctor и

попроси исправить списки после сверки решения, не включай его в число.

- **Design packages** — количество артефактов с `type == "DESIGN-PKG"` в `artifacts`

### Источники для блока "АРХИТЕКТУРНАЯ ДОКУМЕНТАЦИЯ"

Блок печатается ВСЕГДА — каким путём проект ведёт архитектуру, это состояние

проекта, а не деталь реализации. Две строки, обе с диска и из состояния:

- **Режим** — `settings.experimental.designCorpus` (включён ли живой корпус)

вместе с `architecture.corpus.mode` (`silo` / `living` — что уже построено).

Три формы, и третья обязательна:

| когда | что печатать |

|---|---|

| `designCorpus: false` | `silo (живой корпус выключен) — /polisade:design SPEC-NNN` |

| `designCorpus: true`, а корпуса нет | `корпус включён, но НЕ построен — /polisade:design-corpus SPEC-NNN` |

| корпус построен | `living (<каталог корпуса>/)` |

Второе состояние — не «всё в порядке»: корпус не строится сам, и включённый

режим без корпуса это недоделанный шаг, а не норма.

⛔ Каталог корпуса — `architecture.corpus.dir` (умолчание

`docs/architecture`), а «корпус построен» — это `manifest.yaml` в нём с

полем `id: ARCH-CORPUS`. Одного файла `manifest.yaml` мало: такой файл есть

и у пакета `DESIGN-NNN-<slug>/`, и он несёт id пакета. Не читается или

оказался ссылкой — это «не определено», а не «нет».

Ту же тройку считает `/polisade:doctor` проверкой `corpus_mode`. **Если

doctor в этом прогоне запускался, бери формулировку ИЗ НЕГО дословно** —

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

- **Непереведённые силосы** — каталоги `DESIGN-NNN-*` в каталоге корпуса **без

маркера `MIGRATED.md`**. Маркер обязателен: перевод на корпус НИЧЕГО из

силоса не удаляет, поэтому «каталог на месте» само по себе не значит «ещё не

переведён», и счётчик без этой проверки не убывал бы никогда. При включённом

корпусе назови число и предложи `/polisade:design-corpus --adopt`. Ноль — так

и скажи: переводить нечего. Молчание здесь неотличимо от «не смотрели».

### Источники для блока "CORPUS-RUN" (experimental)

- **Corpus mode** — `architecture.corpus.mode` (`silo` / `living`). Блок

показывается только если `mode == "living"` ИЛИ есть хотя бы один `ARCHRUN-*`.

- **ARCHRUN runs** — артефакты с префиксом `ARCHRUN-` (из `waitingForPM` и

`readyToWork`). `ready` означает **«resume required»**, а не обычную задачу:

всегда сопровождай ссылкой `/polisade:design-corpus --resume=<runId>`

(runId — из `architecture.corpus.pendingRun`). **Никогда не показывай ARCHRUN

в "Можно реализовать".**

### По статусу

- **ready** — готово к работе

- **in_progress** — в работе

- **waiting_pm** — ждёт ответа PM

- **blocked** — техническая проблема

- **done** — завершено

- **draft** — черновик (не показывать в основном списке)

- ## Синхронизация

+ ## Расхождения

- При обнаружении расхождений между файлами и PROJECT_STATE.json:

- - Добавь недостающие артефакты в state

- - Обнови статусы из frontmatter файлов

- - Сообщи о синхронизации: "Синхронизировано N артефактов"

+ `/polisade:state` — обзор, он ничего не пишет. Расхождение между файлами

+ корня и PROJECT_STATE.json назови строкой отчёта и порекомендуй

+ `/polisade:sync` (команда PM). Статус TASK, живущий в дереве её ветки, —

+ не расхождение: его показала команда шага 1.

## Важно

- Показывай самую важную информацию первой (баги, блокеры)

- Группируй по возможным действиям, не просто по типам

- Давай конкретные рекомендации с командами

- Не перегружай информацией — PM должен быстро понять что делать