🫐 Cyberries

Живая PKM-система — архитектура цифрового организма

время чтения ~11 мин.

Привет. Многие из нас, работая со знаниями, ощущают фундаментальный разрыв. Есть наш приватный мир идей, черновиков и гипотез — своего рода корневая система, которую мы бережно питаем с помощью Obsidian-о подобного инструмента. И есть внешний мир, с которым хочется взаимодействовать: делиться мыслями на просторах интернета, совместно с сообществом развивать open-source проекты или методологии.

Часто это приводит к хаосу: дублированию контента, рассинхронизации версий и постоянному ручному труду. Система начинает управлять нами, а не мы ею.

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

Этот плейбук — приглашение к проектированию вашей собственной кибербионической экосистемы, где вы остаетесь архитектором своего цифрового мира.

Рассматриваемая система — один из срезов, одна из форм, проявленных из более глубокой, фундаментальной концепции (многомерной свернутой реальности), которую я называю Membra.

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

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

Примером другого проявления Membra является система EnMaTeS, которую некоторые люди уже начали применять в своих собственных прикладных решениях.

Философия системы: от корня к ветвям

В основе лежит один принцип: мой приватный Obsidian Vault — это корневая система, единый источник правды. Из этого корня вырастает центральный ствол (ваш приватный репозиторий), от которого, в свою очередь, отходят различные ветви. Каждая ветвь живет своей жизнью и по-своему взаимодействует с миром:

  • Публичный сайт (cyberries.org): Это ветвь, которая растет напрямую из ствола системы и публикуется через связку Quartz и Cloudflare. Она служит структурированным и удобным для чтения представлением моих знаний.
  • Публичные репозитории на GitHub: Это ветви, созданные для совместного роста с сообществом. Они позволяют другим встраивать мои наработки в свои системы.
  • Другие каналы (Telegram, etc.): Это могут быть потоковые ветви, которые питаются ресурсами из ствола через различные интеграции.
  • Клиентские или партнерские микросайты: В будущем, это могут быть приватные ветви, доступные ограниченному кругу лиц.

Компоненты коннектума:

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

  1. Источники (Корни): Это приватные, внутренние пространства, где зарождаются идеи. На данный момент, основным таким источником является локальный Obsidian Vault, но это лишь один из возможных интерфейсов к вашим данным. Корни могут произрастать и из других мест.
  2. Структуры (Стволы): Это основные, опорные репозитории, которые придают системе устойчивость. Приватный репозиторий MyPKMS в текущей архитектуре выполняет роль центрального ствола. Однако в будущем могут появляться и другие стволы — например, отдельные приватные репозитории для крупных клиентских/партнерских проектов.
  3. Проявления (Ветви): Это публичные или полуприватные “точки контакта” с внешним миром — сайты, open-source проекты, Telegram-каналы. Они растут из стволов, а иногда и напрямую из корней.
  4. Механизмы потоков (Нервная система): Это автоматизированные процессы и интеграции, которые обеспечивают циркуляцию информации между любыми частями коннектума. Они могут связывать корень со стволом, ствол с веткой, или напрямую корень с веткой. Это гибкая система, где GitHub Actions — лишь один из инструментов, наряду с API, Latenode и и A2A, MCP протоколами для AI-агентов.

Визуальная архитектура

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

flowchart TD
    subgraph A["Приватное пространство"]
        A1["Obsidian Vault - локальный корень"]
    end

    subgraph B["GitHub - приватный репозиторий MyPKMS"]
        B1["Центральный ствол - эталонная версия системы"]
        B2["Инфраструктура - движок сайта на Quartz"]
        B3["Автоматизация - скрипты синхронизации"]
    end
    
    subgraph C["GitHub - публичный репозиторий EnMaTeS-Nest"]
        C1["Публичная ветвь - проект для сообщества"]
    end

    subgraph D["Интернет - публичное проявление"]
        D1["Сайт cyberries.org на Cloudflare Pages"]
    end

    A1 -- "1: обновление ствола" --> B1
    B1 -- "2a: сборка" --> B2
    B2 -- "2b: деплой" --> D1
    B1 -- "3a: синхронизация" --> B3
    B3 -- " " --> C1
    C1 -- "3b: обновления" --> B3
    B3 -- " " --> B1

Схема и ее расшифровка ниже описывают текущую, базовую реализацию этой философии с одним центральным стволом. Важно понимать, что это лишь один из возможных паттернов в рамках более гибкого коннектума. В будущем поток может идти напрямую от Корня к Ветви через API или управляться AI-агентами

Расшифровка схемы: от корня к плодам

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

1. Корневая система: локальный Obsidian Vault

Все начинается здесь. Ваш локальный Vault — это не просто стартовая точка, а настоящая корневая система всего организма. Здесь в питательной среде ваших мыслей зарождаются и развиваются идеи, концепции и артефакты. Это мир чистого потенциала. Когда вы делаете git push, вы отправляете накопленные ресурсы и генетический код вверх, в основной ствол.

2. Центральный ствол: приватный репозиторий на GitHub

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

3. Ветви и потоки: публичные проявления

Из центрального ствола произрастают различные ветви, каждая из которых адаптирована для своей цели и аудитории:

  • Сайт (однонаправленная ветвь): Эта ветвь растет напрямую из ствола. Сервис Cloudflare Pages подключается к вашему приватному репозиторию, берет из него необходимый материал и формирует из него крону — публичный сайт. Поток информации здесь идет строго в одном направлении: от ствола к ветви.
  • Open-Source Проект (двунаправленная ветвь): Эта ветвь предназначена для взаимодействия. Автоматизированный процесс (GitHub Action) создает ее публичную копию в отдельном репозитории. Эта ветвь может получать ресурсы извне (коммиты от сообщества или ваши правки из облачной IDE, например я использую Firebase Studio) и передавать их обратно в центральный ствол, обогащая всю систему.

4. Плоды экосистемы: живые артефакты в сети

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

Шаг 1: Архитектура корневой системы (MyPKMS)

Чтобы система была устойчивой, нужно отделить питательную почву (контент) от инструментов роста. Я создал в корне своего Vault папку 06_Infra. Она изолирует все технические “движки” от моих знаний, предотвращая конфликты и путаницу.

MyPKMS/ (корень Obsidian Vault)
├── 00_Genesis/
├── 02_Systems/
│   └── 0221_EnMaTeS/   <-- Материал для отдельной ветви
├── ...
├── 06_Infra/           <-- Техническая зона
│   └── Quartz_MySite/    <-- "Движок" для сайта
└── .gitignore

Шаг 2: Настройка “движка” для ветви-сайта (Quartz)

Каждый сайт — это независимый инстанс Quartz, живущий в 06_Infra. Рассмотрим, как настроить один из них.

2.1. Создание “окна” в хранилище (символическая ссылка)

Вместо копирования файлов мы создаем “портал” из папки Quartz в корень нашего Vault. Это позволяет движку “видеть” все ваши файлы, не копируя их.

  1. Перейдите в папку движка: cd 06_Infra/Quartz_MySite/
  2. Создайте относительную символическую ссылку content:
rm -rf content
ln -s ../../ content

2.2. Настройка фильтров публикации (quartz.config.ts)

Это наш пульт управления ростом. В файле quartz.config.ts мы определяем, какие именно ресурсы из корневой системы должны пойти в эту конкретную ветвь.

// Файл: 06_Infra/Quartz_MySite/quartz.config.ts
import { QuartzConfig } from "./quartz/cfg"
import * as Plugin from "./quartz/plugins"
 
const config: QuartzConfig = {
  configuration: {
    baseUrl: "cyberries.org", // Ваш домен
    ignorePatterns: [
      "**/OLD ALL", "06_Infra", ".obsidian", ".trash", "**/~~*",
    ],
  },
  plugins: {
    filters: [Plugin.ExplicitPublish()], // Публикуем только файлы с флагом `publish: true`
  },
}
export default config

2.3. Процесс публикации из Obsidian

Теперь управление видимостью контента становится прозрачным и контролируемым.

  • Опубликовать страницу: Во frontmatter файла добавляю publish: true.
  • Снять с публикации: Меняю флаг на publish: false или удаляю его.
  • Закоммитить изменения: Для удобной работы с Git прямо из редактора существуют плагины, например, Obsidian Git. Он позволяет делать коммиты и пуши в один клик, не переключаясь в терминал.

Шаг 3: Настройка двусторонней связи для ветви-проекта

А теперь самое интересное. Я хочу, чтобы моя методология EnMaTeS росла как отдельная ветвь в публичном репозитории EnMaTeS-Nest, принимала вклад от сообщества (pull requests), но при этом оставалась синхронизированной со стволом в MyPKMS. Для этого настраиваем два GitHub Actions.

Важно: Создайте Personal Access Token (PAT) с правами repo и сохраните его как секрет PAT_SYNC в настройках обоих репозиториев.

3.1. GitHub Action 1: синхронизация от ствола к ветке (MyPKMS → EnMaTeS-Nest)

Этот экшен следит за изменениями в папке .../0221_EnMaTeS/ в приватном репозитории и отправляет их в публичную ветвь.

Файл: .github/workflows/sync-to-public.yml в MyPKMS

name: Sync EnMaTeS to Public Repo
on:
  push:
    branches: [main]
    paths: ['02_Systems/0221_EnMaTeS/**']
jobs:
  sync:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, '[CI-SYNC-BACK]')"
    steps:
      - name: Checkout Source (MyPKMS)
        uses: actions/checkout@v4
        with: { path: source-repo }
      - name: Checkout Destination (EnMaTeS-Nest)
        uses: actions/checkout@v4
        with:
          repository: your-username/EnMaTeS-Nest
          token: ${{ secrets.PAT_SYNC }}
          path: dest-repo
      - name: Sync files
        run: |
          rsync -av --delete --exclude='.git' --exclude='.github' source-repo/02_Systems/0221_EnMaTeS/ ./dest-repo/
      - name: Commit and push changes
        working-directory: ./dest-repo
        run: |
          git config user.name '${{ github.actor }}'
          git config user.email '${{ github.actor }}@users.noreply.github.com'
          git add .
          if ! git diff --staged --quiet; then
            git commit -m "sync: Update from private PKMS [CI-SYNC]"
            git push
          fi

3.2. GitHub Action 2: синхронизация от ветки к стволу (EnMaTeS-Nest → MyPKMS)

Этот экшен делает обратное: любые изменения в публичной ветви (например, пулл-реквесты от сообщества) автоматически отправляются обратно в приватный репозиторий.

Файл: .github/workflows/sync-to-private.yml в EnMaTeS-Nest

name: Sync back to Private PKMS
on:
  push:
    branches: [main]
jobs:
  sync:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, '[CI-SYNC]')"
    steps:
      - name: Checkout Source (EnMaTeS-Nest)
        uses: actions/checkout@v4
        with: { path: source-repo }
      - name: Checkout Destination (MyPKMS)
        uses: actions/checkout@v4
        with:
          repository: your-username/MyPKMS
          token: ${{ secrets.PAT_SYNC }}
          path: dest-repo
      - name: Sync files
        run: |
          mkdir -p ./dest-repo/02_Systems/0221_EnMaTeS/
          rsync -av --delete --exclude='.github' ./source-repo/ ./dest-repo/02_Systems/0221_EnMaTeS/
      - name: Commit and push changes
        working-directory: ./dest-repo
        run: |
          git config user.name '${{ github.actor }}'
          git config user.email '${{ github.actor }}@users.noreply.github.com'
          git add .
          if ! git diff --staged --quiet; then
            git commit -m "sync: Update from EnMaTeS-Nest [CI-SYNC-BACK]"
            git push
          fi

Шаг 4: Развертывание ветви-сайта на Cloudflare Pages

Финальный этап — публикация. Важно, что мы разворачиваем сайт из приватного ствола MyPKMS. Это дает полный контроль над тем, что именно и в какой момент увидит мир.

  1. Подключите репозиторий MyPKMS к Cloudflare Pages.
  2. Используйте следующие настройки сборки:
    • Команда сборки: npx quartz build
    • Каталог результатов сборки: public
    • Корневой каталог: 06_Infra/Quartz_MySite/ (путь до вашего инстанса Quartz)
  3. Привяжите домен.

Для кого этот плейбук и какие есть пути?

Этот материал создан для системных мыслителей, цифровых архитекторов и предпринимателей, которые чувствуют, что их знания — это живой, развивающийся организм.

Я придерживаюсь философии open-source/mind, поэтому вся информация в этой статье и на моих ресурсах полностью открыты. В зависимости от вашего стиля работы и целей, вы можете выбрать один из трех путей:

  1. Путь архитектора (DIY - сделай сам): Вся информация в этой статье достаточна, чтобы вы самостоятельно, шаг за шагом, собрали такую же систему. Если вы любите разбираться в деталях и имеете базовое понимание Git и командной строки — этот путь для вас.
  2. Путешествие в составе фронтирной киберфлотилии (совместная работа): Если вы хотите не просто внедрить инструмент, а развиваться в среде единомышленников и вместе строить свои системы — присоединяйтесь к нашему открытому сообществу в Telegram «108 инноваторов».
    Самые активные участники попадают в закрытые рабочие группы — “Киберлодки”, где мы вместе идем к конкретным результатам. Это путь для тех, кто готов вкладывать свое время и энергию в общее дело.
    В киберлодках также действует «open-source/mind»-подход, т.е. участие бесплатное ;)
  3. Путь с проводником (персональное сопровождение): Если перед вами стоят уникальные задачи, вам нужна помощь в адаптации этой архитектуры под ваш контекст или вы хотите ускорить процесс внедрения, я могу помочь лично. Это формат партнерской работы, где мы вместе проектируем и настраиваем вашу кибербионическую экосистему. Со мной можно связаться через Telegram.

Постскриптум

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

Надеюсь, этот плейбук будет вам полезен.

Вид графа