# AGENTS.md

Инструкции для ИИ-агентов, которые работают с этим репозиторием.

## Что это

Русская адаптация скилла [avoid-ai-writing](https://github.com/conorbronsdon/avoid-ai-writing): два скилла (`skills/avoid-ai-writing-russian`, `skills/antiplagiat`) и детектор на TypeScript для Bun (`src/`). Всё пишется на русском: документация, комментарии, сообщения коммитов. Идентификаторы в коде — на английском.

## Устройство

- `skills/avoid-ai-writing-russian/SKILL.md` — точка входа скилла: договор о правке, режимы, уровни серьёзности, формат ответа, «никогда не добавляй». Держать короче 500 строк.
- `skills/avoid-ai-writing-russian/references/patterns.md` — каталог примет, профили контекста и голоса.
- `skills/antiplagiat/SKILL.md` — под-скилл подготовки к «Антиплагиату».
- `src/text.ts` — нормализация (невидимые символы, подмена букв, ё→е) с картой смещений, маскирование защищённых областей, разбиение на блоки и предложения.
- `src/lexicon.ts` — словари примет на мини-языке фраз (`*` — любое окончание).
- `src/detect.ts` — детектор: словари, отпечатки, типографика, структура, стилометрия, оценка.
- `src/antiplagiat.ts` — оценка по фрагментам и калибровка.
- `src/validate.ts` — проверка сохранности правки.
- `src/cli.ts` — команда `aiw-ru`.

## Правила

- Любое правило детектора должно быть описано в `patterns.md`. Обратное не обязательно: правила на суждение живут только в каталоге.
- Новый тип находки получает вес в `WEIGHTS`, подпись в `TYPE_LABELS` и тест.
- Правило не должно срабатывать на `test/fixtures/human.md`; точность важнее полноты.
- Не писать невидимые символы в исходники буквально: только `\uXXXX`.
- Скилл помогает автору с его собственным текстом и с оформлением заимствований как цитирований. Не добавлять приёмы, которые маскируют чужой текст или обманывают проверку техническими уловками.
- Документация проекта должна проходить `bun run selfscan` без находок P0 и P1.

## Команды

```bash
bun test
```

```bash
bun run typecheck
```

```bash
bun run selfscan
```