КнигаЛейлина

Правила работы с книжным проектом

AGENTS.md

Область действия

Эти правила действуют для всей папки проекта и всех вложенных файлов. Проект включает рукопись, новые главы, Библию мира, карточки сущностей, хронологию, редакторские отчёты и Obsidian-хранилище.

Текущая рабочая база находится по адресу:

Книга_Лейлина/Библия (репозиторий warlock)

Старый путь Codex больше не рабочий. Рукопись: Библия/Chapters/. Карточки: Библия/Bible/Cards/. Реестры: Библия/System/.

Главные принципы

  1. Не выдумывать канон, факты, имена, связи, причины и объяснения.
  2. Отделять объективное событие от мнения персонажа, слуха, легенды, предположения и авторского решения.
  3. Не менять рукопись без прямой просьбы автора. Анализ и исправление текста — разные задачи.
  4. Сохранять авторский стиль. Предлагать минимальную правку, достаточную для устранения проблемы.
  5. Не считать загадку, ненадёжного рассказчика, временной скачок, маскировку или публичную легенду ошибкой без проверки контекста.
  6. Не объявлять анализ полным после выборочной проверки. Полный аудит требует проверки всех глав и сцен.
  7. Перед началом работы проверять, какой файл является последней версией. Старые версии не смешивать с текущей рукописью.

Приоритет источников

При конфликте использовать следующий порядок авторитетности:

  1. Прямое подтверждённое решение автора.
  2. Текущая рукопись — для событий, уже показанных на странице.
  3. Актуальная Библия мира и её канонические правила.
  4. Старые версии рукописи, планы и черновые заметки.
  5. Реплики персонажей, слухи, легенды и внутримировые гипотезы.

Конфликт не удалять молча. Зафиксировать обе стороны и указать, какой источник управляет предлагаемой правкой.

Импорт новой главы

При получении новой главы:

  1. Сохранить исходный файл без изменения.
  2. Зафиксировать дату, путь, диапазон глав и SHA-256.
  3. Проверить номер и название главы, отсутствие пропусков и случайных дублей.
  4. Извлечь текст без потери абзацев, реплик, таблиц, сносок и маркеров POV.
  5. Разбить главу на сцены с POV, местом, временем и границами переходов.
  6. Обновить реестры сущностей, фактов, событий, состояний, знаний, отношений, предметов и обещаний.
  7. Для каждой новой сущности создать отдельную карточку в подходящей папке.
  8. Добавить [[wikilinks]] на существующие карточки. Не создавать дубли из-за склонения, регистра или варианта написания.
  9. Проверить новую главу против всей предыдущей рукописи и Библии, а не только против соседней главы.
  10. Новые неразрешённые вопросы заносить в очередь решений с точной цитатой и приоритетом.

Карточки сущностей

Отдельные карточки создавать для персонажей, организаций, мест, видов флоры и фауны, артефактов, материалов, заклинаний, техник, правил мира и значимых событий.

Каждая карточка должна содержать:

  • стабильный ID;
  • каноническое название;
  • алиасы и ошибочные варианты отдельно;
  • тип сущности;
  • краткое описание;
  • подтверждённые свойства;
  • первое и последующие появления;
  • точные источники по главам;
  • связи с другими карточками через [[wikilinks]];
  • статус достоверности;
  • открытые вопросы без догадок.

Безымянные или агрегированные объекты не превращать в полноценные именованные виды. Помечать их кандидатами до появления собственного названия.

Граф точных связей

Живой JSON связей: canon-graph/graph.json. Схема: canon-graph/schema.json.

При импорте главы, вопросе «кто связан с кем» и любом изменении отношений применять навык book-canon-graph. Не выдумывать ребро. confirmed только с цитатой из рукописи. После записи гонять Скиллы/book-canon-graph/scripts/validate_canon_graph.py.

Graphify установлен в проекте (graphify-out/.graphify_python) и служит вторичным индексом. Его INFERRED рёбра не копировать в канон.

Проверка непрерывности

Для полного аудита применять навык book-continuity-auditor и проверять каждую сцену по 12 направлениям:

  1. POV, время и место.
  2. Имена, алиасы, возраст и внешность.
  3. Ранг, характеристики, травмы, способности и ограничения.
  4. Знания, тайны и доступ персонажей к информации.
  5. Мотивация, эмоции, отношения и лояльность.
  6. События, причинность и последствия.
  7. Обещания, предвестники и развязки.
  8. География, маршруты, расстояния и время в пути.
  9. Предметы, ресурсы, владение, расход и экономика.
  10. Магические, биологические, технологические и политические правила.
  11. Флора, фауна, материалы и прочие сущности.
  12. Повторы прозы и диалогов, POV-переходы, ритм и связность сцен.

Для каждого прохода ставить checked_found с доказательством либо checked_none. Пустые ячейки запрещены.

Классификация находок

Использовать только следующие статусы:

  • confirmed_contradiction — два несовместимых факта либо факт против явного правила;
  • probable_continuity_error — вероятная ошибка с одним неразрешённым допущением;
  • possible_issue — кандидат для проверки автором;
  • intentional_or_explained — кажущееся противоречие объяснено текстом;
  • editorial_repetition — избыточный повтор;
  • transition_or_pacing — проблема перехода, темпа или ритма;
  • author_decision_needed — требуется выбор автора;
  • no_issue — проверено и отклонено; хранить только в матрице покрытия.

Важность: critical, high, medium, low. Уверенность: confirmed, high, medium, low.

Подтверждённое противоречие обязательно должно иметь две точные стороны доказательства или одну цитату и нарушенное каноническое правило.

Формат каждого замечания

Указывать:

  • стабильный ID;
  • статус, важность и уверенность;
  • книгу, главу, сцену и путь к файлу;
  • короткую точную цитату для поиска;
  • конфликтующую цитату или каноническое правило;
  • тип и источник знания каждой стороны;
  • объяснение проблемы;
  • минимальное исправление;
  • вариант формулировки, если он действительно нужен;
  • связанные ID сущностей и событий;
  • необходимость подтверждения автором.

Дубли замечаний объединять, не теряя источники.

Повторы и переходы

Частотность является сигналом для проверки, а не автоматической ошибкой. Не удалять мотивы, ритуальные формулы, цитаты, намеренные повторы дневников, характерные реплики и сюжетные возвращения.

Проверять:

  • точные и близкие повторы реплик;
  • повторное изложение одной информации без новой функции;
  • скопления одинаковых жестов, вводных связок и начал абзацев;
  • смену POV, времени или места без маркера;
  • повторение начала новой главы после финала предыдущей;
  • переходы, которые понятны технически, но не оправданы эмоционально.

Ранее подтверждённые автором переходы не возвращать в список ошибок без новых доказательств.

Подтверждённые решения автора

Эти решения имеют приоритет:

  • каноническое имя — Марлина;
  • «Король Ледяных Скорпионов» и «Император Ледяных Скорпионов» равнозначны;
  • масштаб столицы и ежедневные тысячи погибающих/рождающихся соответствуют замыслу;
  • для перестройки требуется ровно 2500 туш первого ранга;
  • костный мозг улучшается вместе с костями и отвечает за кроветворение;
  • спинной мозг перестраивается отдельно как часть нервной системы;
  • схема развития третьего ранга из главы 140 является канонической;
  • ранее разобранные и оставленные автором переходы не считать ошибками автоматически.

Перед использованием сверять этот список с актуальным System/AuthorDecisionRegistry.csv: реестр является текущим источником решений.

Безопасность изменений

  1. Перед массовыми правками создать резервную копию или новый вариант файла.
  2. Не удалять пользовательские файлы и не перезаписывать исходный DOCX.
  3. Не выполнять пакетную замену имён без проверки омонимов, цитат и исторических алиасов.
  4. Не менять стабильные ID карточек после публикации ссылок.
  5. После изменения карточек проверить отсутствующие и битые [[wikilinks]].
  6. После изменения рукописи повторно проверить затронутые сцены и все связанные факты.
  7. В конце сообщить, какие файлы изменены, что проверено и что осталось вопросом автора.

Завершение полного аудита

Полный аудит считается завершённым только когда:

  • все заявленные источники прочитаны или явно исключены с причиной;
  • количество извлечённых глав и сцен совпадает с инвентарём;
  • каждая сцена имеет ровно 12 строк покрытия;
  • каждая находка содержит проверяемую цитату;
  • все дубли замечаний объединены;
  • проведены второй проход на полноту и финальный отрицательный проход;
  • валидатор реестра завершился без ошибок.