AI-first Company OS: общий workspace компании

Знания о компании, рабочие инструкции и результаты проектов можно собрать в общее пространство для сотрудников и ИИ-агентов. Разберём, что в нём хранить, как обмениваться изменениями и какую структуру выбрать.
Что такое общий workspace
Рабочее пространство, или workspace, — директория или набор связанных директорий с документами, инструкциями и инструментами. ИИ-агент — помощник на основе ИИ, который получает поручение, выбирает шаги для его выполнения и действует с помощью доступных инструментов.
Например: «Подготовь предложение этому клиенту». В workspace уже лежат описание продукта, задача клиента и правила подготовки документа. Агент находит их, готовит предложение и сохраняет результат для следующего поручения. Контекст не приходится заново собирать в каждом чате.
AI-first Company OS в этой статье — способ организовать такое пространство: определить, где лежат знания, как связаны проекты и функции и как команда поддерживает материалы вместе.
Что хранить в рабочем пространстве
В workspace должно быть всё, что нужно агенту для полного представления о компании и работы в ней: цели, продукт, люди, клиенты, процессы, правила, решения и текущее состояние дел. Для конкретного поручения агент обращается к нужным разделам:
- Контекст компании: продукт, аудитория, стратегия, решения и словарь внутренних понятий.
- Клиенты и контакты: сведения о клиентах, контактные лица, их роли и история взаимодействия.
- Текущая работа: проекты, задачи, рабочие документы и результаты.
- Данные и аналитика: наборы данных, выгрузки, отчёты, показатели и панели аналитики.
- Доступ к данным: источники, необходимые права и инструкции по получению сведений.
- Инструкции: навигация и повторяемые поручения. Переиспользуемую инструкцию агента, иногда со скриптами или шаблонами, называют навыком, или skill.
- Инструменты и связи: скрипты и подключения к внешним системам.
Учётная система, календарь и клиентская база могут оставаться на своих местах. В workspace описывают, где искать сведения и как к ним обратиться: через интерфейс, запрос или выгрузку. Агенту нужен настроенный доступ; пароли и ключи хранят отдельно от общих документов.
Как Git поддерживает общий workspace
Сотрудники и их агенты работают на разных компьютерах. Каждому нужен доступ к общим документам, а результаты его работы должны становиться доступны остальным. Поэтому workspace нужен механизм обмена изменениями: получать обновления коллег, передавать свои и согласовывать одновременные правки.
Для этого мы выбрали Git. Каждый работает со своей локальной копией, а через общий репозиторий команда обменивается изменениями. Git помогает объединять правки, сохраняет их историю и позволяет вернуться к предыдущей версии. Так документы на разных компьютерах остаются частями одного общего рабочего пространства.
Четыре варианта структуры Company OS
Выбирайте структуру по тому, как команда ищет материалы и кому они доступны. Ниже — условные схемы и примеры публичных шаблонов.
1. Один репозиторий небольшой команды
Отправная точка для команды с общим набором материалов — условный пример:
company-os/README.md # карта пространстваAGENTS.md # инструкции агентуcompany/ # продукт и общие знанияproduct.mdprocesses.mddata/README.md # источники данных и способы доступаprojects/client-a/brief.md # задача клиентаproposal.md # предложениеskills/ # повторяемые порученияscripts/ # рабочие инструменты
Общие сведения лежат в company/, рабочие материалы — в проектах. README.md помогает ориентироваться, а AGENTS.md объясняет агенту, как выбирать источники и сохранять результат. Здесь одна точка входа и одна история изменений. Новые директории добавляют по мере появления отдельных групп материалов.
Так же можно устроить персональную OS для задач одного человека. В Personal Super Agent Всеволода Устинова каталог Docs/ объединяет материалы о здоровье, финансах, обучении и домашних проектах, а scripts/ — рабочие инструменты.
2. Разделение по функциям компании
Если материалы группируются вокруг продукта, продаж и операционной работы, это можно отразить в директориях. Сокращённое дерево публичного AI First Workspace Template Всеволода Устинова:
ai-first-workspace-template/Docs/Strategy/Product/SalesAndMarketing/Operations/SePersonalCRM/Dev/Projects/scripts/
Функции и проекты доступны из общего пространства; команда договаривается, кто поддерживает каждый раздел. Дерево показывает устройство шаблона, а не внутреннюю структуру компании автора.
3. Общий вход в несколько репозиториев
Разные участники, права доступа или независимые истории изменений могут потребовать отдельных репозиториев. Условная схема их размещения:
workspace/README.md # карта и ссылкиAGENTS.md # правила навигацииhq/ # репозиторий штабаproduct/ # репозиторий продуктаmarketing/ # репозиторий маркетингаfinance/ # репозиторий финансовclient-project/ # репозиторий проекта
Каждый репозиторий обновляют и синхронизируют отдельно. Общая точка входа связывает их навигацией и инструкциями. Близкую идею предлагает Personal Corp OS: шаблоны штаба и отделов для создания рабочих пространств. Схема выше иллюстрирует размещение репозиториев, а не дерево самого комплекта шаблонов.
Доступ выдают средствами сервиса хранения репозиториев. Одна папка finance/ внутри доступного всем репозитория не ограничивает чтение финансовых документов. Цена разделения — поддержка ссылок, инструкций и согласованности изменений между частями.
4. Workspace команды разработки
Для программистов пространство объединяет код и знания о проекте. Мой Memory Bank устанавливает базу знаний в репозиторий проекта:
project/src/ # код приложенияtests/ # тестыmemory-bank/README.md # карта базы знанийdna/ # конституция базы знанийproduct/ # назначение продуктаdomain/ # понятия и правила предметной областиengineering/ # архитектура и правила разработкиops/ # окружения и эксплуатацияuse-cases/ # пользовательские сценарииadr/ # принятые архитектурные решения
Корень с src/ и tests/ условный; разделы memory-bank/ взяты из публичного шаблона и показаны в сокращении.
Код хранит реализацию, база знаний — назначение продукта, требования и причины решений. Перед задачей агент читает нужный контекст, после работы обновляет соответствующие материалы. Другой разработчик или новая сессия агента могут продолжить с сохранённого результата.
Базовые принципы базы знаний
Конституция базы знаний закрепляет принципы устройства workspace и порядок их изменения. Ниже — пример файла constitution.md для команды разработки. На него стоит сослаться из корневого README.md и инструкций агенту.
constitution.md — пример базовой конституции# Конституция базы знаний
Эти правила действуют для сотрудников и ИИ-агентов.
## 1. Единственная ответственность разделов
У каждого раздела своя область знаний:
- product/ — для кого продукт и какие задачи решает;
- domain/ — понятия и правила предметной области;
- engineering/ — техническое устройство и правила разработки;
- ops/ — окружения и эксплуатация.
README раздела объясняет его границы и указывает смежные разделы.
## 2. Единый источник истины
У каждого факта или правила одно авторитетное место.
В других документах даём ссылку на него.
Исправление вносим в источник.
## 3. Атомарность документов
Один документ раскрывает одну связную тему.
Самостоятельные темы выносим в отдельные файлы.
## 4. Навигация от общего к частному
Корневой README — карта базы знаний.
README разделов ведут к конкретным документам.
По описанию ссылки понятно, что найдётся за ней.
## 5. Обновление знаний вместе с работой
Изменили продукт, правило или способ работы —
обновляем соответствующий источник и связанные материалы.
Добавили или переместили документ — обновляем карту раздела.
## Изменение конституции
Предложение обсуждаем с ответственным за базу знаний.
После согласования обновляем этот файл и затронутые инструкции.
Ответственность разделов определяет область знаний, а единый источник истины — SSOT (Single Source of Truth) — место конкретного факта. Например, описание возможностей продукта ведут в product/; другие документы ссылаются на него.
Как выбрать свою структуру
Начните с общих знаний и нескольких текущих проектов. Выберите структуру по способу работы команды и нужным границам доступа; варианты можно сочетать. Затем проверьте её поручением: сможет ли агент найти контекст, подготовить результат и сохранить его в нужном месте? Если приходится каждый раз объяснять устройство компании заново, уточните навигацию и инструкции.
Источники
- Pro Git: контроль версий и удалённые репозитории — история файлов и обмен изменениями.
- Personal Super Agent Всеволода Устинова — пример персонального workspace; README и структура проверены по указанному коммиту.
- AI First Workspace Template — публичный пример группировки материалов компании.
- Personal Corp OS — шаблоны штаба и отдельных рабочих областей.
- Memory Bank — структура базы знаний проекта; принципы базы знаний и правила обновления документов. Пример базовой конституции и применение правил к общему workspace компании — авторская адаптация.
Термины
- Workspace — рабочее пространство с доступными документами, инструкциями и инструментами.
- ИИ-агент — помощник на основе ИИ, который получает поручение, выбирает шаги для его выполнения и действует с помощью доступных инструментов.
- Company OS — в этой статье устройство общего рабочего пространства компании для людей и ИИ.
- Персональная OS — рабочее пространство с контекстом, инструкциями и инструментами для задач одного человека.
- Конституция базы знаний — общие принципы её устройства и изменения.
- SSOT — принцип одного авторитетного источника для каждого факта или правила.
- Git — система сохранения истории изменений файлов и обмена изменениями.
- Репозиторий — набор файлов, который ведётся вместе с историей Git.
- Skill — переиспользуемая инструкция агента, иногда со скриптами и шаблонами.
Налаживаете работу с ИИ-агентами?
Помогаю командам настроить проверяемый рабочий процесс. Практические заметки выходят в Telegram-канале.