docs: add micro-scout research and experimental roadmap

2026-09-16 02:44:54 +03:00
commit 88b7e623b8
3 changed files with 650 additions and 0 deletions
@@ -0,0 +1,42 @@
+# micro-scout
+
+Исследовательский проект быстрого локального скаута контекста для программного кода.
+
+Скаут должен находить полезные исходные фрагменты, учитывать связи между символами и передавать контекст большой модели через небольшой агентский harness — цикл управления моделью и инструментами.
+
+## Статус
+
+Подготовлены исследование и план экспериментов. Реализация, обученные веса и собственные результаты измерений пока отсутствуют.
+
+## Документация
+
+- [Исследование и план разработки](docs/RESEARCH_RU.md): существующие решения, Graphify, архитектура, данные, обучение, оценка пользы, ресурсы и восьминедельный план.
+- Дата исследования: 16 сентября 2026 года.
+- В текущей смете исключена оплата вызовов модели-учителя и основной модели; учитываются обучение своей модели и инфраструктура.
+
+## Предлагаемая архитектура
+
+```text
+Репозиторий и текущие изменения
+    → граф символов и поисковые индексы
+    → поиск кандидатов
+    → маленькая модель отбора и выбора действий
+    → исходные фрагменты с проверенными адресами
+    → большая модель и проверка решения
+```
+
+Факты о репозитории хранятся во внешнем обновляемом индексе. Модель обучается выбирать полезный контекст и действия поиска на новых проектах.
+
+## Первые эксперименты
+
+1. Собрать минимальный harness с поиском, чтением символов и обходом графа.
+2. Сравнить обычный поиск, графовый поиск и готовый ранжировщик на одинаковых задачах.
+3. Измерить успешность решения, полную задержку, объём контекста и свежесть ссылок.
+4. Проверить пользу собственного encoder и затем уменьшить его размер.
+5. При подтверждённом эффекте обучать выбор действий и бюджета поиска.
+
+## Критерий полезности
+
+Сокращение времени решения при сохранении успешности на незнакомых репозиториях. Проверяются весь агентский цикл, дополнительные чтения и обновление индекса, а не только скорость отдельного вызова модели.
+
+Целевые размеры моделей, задержки и бюджеты в исследовании являются гипотезами для проверки, а не опубликованными результатами micro-scout.