Skip to content

Harness engineering beginner tutorial, from 0 to 1

docs(project-02): add Russian translation of README

Max Ivanova1e2801ba897
diff --git a/projects/project-02/README-RU.md b/projects/project-02/README-RU.md
new file mode 100644
index 0000000..beafe61
--- /dev/null
+++ b/projects/project-02/README-RU.md
@@ -0,0 +1,53 @@
+# Проект 02: Рабочее пространство, читаемое агентом
+
+Продемонстрируйте, как читаемость репозитория и явные артефакты снижают потерю контекста при разработке в несколько сессий.
+
+## Структура каталогов
+
+| Каталог | Значение |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `starter/` | **Отправная точка**: основан на solution из project-01, импорт документов, детальный просмотр и персистентность ещё предстоит реализовать. Харнесс слабый: AGENTS.md минимален, передачи между сессиями нет. |
+| `solution/` | **Эталонная реализация**: все новые функции реализованы, с полной документацией рабочего пространства (ARCHITECTURE.md, PRODUCT.md, session-handoff.md). |
+
+## Как использовать
+
+```sh
+# Требуется минимум 2 сессии агента для завершения
+cd starter
+npm install
+# Сессия A: реализуйте импорт документов и детальный просмотр
+# Сессия B: реализуйте персистентность (наблюдайте, быстро ли агент восстанавливает контекст)
+
+cd ../solution
+npm install
+# Повторите с полным харнессом и сравните скорость восстановления сессии
+```
+
+## Точный контракт задачи
+
+Начните со `starter/`. Starter уже содержит оболочку Project 01 и минимальный
+харнесс. Задача — добавить продуктовый срез Project 02 и документацию
+рабочего пространства, которая позволит второй сессии быстро восстановиться.
+
+| Функция / артефакт | Состояние в starter | Свидетельства в solution |
+| -------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| Импорт документов | Поток импорта не завершён в renderer, preload, IPC и `DocumentService` | `src/renderer/components/ImportPanel.tsx`, `src/main/ipc-handlers.ts`, `src/services/document-service.ts` |
+| Детали документа | Панель деталей не загружает и не отображает полное содержимое файла через IPC | `src/renderer/components/DocumentDetail.tsx`, `IPC_CHANNELS.GET_DOCUMENT_CONTENT` |
+| Базовая персистентность | Импортированные документы не полностью восстанавливаются после перезапуска | `src/services/persistence-service.ts`, обработка `documents-meta.json` |
+| Читаемое агентом состояние | В starter нет итогового файла передачи | `session-handoff.md`, расширенный `docs/ARCHITECTURE.md`, расширенный `docs/PRODUCT.md` |
+
+Выполняйте это как упражнение из двух сессий. Остановите Сессию A до того, как все три
+продуктовые функции будут завершены, затем начните Сессию B только из состояния
+репозитория. Главное сравнение — насколько быстрее Сессия B может возобновить работу,
+когда существуют `session-handoff.md` и документация.
+
+## Реализуемые функции
+
+- Поток импорта документов (выбор файла плюс передача через IPC)
+- Детальный просмотр документа (метаданные плюс отображение содержимого)
+- Базовая персистентность (импортированные документы сохраняются после перезапуска)
+
+## Связанные лекции
+
+- [Лекция 03: Почему репозиторий должен стать системой учёта](../../docs/ru/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md)
+- [Лекция 04: Почему один гигантский файл инструкций не работает](../../docs/ru/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md)