@bohuyeshan/openagent-labforge-core 3.11.5 → 3.13.0

package/README.ru.md

@@ -1,364 +1,131 @@
-> [!WARNING]
-> **Временное уведомление (на этой неделе): сниженная доступность мейнтейнера**
->
-> Ключевой мейнтейнер Q получил травму, поэтому на этой неделе ответы по issue/PR и релизы могут задерживаться.
-> Спасибо за терпение и поддержку.
-
-> [!NOTE]
->
-> [![Sisyphus Labs - Sisyphus is the agent that codes like your team.](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
->
-> > **Мы создаём полноценную продуктовую версию Sisyphus, чтобы задать стандарты для frontier-агентов. <br />Присоединяйтесь к листу ожидания [здесь](https://sisyphuslabs.ai).**
-
-> [!TIP] Будьте с нами!
->
-> | [](https://discord.gg/PUwSMR9XNk)   | Вступайте в наш [Discord](https://discord.gg/PUwSMR9XNk), чтобы общаться с контрибьюторами и пользователями `openagent-labforge`. |
-> | ----------------------------------- | ------------------------------------------------------------ |
-> | [](https://x.com/justsisyphus)      | Новости и обновления `openagent-labforge` раньше публиковались на моём аккаунте X. <br /> После ошибочной блокировки, [@justsisyphus](https://x.com/justsisyphus) публикует обновления вместо меня. |
-> | [](https://github.com/code-yeongyu) | Подпишитесь на [@code-yeongyu](https://github.com/code-yeongyu) на GitHub, чтобы следить за другими проектами. |
-
-<!-- <CENTERED SECTION FOR GITHUB DISPLAY> --> <div align="center">
-
-[![OpenAgent Labforge](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/openagent-labforge#openagent-labforge)
-
-[![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/openagent-labforge#openagent-labforge)
-
-</div>
-
-> Anthropic [**заблокировал OpenCode из-за нас.**](https://x.com/thdxr/status/2010149530486911014) **Да, это правда.** Они хотят держать вас в замкнутой системе. Claude Code — красивая тюрьма, но всё равно тюрьма.
->
-> Мы не делаем привязки. Мы работаем с любыми моделями. Claude / Kimi / GLM для оркестрации. GPT для рассуждений. Minimax для скорости. Gemini для творческих задач. Будущее — не в выборе одного победителя, а в оркестровке всех. Модели дешевеют каждый месяц. Умнеют каждый месяц. Ни один провайдер не будет доминировать. Мы строим под открытый рынок, а не под чьи-то огороженные сады.
-
-<div align="center">
-
-[![GitHub Release](https://img.shields.io/github/v/release/code-yeongyu/openagent-labforge?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/releases) [![npm downloads](https://img.shields.io/npm/dt/openagent-labforge?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/openagent-labforge) [![GitHub Contributors](https://img.shields.io/github/contributors/code-yeongyu/openagent-labforge?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/graphs/contributors) [![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/openagent-labforge?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/network/members) [![GitHub Stars](https://img.shields.io/github/stars/code-yeongyu/openagent-labforge?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/stargazers) [![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/openagent-labforge?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/issues) [![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/openagent-labforge/blob/master/LICENSE.md) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/openagent-labforge)
-
-English | 한국어 | 日本語 | 简体中文 | Русский
-
-</div> <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
-
-## Отзывы
-
-> «Из-за него я отменил подписку на Cursor. В опенсорс-сообществе происходит что-то невероятное.» — [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
-
-> «Если Claude Code делает за 7 дней то, на что у человека уходит 3 месяца, Sisyphus справляется за 1 час. Он просто работает, пока задача не выполнена. Это дисциплинированный агент.» <br/>— B, исследователь в области квантовых финансов
-
-> «За один день устранил 8000 предупреждений eslint с помощью OpenAgent Labforge.» <br/>— [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
-
-> «За ночь конвертировал приложение на tauri в 45k строк в веб-SaaS с помощью Ohmyopencode и ralph loop. Начал с промпта «проинтервьюируй меня», попросил оценки и рекомендации по вопросам. Было удивительно наблюдать за работой и утром проснуться с почти рабочим сайтом!» — [James Hargis](https://x.com/hargabyte/status/2007299688261882202)
-
-> «Используйте openagent-labforge — вы не захотите возвращаться назад.» <br/>— [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
-
-> «Пока не могу точно объяснить, почему это так круто, но опыт разработки вышел на совершенно другой уровень.» — [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
-
-> «Экспериментирую с open code, OpenAgent Labforge и supermemory этим выходным, чтобы собрать нечто среднее между Minecraft и souls-like.» «Попросил добавить анимации приседания, пока хожу на обеденную прогулку. [Видео]» — [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
-
-> «Ребята, вам нужно включить это в ядро и нанять его. Серьёзно. Это очень, очень, очень хорошо.» <br/>— Henning Kilset
-
-> «Наймите @yeon_gyu_kim, если сможете его уговорить, этот парень революционизировал opencode.» <br/>— [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
-
-> «OpenAgent Labforge — это что-то с чем-то» — [YouTube — Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
-
-------
-
-# OpenAgent Labforge
-
-Вы жонглируете Claude Code, Codex, случайными OSS-моделями. Настраиваете рабочие процессы. Дебажите агентов.
-
-Мы уже проделали эту работу. Протестировали всё. Оставили только то, что реально работает.
-
-Установите OmO. Введите `ultrawork`. Готово.
-
-## Установка
-
-### Для людей
-
-Скопируйте и вставьте этот промпт в ваш LLM-агент (Claude Code, AmpCode, Cursor и т.д.):
-
-```
-Install and configure openagent-labforge by following the instructions here:
-https://raw.githubusercontent.com/code-yeongyu/openagent-labforge/refs/heads/dev/docs/guide/installation.md
-```
-
-Или прочитайте руководство по установке, но серьёзно — пусть агент сделает это за вас. Люди ошибаются в конфигах.
-
-### Для LLM-агентов
-
-Загрузите руководство по установке и следуйте ему:
-
-```bash
-curl -s https://raw.githubusercontent.com/code-yeongyu/openagent-labforge/refs/heads/dev/docs/guide/installation.md
-```
-
-------
-
-## Пропустите этот README
-
-Мы вышли за пределы эпохи чтения документации. Просто вставьте это в своего агента:
-
-```
-Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/openagent-labforge/refs/heads/dev/README.md
-```
-
-## Ключевые возможности
-
-### 🪄 `ultrawork`
-
-Вы правда это читаете? Поразительно.
-
-Установите. Введите `ultrawork` (или `ulw`). Готово.
-
-Всё описанное ниже, каждая функция, каждая оптимизация — вам не нужно это знать. Оно просто работает.
-
-Даже при наличии только следующих подписок ultrawork будет работать отлично (проект не аффилирован с ними, это личная рекомендация):
-
-- [Подписка ChatGPT ($20)](https://chatgpt.com/)
-- [Подписка Kimi Code ($0.99) (*только в этом месяце)](https://www.kimi.com/membership/pricing?track_id=5cdeca93-66f0-4d35-aabb-b6df8fcea328)
-- [Тариф GLM Coding ($10)](https://z.ai/subscribe)
-- При доступе к оплате за токены использование моделей Kimi и Gemini обойдётся недорого.
-
-|     | Функция                                                  | Что делает                                                                                                                                                                                                                       |
-| --- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 🤖   | **Дисциплинированные агенты**                            | Sisyphus оркестрирует Hephaestus, Oracle, Librarian, Explore. Полноценная AI-команда разработки в параллельном режиме.                                                                                                           |
-| ⚡   | **`ultrawork` / `ulw`**                                  | Одно слово. Все агенты активируются. Не останавливается, пока задача не выполнена.                                                                                                                                               |
-| 🚪   | **[IntentGate](https://factory.ai/news/terminal-bench)** | Анализирует истинное намерение пользователя перед классификацией и действием. Никакого буквального неверного толкования.                                                                                                         |
-| 🔗   | **Инструмент правок на основе хэш-якорей**               | Хэш содержимого `LINE#ID` проверяет каждое изменение. Ноль ошибок с устаревшими строками. Вдохновлено [oh-my-pi](https://github.com/can1357/oh-my-pi). [Проблема обвязки →](https://blog.can.ac/2026/02/12/the-harness-problem/) |
-| 🛠️   | **LSP + AST-Grep**                                       | Переименование в рабочем пространстве, диагностика перед сборкой, переписывание с учётом AST. Точность IDE для агентов.                                                                                                          |
-| 🧠   | **Фоновые агенты**                                       | Запускайте 5+ специалистов параллельно. Контекст остаётся компактным. Результаты — когда готовы.                                                                                                                                 |
-| 📚   | **Встроенные MCP**                                       | Exa (веб-поиск), Context7 (официальная документация), Grep.app (поиск по GitHub). Всегда включены.                                                                                                                               |
-| 🔁   | **Ralph Loop / `/ulw-loop`**                             | Самореферентный цикл. Не останавливается, пока задача не выполнена на 100%.                                                                                                                                                      |
-| ✅   | **Todo Enforcer**                                        | Агент завис? Система немедленно возвращает его в работу. Ваша задача будет выполнена, точка.                                                                                                                                     |
-| 💬   | **Comment Checker**                                      | Никакого AI-мусора в комментариях. Код читается так, словно его писал опытный разработчик.                                                                                                                                       |
-| 🖥️   | **Интеграция с Tmux**                                    | Полноценный интерактивный терминал. REPL, дебаггеры, TUI. Всё живое.                                                                                                                                                             |
-| 🔌   | **Совместимость с Claude Code**                          | Ваши хуки, команды, навыки, MCP и плагины? Всё работает без изменений.                                                                                                                                                           |
-| 🎯   | **MCP, встроенные в навыки**                             | Навыки несут собственные MCP-серверы. Никакого раздувания контекста.                                                                                                                                                             |
-| 📋   | **Prometheus Planner**                                   | Стратегическое планирование в режиме интервью перед любым выполнением.                                                                                                                                                           |
-| 🔍   | **`/init-deep`**                                         | Автоматически генерирует иерархические файлы `AGENTS.md` по всему проекту. Отлично работает на эффективность токенов и производительность агента.                                                                                |
-
-### Дисциплинированные агенты
-
-<table><tr> <td align="center"><img src=".github/assets/sisyphus.png" height="300" /></td> <td align="center"><img src=".github/assets/hephaestus.png" height="300" /></td> </tr></table>
-
-**Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) — главный оркестратор. Он планирует, делегирует задачи специалистам и доводит их до завершения с агрессивным параллельным выполнением. Он не останавливается на полпути.
-
-**Hephaestus** (`gpt-5.3-codex`) — автономный глубокий исполнитель. Дайте ему цель, а не рецепт. Он исследует кодовую базу, изучает паттерны и выполняет задачи сквозным образом без лишних подсказок. *Законный Мастер.*
-
-**Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`**) — стратегический планировщик. Режим интервью: задаёт вопросы, определяет объём работ и формирует детальный план до того, как написана хотя бы одна строка кода.
-
-Каждый агент настроен под сильные стороны своей модели. Никакого ручного переключения между моделями. Подробнее →
-
-> Anthropic [заблокировал OpenCode из-за нас.](https://x.com/thdxr/status/2010149530486911014) Именно поэтому Hephaestus зовётся «Законным Мастером». Ирония намеренная.
->
-> Мы работаем лучше всего на Opus, но Kimi K2.5 + GPT-5.3 Codex уже превосходят ванильный Claude Code. Никакой настройки не требуется.
-
-### Оркестрация агентов
-
-Когда Sisyphus делегирует задачу субагенту, он выбирает не модель, а **категорию**. Категория автоматически сопоставляется с нужной моделью:
-
-| Категория            | Для чего предназначена                |
-| -------------------- | ------------------------------------- |
-| `visual-engineering` | Фронтенд, UI/UX, дизайн               |
-| `deep`               | Автономные исследования + выполнение  |
-| `quick`              | Изменения в одном файле, опечатки     |
-| `ultrabrain`         | Сложная логика, архитектурные решения |
-
-Агент сообщает тип задачи. Обвязка подбирает нужную модель. Вы ни к чему не прикасаетесь.
-
-### Совместимость с Claude Code
-
-Вы тщательно настроили Claude Code. Хорошо.
-
-Каждый хук, команда, навык, MCP и плагин работают здесь без изменений. Полная совместимость, включая плагины.
-
-### Инструменты мирового класса для ваших агентов
-
-LSP, AST-Grep, Tmux, MCP — реально интегрированы, а не склеены скотчем.
-
-- **LSP**: `lsp_rename`, `lsp_goto_definition`, `lsp_find_references`, `lsp_diagnostics`. Точность IDE для каждого агента
-- **AST-Grep**: Поиск и переписывание кода с учётом синтаксических паттернов для 25 языков
-- **Tmux**: Полноценный интерактивный терминал. REPL, дебаггеры, TUI-приложения. Агент остаётся в сессии
-- **MCP**: Веб-поиск, официальная документация, поиск по коду на GitHub. Всё встроено
-
-### MCP, встроенные в навыки
-
-MCP-серверы съедают бюджет контекста. Мы это исправили.
-
-Навыки приносят собственные MCP-серверы. Запускаются по необходимости, ограничены задачей, исчезают по завершении. Контекстное окно остаётся чистым.
-
-### Лучше пишет код. Правки на основе хэш-якорей
-
-Проблема обвязки реальна. Большинство сбоев агентов — не вина модели. Это вина инструмента правок.
-
-> *«Ни один из этих инструментов не даёт модели стабильный, проверяемый идентификатор строк, которые она хочет изменить... Все они полагаются на то, что модель воспроизведёт контент, который уже видела. Когда это не получается — а так бывает нередко — пользователь обвиняет модель.»*
->
-> <br/>— [Can Bölük, «Проблема обвязки»](https://blog.can.ac/2026/02/12/the-harness-problem/)
-
-Вдохновлённые [oh-my-pi](https://github.com/can1357/oh-my-pi), мы реализовали **Hashline**. Каждая строка, которую читает агент, возвращается с тегом хэша содержимого:
-
-```
-11#VK| function hello() {
-22#XJ|   return "world";
-33#MB| }
-```
-
-Агент редактирует, ссылаясь на эти теги. Если файл изменился с момента последнего чтения, хэш не совпадёт, и правка будет отклонена до любого повреждения. Никакого воспроизведения пробелов. Никаких ошибок с устаревшими строками.
-
-Grok Code Fast 1: успешность **6.7% → 68.3%**. Просто за счёт замены инструмента правок.
-
-### Глубокая инициализация. `/init-deep`
-
-Запустите `/init-deep`. Будут сгенерированы иерархические файлы `AGENTS.md`:
-
-```
-project/
-├── AGENTS.md              ← контекст всего проекта
-├── src/
-│   ├── AGENTS.md          ← контекст для src
-│   └── components/
-│       └── AGENTS.md      ← контекст для компонентов
-```
-
-Агенты автоматически читают нужный контекст. Никакого ручного управления.
-
-### Планирование. Prometheus
-
-Сложная задача? Не нужно молиться и надеяться на промпт.
-
-`/start-work` вызывает Prometheus. **Интервьюирует вас как настоящий инженер**, определяет объём работ и неоднозначности, формирует проверенный план до прикосновения к коду. Агент знает, что строит, прежде чем начать.
-
-### Навыки
-
-Навыки — это не просто промпты. Каждый привносит:
-
-- Системные инструкции, настроенные под предметную область
-- Встроенные MCP-серверы, запускаемые по необходимости
-- Ограниченные разрешения. Агенты остаются в рамках
-
-Встроенные: `playwright` (автоматизация браузера), `git-master` (атомарные коммиты, хирургия rebase), `frontend-ui-ux` (UI с упором на дизайн).
-
-Добавьте свои: `.opencode/skills/*/SKILL.md` или `~/.config/opencode/skills/*/SKILL.md`.
-
-**Хотите полное описание возможностей?** Смотрите **документацию по функциям** — агенты, хуки, инструменты, MCP и всё остальное подробно.
-
-------
-
-> **Впервые в openagent-labforge?** Прочитайте **Обзор**, чтобы понять, что у вас есть, или ознакомьтесь с **руководством по оркестрации**, чтобы узнать, как агенты взаимодействуют.
-
-## Удаление
-
-Чтобы удалить openagent-labforge:
-
-1. **Удалите плагин из конфига OpenCode**
-
-   Отредактируйте `~/.config/opencode/opencode.json` (или `opencode.jsonc`) и уберите `"openagent-labforge"` из массива `plugin`:
-
-   ```bash
-   # С помощью jq
-   jq '.plugin = [.plugin[] | select(. != "openagent-labforge")]' \
-       ~/.config/opencode/opencode.json > /tmp/oc.json && \
-       mv /tmp/oc.json ~/.config/opencode/opencode.json
-   ```
-
-2. **Удалите файлы конфигурации (опционально)**
-
-   ```bash
-   # Удалить пользовательский конфиг
-   rm -f ~/.config/opencode/openagent-labforge.json ~/.config/opencode/openagent-labforge.jsonc
-
-   # Удалить конфиг проекта (если существует)
-   rm -f .opencode/openagent-labforge.json .opencode/openagent-labforge.jsonc
-   ```
-
-3. **Проверьте удаление**
-
-   ```bash
-   opencode --version
-   # Плагин больше не должен загружаться
-   ```
-
-## Функции
-
-Функции, которые, как вы будете думать, должны были существовать всегда. Попробовав раз, вы не сможете вернуться назад.
-
-Смотрите полную документацию по функциям.
-
-**Краткий обзор:**
-
-- **Агенты**: Sisyphus (главный агент), Prometheus (планировщик), Oracle (архитектура/отладка), Librarian (документация/поиск по коду), Explore (быстрый grep по кодовой базе), Multimodal Looker
-- **Фоновые агенты**: Запускайте несколько агентов параллельно, как настоящая команда разработки
-- **Инструменты LSP и AST**: Рефакторинг, переименование, диагностика, поиск кода с учётом AST
-- **Инструмент правок на основе хэш-якорей**: Ссылки `LINE#ID` проверяют содержимое перед применением каждого изменения. Хирургические правки, ноль ошибок с устаревшими строками
-- **Инъекция контекста**: Автоматическое добавление AGENTS.md, README.md, условных правил
-- **Совместимость с Claude Code**: Полная система хуков, команды, навыки, агенты, MCP
-- **Встроенные MCP**: websearch (Exa), context7 (документация), grep_app (поиск по GitHub)
-- **Инструменты сессий**: Список, чтение, поиск и анализ истории сессий
-- **Инструменты продуктивности**: Ralph Loop, Todo Enforcer, Comment Checker, Think Mode и другое
-- **Настройка моделей**: Сопоставление агент–модель встроено в руководство по установке
-
-## Конфигурация
-
-Продуманные настройки по умолчанию, которые можно изменить при необходимости.
-
-Смотрите документацию по конфигурации.
-
-**Краткий обзор:**
-
-- **Расположение конфигов**: `.opencode/openagent-labforge.jsonc` или `.opencode/openagent-labforge.json` (проект), `~/.config/opencode/openagent-labforge.jsonc` или `~/.config/opencode/openagent-labforge.json` (пользователь)
-- **Поддержка JSONC**: Комментарии и конечные запятые поддерживаются
-- **Агенты**: Переопределение моделей, температур, промптов и разрешений для любого агента
-- **Встроенные навыки**: `playwright` (автоматизация браузера), `git-master` (атомарные коммиты)
-- **Агент Sisyphus**: Главный оркестратор с Prometheus (Планировщик) и Metis (Консультант по плану)
-- **Фоновые задачи**: Настройка ограничений параллельности по провайдеру/модели
-- **Категории**: Делегирование задач по предметной области (`visual`, `business-logic`, пользовательские)
-- **Хуки**: 25+ встроенных хуков, все настраиваются через `disabled_hooks`
-- **MCP**: Встроенные websearch (Exa), context7 (документация), grep_app (поиск по GitHub)
-- **LSP**: Полная поддержка LSP с инструментами рефакторинга
-- **Экспериментальное**: Агрессивное усечение, автовозобновление и другое
-
-## Слово автора
-
-**Хотите узнать философию?** Прочитайте Манифест Ultrawork.
-
-------
-
-Я потратил $24K на токены LLM в личных проектах. Попробовал все инструменты. Настраивал всё до смерти. OpenCode победил.
-
-Каждая проблема, с которой я столкнулся, — её решение уже встроено в этот плагин. Устанавливайте и работайте.
-
-Если OpenCode — это Debian/Arch, то OmO — это Ubuntu/[Omarchy](https://omarchy.org/).
-
-Сильное влияние со стороны [AmpCode](https://ampcode.com) и [Claude Code](https://code.claude.com/docs/overview). Функции портированы, часто улучшены. Продолжаем строить. Это **Open**Code.
-
-Другие обвязки обещают оркестрацию нескольких моделей. Мы её поставляем. Плюс стабильность. Плюс функции, которые реально работают.
-
-Я самый одержимый пользователь этого проекта:
-
-- Какая модель думает острее всего?
-- Кто бог отладки?
-- Кто пишет лучший код?
-- Кто рулит фронтендом?
-- Кто владеет бэкендом?
-- Что быстрее всего в ежедневной работе?
-- Что запускают конкуренты?
-
-Этот плагин — дистилляция. Берём лучшее. Есть улучшения? PR приветствуются.
-
-**Хватит мучиться с выбором обвязки.** **Я буду исследовать, воровать лучшее и поставлять это сюда.**
-
-Звучит высокомерно? Знаете, как сделать лучше? Контрибьютьте. Добро пожаловать.
-
-Никакой аффилиации с упомянутыми проектами/моделями. Только личные эксперименты.
-
-99% этого проекта было создано с помощью OpenCode. Я почти не знаю TypeScript. **Но эту документацию я лично просматривал и во многом переписывал.**
-
-## Любимый профессионалами из
-
-- Indent
-  - Spray — решение для influencer-маркетинга, vovushop — платформа кросс-граничной торговли, vreview — AI-решение для маркетинга отзывов в commerce
-- [Google](https://google.com)
-- [Microsoft](https://microsoft.com)
-- ELESTYLE
-  - elepay — мультимобильный платёжный шлюз, OneQR — мобильное SaaS-приложение для безналичных расчётов
-
-*Особая благодарность [@junhoyeo](https://github.com/junhoyeo) за это потрясающее hero-изображение.*
-
+# OpenAgent Labforge
+
+> [!NOTE]
+> **О производном проекте**
+>
+> OpenAgent Labforge — производная версия `code-yeongyu/oh-my-openagent`
+> (ранее `oh-my-opencode`). Этот форк сохраняет границы лицензии и атрибуцию
+> upstream-проекта, но меняет продуктовый фокус: OpenCode-native делегирование,
+> исследовательские workflow, эргономика MCP и локально-ориентированная работа.
+>
+> Подробности см. в `LICENSE.md`, `NOTICE`, `THIRD_PARTY_NOTICES.md` и
+> `docs/licensing.md`.
+
+## Что сейчас изменено в этом форке
+
+Этот README показывает **текущее поведение и реальные усиления проекта**, а не
+повторяет историю или рекламный стиль upstream.
+
+### 1. Роли агентов разделены заметно чётче
+
+- оркестраторы и specialist-агенты разведены по ответственности
+- `task(subagent_type=...)` считается каноническим путём для inspectable
+  child session в OpenCode
+- ключевые специализации теперь читаются явно:
+  - `librarian` -> один внешний пакет / SDK / framework-вопрос
+  - `github-scout` -> сравнение репозиториев и shortlist для изучения
+  - `tech-scout` -> экосистема, benchmark, релизы, сигналы рынка
+  - `article-writer` -> публичный технический текст
+  - `scientific-writer` -> научный / экспертный технический текст
+- fallback-chain для фоновых child session теперь регистрируется и очищается корректно
+
+### 2. Поиск разделён на точность и широкий охват
+
+- `websearch` -> более точный и качественный поиск
+- `open_websearch_mcp` -> более широкий multi-engine recall
+- `paper_search_mcp` -> академический поиск
+- `context7` -> официальные docs / framework reference
+- `grep_app` -> примеры кода с GitHub
+
+Инъекция search/analyze-подсказок стала легче и больше не пытается
+переопределять уже явно выбранного specialist-агента.
+
+### 3. MCP runtime стал устойчивее
+
+- `bing_cn_mcp` заменён на `open_websearch_mcp`
+- `open_websearch_mcp` получил корректный `environment`, stdio-mode,
+  prompt-probe compatibility, pinned version и увеличенный timeout
+- `paper_search_mcp` возвращён на тот launcher-путь, который реально работает
+  в этом Windows/OpenCode окружении
+- разделение между precision search, broad recall и academic retrieval теперь
+  соответствует реальному продукту
+
+### 4. Skill discovery ближе к поведению OpenCode
+
+- project-local skills ищутся вверх до git root
+- `SKILL.md` проверяется строже
+- установщик автоматически создаёт `openagent-labforge` skill directory для
+  более стабильного plugin-aware routing
+
+### 5. Поверхность релиза и установки тоже очищается от наследия upstream
+
+- корневые README больше не являются зеркалом рекламного текста upstream
+- installer copy, package metadata и schema metadata приведены к текущему fork
+- рекомендуемый путь сейчас: **local build + local install**
+
+## Текущая структура агентов
+
+### Базовые оркестраторы
+
+- `sisyphus`
+- `hephaestus`
+- `prometheus`
+- `atlas`
+- `sisyphus-junior`
+
+### Specialist-агенты
+
+- `explore`
+- `librarian`
+- `github-scout`
+- `tech-scout`
+- `article-writer`
+- `scientific-writer`
+- при необходимости bio / multimodal specialists
+
+## Текущая реальность установки
+
+Сейчас проект оптимизирован под:
+
+1. локальную сборку
+2. локальную упаковку tgz
+3. локальную замену пакета в каталоге конфигурации OpenCode
+
+```bash
+bun run build:skills-catalog
+bun run build
+bun pm pack
+```
+
+Далее следуйте `docs/guide/installation.md`.
+
+## Карта документации
+
+- `docs/guide/installation.md` - текущая установка и локальная замена
+- `docs/guide/overview.md` - актуальная продуктовая форма
+- `docs/guide/orchestration.md` - планирование, выполнение, делегирование
+- `docs/reference/configuration.md` - конфигурация
+- `docs/reference/features.md` - обзор возможностей
+- `examples/README.md` - примеры конфигов и bundle-профилей
+
+## Текущие ограничения
+
+- проект пока остаётся local-first и не доведён до полностью гладкого public npm flow
+- часть вторичных документов ещё требует очистки от старой терминологии upstream
+- браузерные MCP по-прежнему более чувствительны к окружению, чем core search/docs/code MCP
+
+## Происхождение
+
+- Upstream: `https://github.com/code-yeongyu/oh-my-openagent`
+- Current fork: `https://github.com/BOHUYESHAN-APB/openagent-labforge`
+
+Если нижележащий документ расходится с реальным runtime-поведением,
+ориентируйтесь в первую очередь на этот README и `docs/guide/installation.md`.
+
+## Другие языки
+
+- [English](README.md)
+- [简体中文](README.zh-cn.md)
+- [日本語](README.ja.md)
+- [한국어](README.ko.md)
+- [Русский](README.ru.md)