Правила работы с книжным проектом
AGENTS.mdОбласть действия
Эти правила действуют для всей папки проекта и всех вложенных файлов. Проект включает рукопись, новые главы, Библию мира, карточки сущностей, хронологию, редакторские отчёты и Obsidian-хранилище.
Текущая рабочая база находится по адресу:
Книга_Лейлина/Библия (репозиторий warlock)
Старый путь Codex больше не рабочий. Рукопись: Библия/Chapters/. Карточки: Библия/Bible/Cards/. Реестры: Библия/System/.
Главные принципы
- Не выдумывать канон, факты, имена, связи, причины и объяснения.
- Отделять объективное событие от мнения персонажа, слуха, легенды, предположения и авторского решения.
- Не менять рукопись без прямой просьбы автора. Анализ и исправление текста — разные задачи.
- Сохранять авторский стиль. Предлагать минимальную правку, достаточную для устранения проблемы.
- Не считать загадку, ненадёжного рассказчика, временной скачок, маскировку или публичную легенду ошибкой без проверки контекста.
- Не объявлять анализ полным после выборочной проверки. Полный аудит требует проверки всех глав и сцен.
- Перед началом работы проверять, какой файл является последней версией. Старые версии не смешивать с текущей рукописью.
Приоритет источников
При конфликте использовать следующий порядок авторитетности:
- Прямое подтверждённое решение автора.
- Текущая рукопись — для событий, уже показанных на странице.
- Актуальная Библия мира и её канонические правила.
- Старые версии рукописи, планы и черновые заметки.
- Реплики персонажей, слухи, легенды и внутримировые гипотезы.
Конфликт не удалять молча. Зафиксировать обе стороны и указать, какой источник управляет предлагаемой правкой.
Импорт новой главы
При получении новой главы:
- Сохранить исходный файл без изменения.
- Зафиксировать дату, путь, диапазон глав и SHA-256.
- Проверить номер и название главы, отсутствие пропусков и случайных дублей.
- Извлечь текст без потери абзацев, реплик, таблиц, сносок и маркеров POV.
- Разбить главу на сцены с POV, местом, временем и границами переходов.
- Обновить реестры сущностей, фактов, событий, состояний, знаний, отношений, предметов и обещаний.
- Для каждой новой сущности создать отдельную карточку в подходящей папке.
- Добавить
[[wikilinks]]на существующие карточки. Не создавать дубли из-за склонения, регистра или варианта написания. - Проверить новую главу против всей предыдущей рукописи и Библии, а не только против соседней главы.
- Новые неразрешённые вопросы заносить в очередь решений с точной цитатой и приоритетом.
Карточки сущностей
Отдельные карточки создавать для персонажей, организаций, мест, видов флоры и фауны, артефактов, материалов, заклинаний, техник, правил мира и значимых событий.
Каждая карточка должна содержать:
- стабильный 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 направлениям:
- POV, время и место.
- Имена, алиасы, возраст и внешность.
- Ранг, характеристики, травмы, способности и ограничения.
- Знания, тайны и доступ персонажей к информации.
- Мотивация, эмоции, отношения и лояльность.
- События, причинность и последствия.
- Обещания, предвестники и развязки.
- География, маршруты, расстояния и время в пути.
- Предметы, ресурсы, владение, расход и экономика.
- Магические, биологические, технологические и политические правила.
- Флора, фауна, материалы и прочие сущности.
- Повторы прозы и диалогов, 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: реестр является текущим источником решений.
Безопасность изменений
- Перед массовыми правками создать резервную копию или новый вариант файла.
- Не удалять пользовательские файлы и не перезаписывать исходный DOCX.
- Не выполнять пакетную замену имён без проверки омонимов, цитат и исторических алиасов.
- Не менять стабильные ID карточек после публикации ссылок.
- После изменения карточек проверить отсутствующие и битые
[[wikilinks]]. - После изменения рукописи повторно проверить затронутые сцены и все связанные факты.
- В конце сообщить, какие файлы изменены, что проверено и что осталось вопросом автора.
Завершение полного аудита
Полный аудит считается завершённым только когда:
- все заявленные источники прочитаны или явно исключены с причиной;
- количество извлечённых глав и сцен совпадает с инвентарём;
- каждая сцена имеет ровно 12 строк покрытия;
- каждая находка содержит проверяемую цитату;
- все дубли замечаний объединены;
- проведены второй проход на полноту и финальный отрицательный проход;
- валидатор реестра завершился без ошибок.