# ⚖️ RusLaw: MCP & Agent Skills для законодательства РФ

[![CI](https://github.com/HowardSalibert/ruslaw/actions/workflows/ci.yml/badge.svg)](https://github.com/HowardSalibert/ruslaw/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)

**RusLaw** — это комплекс из **MCP-сервера** и **агентского скилла (`ruslaw-expert`)** для работы с законодательством Российской Федерации через любых современных ИИ-агентов (Claude, Cursor, Antigravity, Cline, Roo Code, ChatGPT).

> **Идея-фикс:** Вы спрашиваете агента о том, как регулируется любая жизненная или бизнес-ситуация по закону РФ, а агент отвечает **максимально актуальной информацией на сегодняшнюю дату** с дословными цитатами норм, статусом редакции и конкретными проверяемыми ссылками на первоисточники.

---

## ⚡ Главные возможности

* 🕒 **Временной якорь (Temporal Grounding):** Модели ИИ часто цитируют законы по состоянию на момент своего обучения. RusLaw заставляет агента привязываться к сегодняшней системной дате пользователя.
* 🔮 **Детекция будущих редакций:** Если закон уже принят, но вступает в силу через месяц или с 1 января следующего года, агент **обязательно** предупредит об этом.
* 🛡️ **Защита от устаревших норм (Repealed Check):** Если статья отменена или признана Конституционным Судом РФ неконституционной, агент прямо сообщит об этом и не будет ссылаться на неё как на действующее право.
* 🔗 **Проверяемые первоисточники:** Ссылки формируются только на официальные и легитимные порталы:
  * [КонсультантПлюс](https://www.consultant.ru/)
  * [Гарант](https://www.garant.ru/)
  * [Официальный интернет-портал правовой информации (pravo.gov.ru)](http://pravo.gov.ru/)
  * [СОЗД Государственной Думы (sozd.duma.gov.ru)](https://sozd.duma.gov.ru/)
* 🚫 **Нулевая толерантность к галлюцинациям:** Агенту запрещено выдумывать нормы из головы. При любых сомнениях предоставляется ссылка на официальный поиск.

---

## 🚀 Быстрый старт (для человека)

### 1. Установка и сборка
```bash
git clone https://github.com/HowardSalibert/ruslaw.git
cd ruslaw
npm install
npm run build
```

### 2. Автоматическая установка скилла в среду ИИ
Скрипт автоматически скопирует скилл `ruslaw-expert` в конфигурационные каталоги Cursor, Antigravity и Claude:
```bash
npm run setup:skills
```

---

## 🤖 Инструкция для ИИ-агента

Если вы попросили своего агента установить этот репозиторий, передайте ему эту команду:

> *"Склонируй репозиторий RusLaw, выполни `npm install && npm run build && npm run setup:skills` и подключи MCP-сервер из файла `dist/index.js` в мои настройки MCP."*

---

## ⚙️ Подключение к MCP-клиентам

```json
{
  "mcpServers": {
    "ruslaw": {
      "command": "node",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/К/dist/index.js"]
    }
  }
}
```

---

## 🛠️ Набор инструментов MCP (Tools)

| Инструмент | Назначение |
|---|---|
| `search_legislation` | Интеллектуальный поиск статей, кодексов и ФЗ по жизненным или юридическим запросам с фильтром по Консультанту/Гаранту/pravo.gov.ru. |
| `get_norm_text` | Извлечение чистого текста статьи в Markdown без рекламы и навигационного мусора. |
| `check_norm_status` | Проверка действующего статуса статьи, даты действующей редакции и выявление принятых будущих поправок с датой вступления в силу. |
| `track_bill` | Мониторинг законопроектов в Государственной Думе РФ (СОЗД) и текущей стадии их рассмотрения (1/2/3 чтения, СФ, Президент). |

*Каждый инструмент автоматически возвращает метаданные `metadata.current_system_date` для строгого временного якоря.*

---

## 📋 Формат ответа агента

Агент, использующий скилл `ruslaw-expert`, отвечает по единому стандарту юридической чистоты:

```markdown
### 📋 Правовое заключение: [Краткий вывод по вопросу]

**Разъяснение простыми словами:**
[Пошаговый план действий для пользователя]

**Применимая норма права:**
* **Закон/Кодекс:** Гражданский кодекс РФ (часть вторая)
* **Статья:** Статья 502, пункт 1

**Дословная цитата нормы:**
> «Покупатель вправе в течение четырнадцати дней с момента передачи ему непродовольственного товара... обменять купленный товар...»

**Статус актуальности (на дату: 2026-10-28):**
* 🟢 **Редакция:** Действующая (в ред. Федерального закона от 08.08.2024 № 287-ФЗ).
* ⚠️ **Будущие изменения:** Будущих изменений на данный момент не зарегистрировано.

**Проверяемые первоисточники:**
* [Открыть статью в КонсультантПлюс](https://www.consultant.ru/document/...)
* [Официальный текст на pravo.gov.ru](http://pravo.gov.ru/...)
```

---

## 🧪 Тестирование

Проект покрыт автоматическими тестами на реальных снапшотах правовых документов:
```bash
npm test
```

## 📄 Лицензия

Распространяется под свободной лицензией [MIT](LICENSE).