Онбординг репозитория

koi-project-onboard

Подключить существующий репозиторий с кодом к ResearcherOS и собрать дерево исследования.

Что делает

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

Зачем

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

Когда вызывать

• Репозиторий с кодом лежит рядом с ResearcherOS, а папки с материалами исследования ещё нет
• Нужно сформулировать проблему и гипотезы вместе с AI-помощником, опираясь на код и литературу
• Команда хочет, чтобы материалы исследования жили в отдельной ветке репозитория

Как вызвать

Откройте чат с AI-помощником в редакторе кода (Cursor или Claude Code) в workspace, где рядом лежат ResearcherOS и ваш репозиторий. Попросите подключить путь к проекту и следовать этому сценарию до конца, включая отдельную ветку для материалов.

Подключи /path/to/my_experiment к ResearcherOS.

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

Схема работы

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

flowchart TD
  A[Проверка и обзор кода] --> B[Сверка с литературой]
  B --> C[Разговор: проблема]
  C --> D[Разговор: программа]
  D --> E[Разговор: причины и гипотезы]
  E --> F[Разговор: методы]
  F --> G[Проверка понятности заголовков]
  G --> H[Проверка стиля текста]
  H --> I[Запись дерева исследования]
  I --> J[Отдельная ветка в репозитории]