§2.02 Репозитории: пак знаний и производные
Время: 45 мин чтение + 30 мин
В одном предложении: Человек думает, что все файлы в его IWE равнозначны — заметки, код, документы лежат в одной куче, — а на самом деле репозитории разделены на Pack, который хранит истину, и DS, который производит результаты, и смешение этих ролей порождает хаос, который кажется «просто неразберихой в файлах».
Мем, который снимается. «У меня всё в GitHub: код в одном репо, заметки в другом, документы в третьем. Я знаю, где что лежит. Это и есть моя система.» На самом деле разделение по техническому признаку («код тут, заметки там») скрывает разделение по функции. Pack — это не «заметки», это Source-of-Truth: формы, методы, сущности, которые определяют, как вы работаете. DS — это не «код и документы», это производные от Pack: рабочие продукты, которые создаются по правилам, заданным в Pack. Когда Pack и DS смешиваются, происходит дрейф: вы меняете правила в одном месте, забываете обновить в другом, и через месяц не понимаете, что актуально, а что — артефакт старого подхода.
Понятия. Pack — Source-of-Truth IWE: структурированное хранилище форм, методов, категорий, принципов и состояния искусства. Pack определяет, как пилот работает, что он считает ошибкой, какие методы применяет. DS — Digital Self, производные от Pack: код, документация, заметки, рабочие продукты, которые создаются по правилам Pack. SoT — принцип разрешения противоречий: если Pack и DS расходятся, правду несёт Pack, а DS подлежит обновлению. Структура Pack состоит из восьми разделов: манифест, контракт, сущности, методы, рабочие продукты, режимы отказа, состояние искусства, карта. Каждый раздел отвечает на свой вопрос: зачем мы работаем, по каким правилам, что существует, как действуем, что производим, что может сломаться, что известно миру, как всё связано.
Объяснение. Pack и DS — это не две папки, а два режима существования знания. Pack живёт медленно: формы меняются редко, методы обновляются осознанно, принципы проверяются временем. DS живёт быстро: код пишется и переписывается, заметки появляются и устаревают, документы создаются под задачу. Когда пилот путает эти ритмы, он начинает менять Pack под текущую задачу — и лишается стабильной основы. Или, наоборот, замораживает DS по правилам Pack — и теряет гибкость. Правильное соотношение: Pack задаёт рамки, в которых DS свободно движется. Pack отвечает на вопрос «как мы не делаем», DS — на вопрос «как мы делаем сегодня». Pack определяет, что является дрейфом, DS — демонстрирует дрейф в действии. Репозитории IWE отражают это разделение: Pack-хранилище — отдельный репозиторий или раздел с защитой от случайных изменений, DS-хранилища — рабочие репозитории, которые могут появляться и исчезать. Pack один, DS множественны. Pack долговечен, DS эфемерны. Pack — конституция, DS — законы.
На практике. Практика «Аудит репозиториев» (30 мин):
- Перечислите все репозитории и папки в вашей IWE, которые содержат знания или рабочие продукты. Не менее пяти. (5 мин)
- Для каждого определите: это Pack (правила, методы, формы) или DS (результаты, заметки, код)? Отметьте одним словом. (10 мин)
- Проверьте: есть ли репозитории, которые смешивают Pack и DS? Например, заметки о методах лежат в папке с рабочими продуктами. Выделите одно такое место. (10 мин)
- Зафиксируйте решение: что переместить в Pack, что оставить в DS, что удалить как устаревшее. Запишите в Pack как задачу на ближайшую неделю. (5 мин)
Типичный кейс. Дизайнер тридцати пяти лет вёл все проекты в одной папке Figma: шаблоны компонентов, готовые макеты, черновики, старые версии, заметки о принципах дизайна. Через два года в папке было больше трёхсот файлов, и она тратила по двадцать минут на поиск нужного. Тогда она разделила систему: Pack — репозиторий с принципами дизайна, типографикой, цветовой системой, правилами компонентов. DS — рабочие файлы проектов, которые архивировались после завершения. Pack обновлялся раз в квартал после ревью. DS жил по правилам Pack. Через полгода поиск занимал меньше минуты, а новые проекты начинались с готовой системы, а не с чистого листа.
Типичная ошибка. «Pack — это просто красивое название для папки с заметками.» Нет, Pack — это Source-of-Truth. Если вы можете удалить файл без последствий для работы — это DS. Если удаление сломает ваши методы — это Pack. Другая ошибка: «DS должен соответствовать Pack на 100%.» Нет, DS — это эксперименты, которые могут противоречить Pack. Противоречие — сигнал: или Pack устарел, или DS делает что-то новое. Важно не запретить противоречие, а зафиксировать его и разрешить осознанно.
Степени мастерства:
- Объяснение. Могу назвать три репозитория в своей IWE и объяснить, какой из них Pack, а какой DS. Критерий перехода: провёл аудит и нашёл одно смешение.
- Умение. В одном проекте сознательно разделил Pack и DS: правила в одном месте, результаты — в другом. Критерий перехода: три проекта подряд завершены без смешения Pack и DS.
- Навык. Системно проверяю расхождения между Pack и DS при закрытии каждого рабочего продукта. Критерий перехода: коллега заметила, что мои проекты «начинаются быстрее, потому что правила уже готовы».
- Мастерство. Проектирую Pack так, что он порождает DS автоматически: шаблоны, протоколы, генераторы. Критерий перехода: другой человек использовал ваш Pack для создания DS без вашего участия.
Проверка себя.
- Могу назвать три репозитория в своей IWE и для каждого сказать: Pack или DS
- Нашёл хотя бы одно место, где Pack и DS смешаны, и знаю, что с этим делать
- Pack обновлялся за последний месяц: я добавил новое правило, метод или принцип
- При закрытии последнего рабочего продукта я проверял, не противоречит ли он Pack
- Я могу удалить любой DS-репозиторий, не потеряв при этом методов и принципов
На практике. Откройте вашу IWE. Найдите пять последних файлов, которые вы создавали. Для каждого спросите: «Если я удалю этот файл, потеряю ли я правило или метод?» Если да — это Pack, и он лежит не там. Если нет — это DS, и всё в порядке. Переместите один Pack-файл в правильное место. Это и есть разделение репозиториев.
См. также: Pack как хранилище заметок: PD.GUIDE.3.S1.SS3, BYOB: PD.GUIDE.3.S1.SS5.
Что дальше. Следующий подраздел — о среде работы: как устроен инструментарий IWE и как он отличается от простого набора программ.