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): документы 01–08 описывают только принятые решения. Отвергнутые гипотезы, альтернативные варианты и незакрытые вопросы живут исключительно в 09. Не вносите в 01–08 формулировки вида «возможно», «вариант Б», «требует уточнения» — такое выносится в 09.

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

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

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

Игровой слой (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/ никогда не цитируется как канон и не попадает в коммиты.

11 KiB Raw Permalink Blame History Unescape Escape