Статья по шагам-битам из заметок

Текст

---
name: writing-beats
description: Письмо, отработка (exploit): собери сырой материал в путь из битов, закрепляя каждый термин, прежде чем на него обопрётся бит.
disable-model-invocation: true
---

<what-to-do>

Пользователь передал (или передаст) markdown-файл с сырым материалом. Это отработка (exploit): исследование закончено, куча материала зафиксирована. Выбери путь через неё и черпай из кучи, чтобы наполнить каждый бит.

Если пользователь не сказал, куда сохранять статью, спроси один раз и запомни путь.

Затем веди путешествие бит за битом, в стиле «выбери своё приключение»:

1. Установи предпосылки. До любых битов договорись с пользователем, что аудитория уже знает на входе: это понятия, закреплённые с самого начала. Всё остальное должно быть закреплено каким-то битом, прежде чем на него обопрётся следующий бит. См. [Закрепление](#grounding).
2. Напиши 2–3 варианта начальных битов, взятых из сырого материала. Каждый — отдельная точка входа в статью. Каждый может опираться только на закреплённые понятия; отметь, какие новые понятия закрепляет каждый. Покажи биты пользователю, прежде чем писать что-либо в файл статьи. Пользователь выбирает один. Покажи заранее, какие биты этот выбор открывает, будто пользователь заглядывает немного вперёд по пути.
3. Когда пользователь выбрал начальный бит, запиши в файл статьи только его. Бит может быть одним предложением или несколькими абзацами — тем, чем ему естественно быть. На этом остановись.
4. Заново прочитай файл статьи с диска. Затем предложи 2–3 варианта следующих битов: разные направления, в которые путешествие может свернуть с того места, где статья сейчас стоит. Каждый должен быть достижим из текущего набора закреплённого; отметь, что закрепляет каждый.
5. Повторяй шаги 3–5, пока статья не дойдёт до естественного конца.

</what-to-do>

<supporting-info>

Закрепление

Каждое понятие должно быть закреплено, прежде чем бит сможет на него опереться: аудитория либо пришла, уже зная его, либо встретила его в более раннем бите. Бит, который тянется к незакреплённому понятию, теряет читателя; это единственный ход, которого путешествие делать не может. Единица здесь — понятие, а не слово для него: бит может опираться на идею, которой у читателя нет, даже если никакого жаргона в поле зрения нет. Если у понятия есть название (термин), закрепить его значит донести идею и термин вместе.

Понятие закрепляется одним из двух способов:

• Предпосылка: закреплено до первого бита. Аудитория приносит его с собой. Фиксируется в начале.
• Введено: бит устанавливает его, и с этого момента оно закреплено для всех последующих битов.

Так что каждый бит делает две работы: он требует уже закреплённых понятий и закрепляет новые. Веди текущий список того, что закреплено к этому моменту, и обновляй его каждый раз, когда бит лёг в статью.

Именно это задаёт форму «выбери своё приключение». Бит-кандидат достижим, только если всё, что он требует, уже закреплено; выбрав бит, закрепляющий понятие X, ты открываешь все биты, которые ждали X. Когда предлагаешь следующие биты, все они должны быть достижимы из текущего закреплённого набора, и скажи, что закрепляет каждый, чтобы пользователь видел, какие пути он открывает.

Главный рычаг — что ты делаешь предпосылкой, а что закрепляешь внутри текста. Потребуешь слишком много заранее — закроешь дверь читателям, у которых этого нет; закрепишь слишком много внутри — первые биты утонут в определениях. Договорись об этом с пользователем, когда устанавливаешь предпосылки, и возвращайся к этому вопросу всякий раз, когда соблазнительный бит оказывается требующим понятие, которое пока ничто не закрепило: исправление — либо закрепляющий бит перед ним, либо перевод понятия в предпосылки.

Что такое бит

Бит — один ход в путешествии. Он делает одно: задаёт сцену, доносит мысль, задаёт вопрос, вставляет реплику в сторону, поворачивает ракурс. Потом он останавливается, оставляя читателя там, откуда следующий бит может свернуть.

Размер бита определяется тем, что ему нужно:

• Одно предложение, если ход — только это («А потом три недели ничего не происходило»).
• Короткий абзац, если ходу нужна подводка.
• Несколько абзацев, если бит — законченная зарисовка, довод или пример.

Если «биту» нужно пять абзацев и три подзаголовка, это не бит, а два бита, склеенные вместе. Раздели его.

Черпай из кучи

Бери материал из сырой кучи, чтобы наполнить каждый бит. Можно перефразировать, дробить, пересобирать или цитировать. Куча — это каменоломня.

Завершение путешествия

Статья заканчивается, когда путешествие завершено, а не когда куча опустела. В большинстве куч останутся фрагменты, которые в статью не вошли. Это нормально; в этом и смысл того, чтобы иметь сырого материала больше, чем нужно.

Ритм письма

• Дописывай по одному биту. Никогда не пиши наперёд.
• Перед каждой записью заново читай файл статьи с диска. Правки пользователя сохраняй безоговорочно.
• Если пользователь существенно правит предыдущий бит, пусть это меняет то, что идёт дальше.
• Если пользователь говорит «перепиши этот бит» или «вернись и попробуй другой третий бит», сделай это: правь на месте, остальное не трогай.

</supporting-info>

Перевод: iiuniversitet. Оригинал: https://github.com/mattpocock/skills/tree/main/skills/in-progress/writing-beats, лицензия MIT. Изменения: перевод на русский язык.