fix: agents file
This commit is contained in:
@@ -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/` никогда не цитируется как канон и не попадает в коммиты.
|
||||
@@ -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
|
||||
Reference in New Issue
Block a user