Tracebook — AI-native платформа для создания и сопровождения технической документации

Главное о кейсе

Платформа объединяет редактор документов, Git-версионирование, описание API-контрактов, модели данных, граф связей и ИИ-ассистента. Продукт разработан KozhinDev для системных и бизнес-аналитиков, архитекторов и команд разработки.

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

Документация хранится в Markdown и Git, поддерживает импорт из существующих источников и может использоваться как структурированный контекст для ИИ-агентов.

Как проект изменил жизнь пользователей

Tracebook меняет повседневную работу аналитиков и команд разработки: вместо ручного сопровождения разрозненных документов они получают единую среду для работы с требованиями, контрактами, схемами и изменениями.

Теперь не нужно копировать страницы, выделять цветом изменённые фрагменты и самостоятельно отслеживать все зависимости. Git-ветки позволяют отделять изменения по задачам, граф связей помогает находить зависимости между документами, а ИИ-ассистент проверяет их целостность и непротиворечивость.

Разработчики и аналитики могут работать с общим контекстом проекта, а не собирать информацию из разных источников. Документация становится структурированной, версионируемой и пригодной для взаимодействия с ИИ-агентами.

Бизнес-задача и ее решение

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

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

Решение: команда KozhinDev разработала Tracebook — платформу, объединяющую редактор документации, Git-версионирование, граф связей, ER-диаграммы, редактор контрактов и ИИ-ассистента.

Дополнительно реализованы импорт существующей документации, интеграции с GitLab и GitHub, MCP-сервер, API и Webhooks. Для корпоративных пользователей предусмотрено Self-hosted-развёртывание.

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

Крафт (мастерство), реализация, технические детали

Ключевая особенность Tracebook — объединение нескольких специализированных инструментов в единой архитектуре документации.
В основе Tracebook лежит AI-native подход: документация изначально создаётся так, чтобы её было легко читать, анализировать и изменять с помощью ИИ. Для этого используется Markdown — текстовый формат, понятный ИИ-моделям, и Git, который обеспечивает прозрачную историю изменений, версионирование и работу с документами через привычные для ИИ инструменты. Благодаря этому ИИ-агенты могут не просто обращаться к документации как к источнику информации, но и полноценно работать с ней: создавать и обновлять документы, анализировать связи и проверять согласованность изменений.
В основе хранения — Markdown и Git: документы версионируются, изменения разделяются по веткам, доступны история и сравнение версий. Отдельный редактор контрактов позволяет структурированно описывать API, модели данных и другие интерфейсы. На основе сущностей автоматически строятся ER-диаграммы и граф связей.
ИИ-ассистент выполняет роль ИИ-линтера: проверяет структуру, целостность и непротиворечивость документации, помогает формировать changelog и описания коммитов.
Реализован импорт из Confluence, Google Docs и репозиториев с кодом. Поддерживаются интеграции с GitLab и GitHub, MCP-сервер, API и Webhooks. Для работы с ИИ можно подключать внешних провайдеров и локальные модели.
Отдельное внимание уделено корпоративному использованию: документация и модели могут оставаться в инфраструктуре заказчика при Self-hosted-развёртывании.

Инсайты, гипотезы, процесс создания и взаимодействия с заказчиком

Разработка Tracebook началась с исследования повседневной работы специалистов, создающих техническую документацию. Мы провели более 50 глубинных интервью с аналитиками и техническими руководителями крупных ИТ-компаний.
Исследование показало, что проблема заключается не только в неудобстве отдельных редакторов. Документы, API, схемы, задачи и согласования находятся в разных инструментах, а изменения приходится вручную переносить и синхронизировать. При этом специалистам сложно удерживать в поле зрения все связи между элементами системы.
Из этого сформировалась основная гипотеза: аналитикам нужна специализированная рабочая среда, в которой документация изначально структурирована, связана с контрактами и версионируется вместе с изменениями проекта. ИИ должен не просто генерировать текст, а помогать контролировать качество и целостность документации.
При проектировании продукта команда объединила подходы Docs-as-Code, Specification-first и AI-assisted workflow. Важным принципом стало сохранение привычного интерфейса редактора: пользователю не обязательно знать Markdown и Git, чтобы работать с версиями документов и изменениями.
Так Tracebook сформировался как самостоятельный продукт на основе исследованных потребностей аналитиков и технических команд.

Скриншоты