diff --git a/README.md b/README.md index f66dabb..5e30299 100644 --- a/README.md +++ b/README.md @@ -356,6 +356,7 @@ chmod +x script.sh ## Дополнительные материалы в репозитории - Быстрый гайд: `docs/quickstart-30min.md` +- Точка входа: `docs/START-HERE.md` - Готовый starter: `docs/rag-mcp-starter/` - Работа с GitHub/GitLab/Gitea: `docs/openclaude-with-repositories.md` - Примеры cron-автоматизации: `docs/cron-examples.md` diff --git a/docs/START-HERE.md b/docs/START-HERE.md new file mode 100644 index 0000000..fdef660 --- /dev/null +++ b/docs/START-HERE.md @@ -0,0 +1,52 @@ +# START HERE + +Рекомендуемый порядок внедрения OpenClaude + local LLM. + +## План на 1 день (минимальный рабочий контур) + +1. Прочитать: `docs/quickstart-30min.md` +2. Поднять минимальный стек: + - `docs/rag-mcp-starter/install-minimal.sh` +3. Проверить готовность: + - `docs/rag-mcp-starter/healthcheck.sh --mode minimal` +4. Зафиксировать рабочий профиль модели: + - обычно `qwen2.5-coder:7b` + - для слабого сервера `qwen2.5:3b` + +Результат: работает локальный агентный CLI на вашей модели. + +## План на 3 дня (стабилизация и эксплуатация) + +1. Прочитать: + - `docs/model-catalog.md` + - `docs/runtime-choice.md` + - `docs/expectations.md` +2. Поднять полный RAG-стек: + - `docs/rag-mcp-starter/install.sh` +3. Добавить мониторинг и обслуживание: + - `status.sh`, `healthcheck.sh`, `backup.sh` +4. Настроить cron: + - `docs/cron-examples.md` + - `scripts/install-cron.sh` + +Результат: стенд обслуживается автоматически, есть резервные копии. + +## План на 7 дней (рабочий production-like режим) + +1. Подключить процессы репозитория: + - `docs/openclaude-with-repositories.md` +2. Внедрить benchmark-процесс: + - `docs/bench-template.md` +3. Сформировать гибридный routing-подход: + - локальная модель по умолчанию + - облачный fallback на сложные кейсы +4. Отладить цикл обновлений: + - `upgrade.sh` + ежемесячная проверка логов + +Результат: предсказуемый цикл "разработка -> проверка -> обновление" с контролем качества. + +## Что читать по ролям + +- **Администратор сервера**: `runtime-choice`, `cron-examples`, `rag-mcp-starter/*` +- **Разработчик**: `quickstart-30min`, `model-catalog`, `bench-template` +- **Техлид/архитектор**: `expectations`, `cursor-like-stack`, `openclaude-with-repositories`