# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Что это за репозиторий

Кода здесь нет. Это корпус проектной документации на русском языке по вымышленной вселенной «Энергативы»: физика EF-излучения, её биологические и технологические следствия, лор и техническое задание на аддон к моду **HBM's Nuclear Tech Mod** (Minecraft).

Сборки, тестов, линтеров, зависимостей нет. Единственные операции — правка Markdown и git. Не изобретайте команды сборки и не добавляйте тулинг без явной просьбы.

| Путь | Роль |
| --- | --- |
| `energative/` | **Канон.** Единственный источник истины. Всё, что утверждается о вселенной, берётся отсюда |
| `Myasko_Energative.docx` | Первоисточник: экспорт чата с ИИ, из которого вырос канон. Хронологический, содержит отвергнутые гипотезы и промежуточные версии. **Не канон** |
| `.tmp/` | Не трекается. Черновики, промежуточные выгрузки, извлечённое содержимое первоисточника |

## Архитектура корпуса

`energative/` — 9 нумерованных документов плюс README-оглавление. Порядок номеров = порядок вывода: каждый следующий слой опирается на предыдущие.

```
01 ef-field-theory   физика поля — фундамент, на него ссылается всё остальное
02 biology           действие на организм: следствие из 01
03 periodic-table    реестр 11 элементов: номера, обозначения, EF-класс, T½
04 teltnite          материаловедение элемента №1 (сплавы, обработка)
05 power-and-weapons РЭС и БЭС, риценитовые излучатели — применение 03–04
06 protection        экранирование, снаряжение, дозиметрия, ТБ
07 lore              история, политика, объекты, персоналии
08 hbm-addon         ТЗ на аддон: перевод 01–07 в игровые правила
09 sources-and-open-questions   внешние опоры + всё незакрытое (общий для комплекта)
```

**Главное правило разделения** (закреплено в [energative/README.md:5](energative/README.md)): документы 01–08 описывают **только принятые решения**. Отвергнутые гипотезы, альтернативные варианты и незакрытые вопросы живут исключительно в 09. Не вносите в 01–08 формулировки вида «возможно», «вариант Б», «требует уточнения» — такое выносится в 09.

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

## Где чей канон (проверять перед правкой чисел)

| Факт | Канонический файл |
| --- | --- |
| Состав элементов, обозначения, стабильность, T½, EF-уровень | [03-periodic-table.md](energative/03-periodic-table.md), сводная таблица |
| Шкала классов опасности и биологический эффект | [02-biology.md](energative/02-biology.md) |
| Численные пороги дозы (0–1000, `cap` по элементам) | [08-hbm-addon.md](energative/08-hbm-addon.md) — 02 ссылается на него, а не дублирует |
| Ступени снаряжения 0–V, дозиметры, знак опасности | [06-protection.md](energative/06-protection.md) |
| Параметры РЭС и БЭС, поражающие факторы | [05-power-and-weapons.md](energative/05-power-and-weapons.md) |
| Свойства, обработка и сплавы Тельтнита | [04-teltnite.md](energative/04-teltnite.md) |
| Даты, объекты, расстановка сил | [07-lore.md](energative/07-lore.md) |

Меняя число или свойство, найдите обратные ссылки на него в остальных файлах: тот же элемент фигурирует в 3–5 документах в разных ролях (физика → биология → техника → игровой баланс), и расхождение таблиц — основной способ сломать этот корпус.

## Инварианты канона

Нарушение любого из них требует явного согласования с пользователем, а не правки «по месту».

- **EF-поле не ионизирует.** Лучевых ожогов, некроза, разрушения ДНК нет; воздействие обратимо. Свинец, бетон, вода бесполезны — единственный барьер — Тельтнит и его сплавы (прежде всего Т-Иридий).
- **Монотонность по номеру.** С ростом номера элемента растут масса, хрупкость и активность, а срок жизни падает. Чем сильнее излучение, тем короче жизнь.
- **Рубеж 4/5.** Класс 4 (Алленит) — обратимая кома, класс 5 (Риценит) — неотвратимая смерть за секунды. Эта граница несущая: на ней держатся и ТБ, и военная доктрина, и игровой баланс.
- **Пороговое насыщение.** Доза не растёт бесконечно: у каждого источника свой потолок, и слабый источник не убивает сколь угодно долгой экспозицией. Это заявленное отличие от радиации HBM.
- **Замкнутый круговорот массы.** RC → 50 % TT + 50 % VR + тепло + поле. Материя не теряется, вечного заражения местности не остаётся.
- **Единственный вход в систему** — бомбардировка Тельтнита альфа-частицами на ускорителе (TT → EG). Элементы 5–11 промышленно получаются только в РЭС или в эпицентре БЭС; на ускорителе — единичные атомы.
- **Незакрытая номенклатура.** Элементы 6–9 и 11 официальных имён не имеют, для Фюрцита предпочтителен вариант Viercite (VR), FC — устаревший синоним. Не придумывайте имена и обозначения молча: сначала правка в 09.

## Конвенции документов

- Язык — русский. Термин при вводе: русское название, латинская пара курсивом, обозначение полужирным — `Тельтнит *(Teltnitte)* **TT**`.
- Один `#` на файл, сразу за ним абзац-аннотация о назначении документа. Разделы — `##`. Нумерация разделов не унифицирована по комплекту (01 — римские цифры, 08 — арабские, остальные без номеров): сохраняйте стиль конкретного файла.
- Таблицы — GFM с разделителем `| --- |`. Формулы — `$...$` в строке, `$$...$$` блоком. Схемы и цепочки синтеза — fenced-блоки без языка, выравнивание пробелами значимо.
- Перекрёстные ссылки внутри комплекта — относительные, без каталога: `[02-biology.md](02-biology.md)` в тексте или `[04](04-teltnite.md)` в таблицах.
- Новый документ = новая строка в таблице «Состав» в [energative/README.md](energative/README.md); новое сокращение = строка в «Ключевых сокращениях» там же.

## Игровой слой (08)

- Платформа: HBM's Nuclear Tech Mod, Minecraft **1.12.2** (для обкатки механик допустима 1.18.2).
- EF-доза — отдельная скрытая переменная `energative_dose` (0–1000), работающая **параллельно** радиации HBM и не заменяющая её.
- Идентификаторы кода и конфигов — латиница/snake_case (`energative_dose`, `speed`, `cap`); внутриигровые строки, сообщения и названия — по-русски.
- Транслитерация «энергатив» — только через `a`: `Energative Field`, `energative_dose`, `energatives`. Вариант через `e` (`energetive`) считается опечаткой.
- Неймспейс аддона — `energatives` (он же каталог датапака `data/energatives/`). Префикс `hbm:` принадлежит базовому моду и в идентификаторах аддона не используется.
- Любая механика в 08 обязана иметь физическое или лорное обоснование в 01–07. Если обоснования нет — вопрос идёт в 09, а не досочиняется в ТЗ.

## Временные файлы

Всё временное — скрипты разбора, черновики, промежуточные выгрузки, эксперименты — создавать только в `.tmp/` (в `.gitignore`). Содержимое `.tmp/` никогда не цитируется как канон и не попадает в коммиты.