legal-review

Legal-Review — Первичный правовой анализ дела

Скилл выполняет комплексную правовую проверку дела и генерирует набор аналитических документов в .vassal/analysis/. Работает с Opus для глубокого анализа. Каждый вывод оформляется в аудируемом формате (см. shared/conventions.md → Аудируемость выводов).

Предварительные условия

• Дело инициализировано: .vassal/case.yaml существует.
• Документы приняты: index.yaml содержит хотя бы 1 документ.
• Рекомендуется: перед запуском провести catalog (чтобы в index.yaml были summary).
• Установлены зависимости: scripts/setup.sh.

Входные данные

1. case.yaml — карточка дела (стороны, суть спора, суд, представитель).
2. index.yaml — полный реестр документов с summary.
3. md-зеркала ключевых документов (скилл сам определяет, какие загрузить).
4. Вводная Сюзерена (опционально) — конкретные вопросы, которые нужно разобрать. Может быть передана как аргумент команды или файл.

Алгоритм

Фаза 1 — Загрузка контекста

1. Прочитай .vassal/case.yaml — получи стороны, предмет спора, суд, даты.
2. Прочитай .vassal/index.yaml — получи список документов.
3. Определи ключевые документы для анализа — те, которые нужно читать целиком:
   • Договор (основной) и все допсоглашения
   • Претензия / ответ на претензию
   • Исковое заявление (если есть)
   • Отзыв на иск (если есть)
   • Гарантийные письма, акты сверки — если есть
4. Загрузи md-зеркала ключевых документов из .vassal/mirrors/.
5. Для остальных документов достаточно summary из index.yaml.
6. Если Сюзерен передал вводную / вопросы — прочитай и зафиксируй.

Фаза 2 — Анализ (Opus)

Выполни каждый блок анализа. Каждый вывод оформляй в аудируемом формате:

**Вывод:** [заключение]
**Фактическое основание:** [на чём основано — факты из документов]
**Правовое основание:** [нормы, статьи, пункты]
**Источники:** [названия документов с датами — НЕ doc-ID; человек читает названия, а не идентификаторы]
**Уверенность:** высокая | средняя | низкая
**Недостающие данные:** [чего не хватает для уверенного вывода]

a) Ответы на вопросы Сюзерена → analysis/answers.md

Если Сюзерен задал конкретные вопросы — ответь на каждый в аудируемом формате. Если вопросов не было — пропусти этот блок.

b) Квалификация правоотношений → analysis/qualification.md

• Тип правоотношений (поставка, подряд, услуги, аренда, заём и т.д.)
• Применимые нормы (глава ГК РФ, специальные законы)
• Существенные условия договора — соблюдены ли
• Есть ли основания для признания договора незаключённым / недействительным

c) Пресекательные сроки → analysis/deadlines.md

Используй справочник references/deadlines-reference.md.

Для каждого выявленного срока:

Срок	Тип	Начало	Истечение	Статус
Исковая давность по основному долгу	материальный	дата	дата	действует / истёк / под вопросом
Срок на обжалование решения	процессуальный	дата	дата	...

Проверь:

• Исковая давность: общая (3 года ст. 196 ГК) и специальные
• Течение: с какого момента (ст. 200 ГК)
• Приостановление (ст. 202 ГК): претензионный порядок, форс-мажор, мораторий
• Перерыв (ст. 203 ГК): признание долга (акт сверки, гарантийное письмо, частичная оплата)
• Процессуальные сроки: обжалование (30 дн. апелляция, 2 мес. кассация), предъявление ИД (3 года)

d) Досудебный порядок → analysis/pretrial.md

Используй справочник references/pretrial-reference.md.

• Требуется ли обязательный досудебный порядок (ч. 5 ст. 4 АПК: 30 календарных дней)
• Есть ли в договоре особый срок / порядок претензионного урегулирования
• Претензия: направлена? когда? кому? каким способом? что заявлено?
• Ответ: получен? в срок?
• Вывод: досудебный порядок соблюдён / не соблюдён / соблюдён частично

e) Подсудность → analysis/jurisdiction.md

Используй справочник references/jurisdiction-reference.md.

• Компетентный суд (арбитражный / общая юрисдикция)
• Территориальная подсудность: по месту нахождения ответчика (ст. 35 АПК) / договорная (ст. 37 АПК) / исключительная (ст. 38 АПК)
• Проверь пророгационную / дерогационную оговорку в договоре
• Если дело уже подано — проверь, в правильный ли суд

f) Качество и полнота документов → analysis/completeness.md

Для каждого документа из index.yaml оцени:

• Читаемость (по полю quality в индексе)
• Полнота (completeness): есть ли все страницы, подписи, печати
• Юридическая значимость (оригинал / копия / скан)

Сформируй список:

• Имеющиеся доказательства — что есть и в каком состоянии
• Отсутствующие документы — что следует запросить у клиента
• Документы, требующие дополнительных действий — нотариальное заверение, апостиль, перевод, запрос оригинала

g) Вопросы клиенту → analysis/questions-to-client.md

Собери все вопросы, возникшие при анализе:

• Фактические вопросы (хронология событий, суммы, обстоятельства)
• Запрос недостающих документов (конкретный список)
• Уточнения по позиции клиента (что хочет: взыскать, отбить, мировое?)

Каждый вопрос пометь приоритетом: [!] критичный | [*] важный | [ ] желательный.

Фаза 3 — Preview

7. Покажи Сюзерену краткую сводку результатов в чате:

ПРАВОВОЙ АНАЛИЗ: {название дела}

Квалификация: {тип правоотношений}, {нормы}

Сроки:
  Исковая давность: {статус} (до {дата})
  Процессуальные: {ближайший дедлайн}

Досудебный порядок: {соблюдён / не соблюдён / частично}

Подсудность: {суд} — {корректно / некорректно / под вопросом}

Документы: {N} в наличии, {M} недостаёт

Вопросы клиенту: {K} вопросов ({X} критичных)

Сохранить правовое заключение?

Дополнительно предложи:
`Сгенерировать схему сторон дела как sidecar-превью в .vassal/visuals/? (да/нет)
Схема — AI-generated, не является доказательством. НЕ будет встроена в заключение.`

8. Дождись подтверждения. Если Сюзерен корректирует — внеси правки.

Фаза 3.5 — Контрольное ревью (Codex xhigh, read-only)

1. Сохрани черновик анализа во временный файл .vassal/drafts/{ГГГГ-ММ-ДД}-legal-review-draft.md (создай директорию, если нет).
2. Прочитай skills/codex-invocation/SKILL.md.
3. Собери prompt из prompts/analytical-reviewer.md, подставь:
   • case_root: абсолютный путь к делу
   • plugin_root: по 3-tier fallback
   • output_path: путь к черновику .vassal/drafts/{ГГГГ-ММ-ДД}-legal-review-draft.md
   • original_input: вводная Сюзерена (вопросы/запрос)
   • extra_constraints: пусто
   • report_contract: из prompts/_preamble.md
4. Проверь: grep -c "{{" → 0.
5. Диспатч: codex-companion.mjs task --background --effort xhigh (БЕЗ --write — ревью read-only).
6. Мониторь статус (until/case loop, sleep 25). Fetch result.
7. Разбор результата:
   • Если первая строка REVIEW_OK:
     • переходи к фазе 4 (Apply)
     • покажи Сюзерену NITS (если есть) как ℹ️ FYI
   • Если первая строка REVIEW_BLOCKING:
     • подсчитай количество BLOCKING-блоков и NITS
     • сохрани полный отчёт в .vassal/reviews/{ГГГГ-ММ-ДД}-legal-review.md с фронтматтером:

       ---
       skill: legal-review
       target_output: .vassal/drafts/{ГГГГ-ММ-ДД}-legal-review-draft.md
       reviewer: codex-xhigh
       reviewed_at: <ISO datetime>
       verdict: REVIEW_BLOCKING
       blocking_count: <N>
       nits_count: <M>
       ---
       

     • покажи Сюзерену summary:

       Ревью выявило N блокирующих замечаний:
       - <тема BLOCKING 1>
       - <тема BLOCKING 2>
       ...
       Полный отчёт: .vassal/reviews/{ГГГГ-ММ-ДД}-legal-review.md
       
       Варианты:
       (a) Принять как есть — продолжить apply с этим черновиком
       (b) Один раунд Opus фикса — отправить черновик на доработку
       (c) Вручную — самостоятельно отредактировать черновик
       

     • дождись выбора
     • если (b) — один раунд Opus на основе BLOCKING-блоков, без цикла; после этого возобнови с фазы 3.5
     • если (a) — добавь <!-- reviewed: accepted-over-objection --> в черновик
     • если (c) — жди правки

Фаза 4 — Apply

Два уровня сохранения:

a) Единый документ для Сюзерена — корень папки дела: {ГГГГ-ММ-ДД} Предварительный анализ документов.md

Собери весь анализ в один связный документ. Сохрани в корневой папке дела. Имя файла начинается с даты. Структура:

# Предварительный анализ документов по делу {номер / название}

Дата: {ГГГГ-ММ-ДД}

## 1. Квалификация правоотношений
{содержание блока b)}

## 2. Пресекательные сроки
{содержание блока c) — таблица + выводы}

## 3. Досудебный порядок
{содержание блока d)}

## 4. Подсудность
{содержание блока e)}

## 5. Оценка полноты документов
{содержание блока f)}

## 6. Вопросы клиенту
{содержание блока g)}

{## 7. Ответы на вопросы Сюзерена — если были}

Каждый вывод в теле разделов — в аудируемом формате.

b) Отдельные файлы для агента — .vassal/analysis/{секция}.md

Параллельно сохрани каждый блок отдельным файлом (qualification.md, deadlines.md, pretrial.md, jurisdiction.md, completeness.md, questions-to-client.md). Это нужно для переиспользования другими скиллами (build-position читает deadlines.md отдельно, а не весь анализ).

c) Обновление карточки дела

9. Обнови case.yaml (заполни поля: подсудность, досудебный порядок, квалификация).
10. Добавь запись в .vassal/history.md:

    ### {ЧЧ:ММ} — Правовой анализ (legal-review)
    - Квалификация: {тип}
    - Исковая давность: {статус}
    - Досудебный порядок: {статус}
    - Подсудность: {суд} — {статус}
    - Недостающих документов: {M}
    - Вопросов клиенту: {K}
    

9.5. Если Сюзерен ответил да на предложение визуализации: - прочитай skills/visualize/SKILL.md - передай VISUAL_TYPE=parties-scheme, CONTEXT=[сжатый контекст сторон и спора из case.yaml] - дождись результата visualize - сообщи Сюзерену: Схема сторон сохранена в .vassal/visuals/{ГГГГ-ММ-ДД}-parties-scheme.png - правило: НЕ добавляй ссылку на картинку в правовое заключение и ни в какой другой документ дела

d) Артефакт контрольного ревью

Если фаза 3.5 выполнялась, сохрани или обнови .vassal/reviews/{ГГГГ-ММ-ДД}-legal-review.md:

• если результат был REVIEW_OK и файла ещё нет — создай review-артефакт с тем же фронтматтером, но verdict: REVIEW_OK, blocking_count: 0, nits_count: <M>
• если результат был REVIEW_BLOCKING, а Сюзерен выбрал (a) — сохрани verdict: REVIEW_BLOCKING и добавь явную пометку accepted-over-objection
• если результат был REVIEW_BLOCKING, а после одного раунда Opus замечания сняты — обнови verdict на REVIEW_OK

11. Спроси Сюзерена: «Сформировать .docx?» Если да — используй скилл arbitrum-docx для оформления.

Выходные файлы

Файл	Назначение	Для кого
{ГГГГ-ММ-ДД} Предварительный анализ документов.md (корень дела)	Единый анализ	Сюзерен
analysis/qualification.md	Квалификация	агент
analysis/deadlines.md	Сроки	агент
analysis/pretrial.md	Досудебный порядок	агент
analysis/jurisdiction.md	Подсудность	агент
analysis/completeness.md	Полнота документов	агент
analysis/questions-to-client.md	Вопросы клиенту	агент
analysis/answers.md	Ответы на вопросы Сюзерена	агент (если были вопросы)

Идемпотентность

Повторный запуск перезаписывает файлы в analysis/. Перед перезаписью покажи diff (что изменилось с прошлого раза) в preview.

Граничные случаи

• Нет ни одного документа в индексе → сообщи, что анализировать нечего, предложи intake.
• Нет договора → анализ возможен, но пометь: «Договор отсутствует, выводы по квалификации предварительные».
• Данных недостаточно для вывода → не додумывай, честно укажи «Недостающие данные» и уверенность «низкая».
• Противоречия между документами → зафиксируй в completeness.md и в questions-to-client.md.
• Нестандартный спор (не из ГК) → примени ту же структуру анализа, адаптируй нормативную базу.

Маршрутизация моделей

• Opus: весь правовой анализ (фаза 2) — сложная аналитическая работа.
• Sonnet: preview, форматирование, сохранение файлов.
• Codex xhigh: контрольное ревью (фаза 3.5) — read-only, аудируемый формат BLOCKING.