Tablichnoe Revyu

---
name: tablichnoe-revyu
description: >
  Локализация РФ. Табличное ревью пакета однотипных документов: одна строка — документ, один
  столбец — искомое условие, в каждой ячейке значение, статус и дословная цитата с указанием
  пункта. Сделано для проверки перед сделкой («просмотри 200 договоров компании на смену
  контроля, уступку и обеспечения»), но работает для любой партии — трудовых договоров, лицензий,
  протоколов. Используй при словах «табличное ревью», «сделай таблицу по документам», «вытащи
  условия из этих договоров», «сравни эти документы по пунктам», «пакетная проверка», или когда
  указывают на папку документов и просят их сопоставить.
argument-hint: "[--shema путь] [--dokumenty папка] [--proba N] [--vyhod csv|md]"
---

<!--
Локализация РФ на основе corporate-legal/skills/tabular-review (anthropics/claude-for-legal,
Apache-2.0). Класс (b) по ADR-002 — движок таблицы, правового существа не несёт: что искать,
задаёт вызывающий скилл или пользователь. Убраны выгрузка в Google Sheets по умолчанию
(зарубежное хранилище при ПДн в документах) и шаблон схемы под американский M&A diligence.
-->

# Табличное ревью пакета документов

## Что это и чем не является

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

Правовое существо (что считать существенным, как квалифицировать условие) задаёт вызывающий
скилл — `perechen-dogovorov`, `due-diligence` — или пользователь. Сам движок не решает, плохое
условие или хорошее.

## Контекст дела и персональные данные

Проверь `## Ведение дел` в профиле. При включённом режиме таблица и исходники живут в папке дела.

**Перед выгрузкой — маршрут данных.** Пакет договоров почти всегда содержит персональные данные
(подписанты, контактные лица, ИП). Выгрузка в зарубежное хранилище (Google Sheets, зарубежный
диск) затрагивает ч. 5 ст. 18 ФЗ-152 в ред. ФЗ от 28.02.2025 № 23-ФЗ: при сборе ПДн граждан РФ
использование БД за пределами РФ не допускается, кроме случаев п. 2, 3, 4, 8 ч. 1 ст. 6.
По умолчанию выгружай локально — `.csv` и `.md` рядом с документами. Зарубежный формат — только
если пользователь подтвердил, что маршрут допустим.

## Порядок

1. **Договорись о рамке.** Какие документы, какие столбцы, куда кладём результат. Если столбцы
   не названы — предложи набор под задачу и покажи его до запуска, а не после.
2. **Собери схему** и запиши в `.shema-revyu.yaml` рядом с документами. Схема — контракт: без неё
   вторая половина пакета будет размечена иначе, чем первая.
3. **Пробный прогон на 3–5 документах.** Покажи результат, поправь схему, подтверди. Пропуск этого
   шага — главная причина переделки всего пакета.
4. **Основной проход.** Документы независимы — их можно обрабатывать параллельно. В каждой ячейке:
   значение, статус, дословная цитата, место (пункт, страница).
5. **Проход нормализации.** Одно и то же условие в разных договорах названо по-разному; приведи
   значения к общему словарю и выведи выбросы отдельно.
6. **Выгрузка** — `.csv` (таблица), `_istochniki.csv` (цитаты и места), `.md` (читаемая версия).
7. **Сводка о работе**, а не о находках: сколько ячеек требует глазами человека, какие столбцы
   оказались ненадёжными, где лежат файлы.

## Схема

```yaml
zadacha: "Триггеры смены контроля в договорах ООО «Ромашка»"
dokumenty: "./dogovory/"
stolbcy:
  - imya: kontragent
    tip: text
    iskat: "наименование стороны, отличной от проверяемой компании"
  - imya: srok_dejstviya
    tip: date_or_text
    iskat: "срок действия договора, автопролонгация"
  - imya: trigger_smeny_kontrolya
    tip: enum
    znacheniya: [net, uvedomlenie, soglasie, otkaz, rastorzhenie, neyasno]
    iskat: "условие, срабатывающее при смене участника, собственника, контроля"
  - imya: forum
    tip: text
    iskat: "суд или третейская оговорка, применимое право"
normalizaciya:
  srok_dejstviya: "приводить к ГГГГ-ММ-ДД либо «бессрочно» либо «до наступления события»"
```

**Типы столбцов:** `text`, `date_or_text`, `money`, `enum`, `yes_no_unclear`. Тип — не украшение:
по нему проверяется нормализация и ловятся выбросы.

## Статус ячейки — обязателен

| Статус | Когда | Что делает человек |
|---|---|---|
| `naideno` | условие есть, цитата приведена | сверяет цитату |
| `otsutstvuet` | условия в документе нет — проверено | подтверждает выборочно |
| `neyasno` | формулировка допускает два прочтения | читает пункт целиком |
| `ne_prochitano` | скан, нечитаемый формат, часть файла | решает, добывать ли текст |

`otsutstvuet` и `ne_prochitano` **не одно и то же**, и слияние их — самая дорогая ошибка
табличного ревью: пустая ячейка читается как «условия нет», хотя документ просто не открылся.
Пустых ячеек в выводе быть не должно вовсе.

## Цитата и место

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

## Нормализация и выбросы

После основного прохода:
- привести значения к словарю схемы (`enum` — строго, `date` — к формату);
- вывести **выбросы**: единственный договор с иностранным форумом, единственный со штрафной
  неустойкой, единственный бессрочный;
- вывести **несогласованность**: одинаковые по смыслу условия, размеченные по-разному, — это
  дефект схемы, а не свойство пакета.

Выбросы полезнее средних значений: в проверке перед сделкой интересен именно нетипичный договор.

## Большой пакет

Больше ~50 документов или ~500 страниц — скажи заранее, сколько это займёт и что будет выдано
партиями. Не начинай проход, который не поместится в один ответ, без предупреждения: молчаливое
усечение выглядит как готовая таблица. Охват фиксируй в сводке: «прочитано 180 из 200, не открылись
20 — список ниже».

## Проверки перед выдачей

- [ ] Схема согласована и пробный прогон подтверждён
- [ ] Пустых ячеек нет: у каждой статус, `otsutstvuet` отделён от `ne_prochitano`
- [ ] В каждой заполненной ячейке дословная цитата и место
- [ ] Проведена нормализация, выбросы и несогласованности выведены отдельно
- [ ] Маршрут выгрузки проверен на ПДн (ч. 5 ст. 18 ФЗ-152), по умолчанию — локально
- [ ] В сводке сказано, сколько ячеек требует проверки человеком
- [ ] В выводе прямо сказано: ячейка — зацепка, не вывод

## Дальше

Дерево опций из профиля: передать таблицу в `perechen-dogovorov` для квалификации триггеров ·
поднять нетипичные договоры на разбор · собрать сводку (`svodka-dlya-komandy`) · дополнить
чек-лист закрытия найденными согласиями (`zakrytie-sdelki`).