ШІ Асистент Письменика

Самвидав з Claude Code

1. Від чернетки до PDF: редактура, бета-ридінг, переклад і верстка в одному репозиторії
2. Про цю книжку

Частина I. Як влаштований самвидав

Розділ 1. Маршрут рукопису

1. Чому порядок важить більше за старанність
2. Сім етапів
3. Скільки це триває насправді
4. Що відбувається, коли етапи змішують
5. Що з цього можна автоматизувати
6. Тому вся архітектура, описана далі, побудована навколо одного розділення: машина називає симптом, автор призначає лікування. Скіли, промпти й команди в цьому проєкті написані так, щоб модель фізично не могла з’їхати в режим співавтора. Це не перестраховка, це те, від чого залежить, чи лишиться книжка вашою.

Розділ 2. Хто є хто

1. Альфа-рідер
2. Бета-рідер
3. Редактор
4. Коректор
5. Критик
6. Перекладач
7. Верстальник

Розділ 3. Машина в кожній із цих ролей

1. Чому це працює краще, ніж очікується
2. Чому це працює гірше, ніж обіцяють
3. Розподіл роботи
4. Не віддавайте машині: рішення про структуру, фінал, долю персонажів, назву. І не віддавайте їй перше написання — бо тоді редагувати не буде чого.

Частина II. Інструменти

Розділ 4. Markdown: чому не Word

1. Проблема, якої ви ще не помітили
2. Що таке Markdown
3. Шість причин, чому це краще за Word для книжкового проєкту
4. Чого Markdown не вміє
5. Як редагувати MD-файли
6. Як перенести те, що вже написано в Word
7. Одна порада наостанок
8. У цій книжці й у ZIP-архіві скрізь використовується ***.

Розділ 5. Visual Studio Code: встановлення й налаштування

1. Що це і навіщо воно письменнику
2. Встановлення на Windows
3. Встановлення на macOS
4. Перший запуск: п’ять налаштувань
5. Ще три, якщо хочеться писати комфортно
6. Два розширення
7. Як відкрити проєкт

Розділ 6. Термінал: сім команд, яких достатньо

1. Чорне вікно, якого не треба боятися
2. Як його відкрити
3. Як читати те, що там написано
4. Сім команд
5. Вставка тексту
6. Що робити, коли команда не спрацювала
7. Одна порада на завершення

Розділ 7. Python: щоб скрипти працювали

1. Навіщо він тут
2. Чи він у вас уже є
3. Встановлення на Windows
4. Встановлення на macOS
5. Перевірка, що все працює
6. Windows: python3 чи python?
7. Три типові проблеми
8. Якщо не хочеться возитися взагалі

Розділ 8. Claude Code: підписка, встановлення, авторизація

1. Що це таке
2. Підписка
3. Встановлення
4. Перевірка
5. Авторизація
6. Розширення для VS Code
7. Перша розмова
8. Чотири речі, які варто знати одразу
9. Він не редагує рукопис. У цьому проєкті це закріплено двічі: правилом у CLAUDE.md і забороною у файлі .claude/settings.json. Вихід агента — папка reports/. Так зроблено навмисно, і розділ 12 пояснює чому.

Розділ 9. Git, GitHub і історія вашої книжки

1. Навіщо це письменнику
2. Встановлення
3. Спосіб перший: усе через VS Code, без жодної команди
4. Спосіб другий: чотири команди
5. GitHub: що це і навіщо
6. Як завести акаунт
7. Як відправити туди свою книжку
8. Робочий ритм
9. Що ще покласти в репозиторій

Розділ 10. Typst: встановлення, перевірка, верстка

1. Що це і чому не InDesign
2. Встановлення на Windows
3. Встановлення на macOS
4. Linux
5. Перевірка: три кроки
6. Живий перегляд без терміналу
7. Що можна змінювати, не знаючи Typst
8. Про шрифт окремо
9. Коли Typst лається
10. Ілюстрації
11. Коли Typst не підходить

Частина III. Структура проєкту

Розділ 11. Анатомія проєкту

1. Розпакуйте архів
2. Дерево
3. Три групи, які варто розрізняти
4. Найважливіша ідея всієї книжки
5. І практичний бонус

Розділ 12. CLAUDE.md і межі агента

1. Що це за файл
2. Що обов’язково має бути всередині
3. Сім залізних правил і чому кожне з них там
4. Технічний бар’єр: settings.json
5. Слеш-команди
6. Скіли
7. Скіли — саме те місце, куди варто дописувати свої правила в міру роботи. Помітили, що агент постійно робить одну й ту саму дурницю? Один рядок у відповідний SKILL.md — і він більше так не робить. Ніколи.

Розділ 13. Папка context: пам’ять проєкту

1. goals.md: навіщо ця книжка
2. style.md: стилістичний контракт
3. characters.md: канон
4. world.md: правила світу
5. reader.md: профіль читача
6. Як заповнити це за вечір
7. Як перевірити те, що вийшло

Розділ 14. Папка maps: навігація по книжці

1. outline.md: план, який показує, що змінюється
2. timeline.md: хронологія
3. character-map.md: хто про що знає
4. continuity-ledger.md: реєстр рушниць
5. navigation.md: файл для людини
6. Про коментарі на полях
7. Усе між не потрапляє ні у верстку, ні у слово-лічильник (скрипт із проєкту їх ігнорує). А пошук по проєкту за словом TODO показує весь список ваших нотаток одразу, з адресами.

Частина IV. Робочі цикли

Розділ 15. Альфа-ридінг

1. Коли
2. Як
3. Як читати результат
4. Чого не робити
5. Про періодичність

Розділ 16. Метрики й структурна редактура

1. Навіщо взагалі числа
2. Спочатку скрипт
3. Що дивитися в цифрах
4. Скоркард
5. Діагноз рівня книжки
6. Що робити з ярликом CUT
7. Порядок структурної правки
8. І одне обмеження, яке варто прийняти заздалегідь: за один захід міняйте щось одне. Переставили розділи — прогнали /book заново — подивилися, що змінилося. Три структурні зміни одночасно роблять результат неінтерпретовним.

Розділ 17. Бета-ридінг

1. Головне правило, ще раз
2. Карта уваги
3. Чотири режими
4. Правило трьох читачів
5. Діагностика «написано добре, а не тримає»
6. Як приймати зауваження

Розділ 18. Порядкова редактура

1. Коли можна
2. П’ять проходів
3. Ліміт правок
4. Формат правки
5. Патч
6. Чого не робить порядкова редактура

Розділ 19. Континуїті

1. Що це ловить
2. Як
3. Правило рівнів
4. Що не є конфліктом
5. Реєстр рушниць на практиці
6. UNPLANTED лагодьте одразу. Це єдиний тип, який ламає довіру читача просто зараз, а не на перечитуванні.

Розділ 20. Переклад

1. Коли
2. Права
3. Шкала L0–L4
4. Журнал рішень
5. Глосарій
6. Профіль читача перекладу
7. Шість стратегій для реалій
8. Ритм у дитячій книжці
9. Робочий цикл
10. Дві машинні хвороби перекладу

Розділ 21. Коректура і верстка

1. Коректура
2. Верстка
3. Що перевіряти в готовому PDF
4. Обкладинка

Розділ 22. Публікація

1. Формати
2. Куди
3. Чого не варто робити
4. Читання вголос — не метафора. Прочитайте перший і останній розділи вголос повністю. Ви почуєте те, чого не побачили за півроку читання очима.

Додаток А. Бібліотека промптів

1. А.1. Промпти діагностики
2. А.2. Промпти редактури
3. Типова помилка. Ігнорувати пункт 4. Найчастіша причина поганих відгуків — книжка добра, але не та, яку обіцяла обкладинка й перший розділ.
4. А.3. Промпти континуїті
5. А.4. Промпти для збирання контексту
6. А.5. Промпти перекладу
7. А.6. Промпти коректури й верстки
8. А.7. Два системні промпти

Додаток Б. Шпаргалка команд

1. Слеш-команди проєкту
2. Команди Claude Code
3. Термінал
4. Перевірка, що все встановлено
5. Скрипти
6. Git у командному рядку
7. Git кнопками у VS Code
8. VS Code

Додаток В. Шаблони файлів контексту

1. goals.md
2. style.md
3. characters.md
4. world.md
5. reader.md

Додаток Г. Що всередині ZIP-архіву

1. Що має бути встановлено
2. Перші п’ять кроків після розпакування

Додаток Д. Коли щось не працює

1. Claude Code
2. Якість відповідей
3. Термінал
4. Python
5. Git і GitHub
6. Верстка

Додаток Е. Чеклісти

1. Перед тим, як показати комусь живому
2. Перед коректурою
3. Перед версткою
4. Перед публікацією

Додаток Ж. Словничок

Післямова