From b1dea33660aeeee1d002a26e142e44ba25183b71 Mon Sep 17 00:00:00 2001 From: jar3b Date: Wed, 29 Jul 2026 16:20:15 +0300 Subject: [PATCH] fix: agents file --- AGENTS.md | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ CLAUDE.md | 83 +------------------------------------------------------ 2 files changed, 83 insertions(+), 82 deletions(-) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..3d923f5 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,82 @@ +# 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/` никогда не цитируется как канон и не попадает в коммиты. diff --git a/CLAUDE.md b/CLAUDE.md index 3d923f5..eef4bd2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,82 +1 @@ -# 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/` никогда не цитируется как канон и не попадает в коммиты. +@AGENTS.md \ No newline at end of file