speccrew 0.5.9 → 0.5.11

package/docs/GETTING-STARTED.ru.md

@@ -11,11 +11,10 @@
   <a href="./GETTING-STARTED.it.md">Italiano</a> |
   <a href="./GETTING-STARTED.da.md">Dansk</a> |
   <a href="./GETTING-STARTED.ja.md">日本語</a> |
-  <a href="./GETTING-STARTED.ar.md">العربية</a> |
-  <a href="./GETTING-STARTED.ru.md">Русский</a>
+  <a href="./GETTING-STARTED.ar.md">العربية</a>
 </p>
 
-Этот документ поможет вам быстро понять, как использовать команду Агент SpecCrew для завершения полного цикла разработки от требований до доставки в соответствии со стандартными инженерными процессами.
+Этот документ поможет вам быстро понять, как использовать команду Agent SpecCrew для завершения полной разработки от требований до поставки в соответствии со стандартными инженерными процессами.
 
 ---
 
@@ -40,42 +39,117 @@ speccrew init --ide qoder
 ```
 .
 ├── .qoder/
-│   ├── agents/          # Файлы определения Агентов
-│   └── skills/          # Файлы определения Навыков
-├── speccrew-workspace/  # Рабочее пространство
+│   ├── agents/          # Файлы определения Agents
+│   └── skills/          # Файлы определения Skills
+├── speccrew-workspace/  # Workspace
 │   ├── docs/            # Конфигурации, правила, шаблоны, решения
 │   ├── iterations/      # Текущие итерации
 │   ├── iteration-archives/  # Архивированные итерации
 │   └── knowledges/      # База знаний
-│       ├── base/        # Базовая информация (диагностические отчеты, технический долг)
-│       ├── bizs/        # Бизнес-база знаний
-│       └── techs/       # Техническая база знаний
+│       ├── base/        # Базовая информация (отчеты диагностики, технический долг)
+│       ├── bizs/        # База знаний бизнеса
+│       └── techs/       # База технических знаний
 ```
 
-### Справочник команд CLI
+### Краткая справка по командам CLI
 
 | Команда | Описание |
-|---------|-------------|
-| `speccrew list` | Список всех доступных Агентов и Навыков |
+|------|------|
+| `speccrew list` | Список всех доступных Agents и Skills |
 | `speccrew doctor` | Проверка целостности установки |
 | `speccrew update` | Обновление конфигурации проекта до последней версии |
 | `speccrew uninstall` | Удаление SpecCrew |
 
 ---
 
-## 2. Обзор рабочего процесса
+## 2. Быстрый старт за 5 минут после установки
+
+После выполнения `speccrew init` выполните следующие шаги для быстрого перехода в рабочее состояние:
+
+### Шаг 1: Выберите вашу IDE
+
+| IDE | Команда инициализации | Сценарий применения |
+|-----|-----------|----------|
+| **Qoder** (Рекомендуется) | `speccrew init --ide qoder` | Полная оркестрация агентов, параллельные workers |
+| **Cursor** | `speccrew init --ide cursor` | Рабочие процессы на основе Composer |
+| **Claude Code** | `speccrew init --ide claude` | Разработка CLI-first |
+| **Codex** | `speccrew init --ide codex` | Интеграция экосистемы OpenAI |
+
+### Шаг 2: Инициализация базы знаний (Рекомендуется)
+
+Для проектов с существующим исходным кодом рекомендуется сначала инициализировать базу знаний, чтобы агенты понимали вашу кодовую базу:
+
+```
+@speccrew-team-leader инициализировать техническую базу знаний
+```
+
+Затем:
+
+```
+@speccrew-team-leader инициализировать бизнес-базу знаний
+```
+
+### Шаг 3: Начните вашу первую задачу
+
+```
+@speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]
+```
+
+> **Совет**: Если вы не уверены, что делать, просто скажите `@speccrew-team-leader помогите мне начать` — Team Leader автоматически определит статус вашего проекта и направит вас.
+
+---
+
+## 3. Быстрое дерево решений
+
+Не уверены, что делать? Найдите ваш сценарий ниже:
+
+- **У меня новое функциональное требование**
+  → `@speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]`
+
+- **Я хочу сканировать знания существующего проекта**
+  → `@speccrew-team-leader инициализировать техническую базу знаний`
+  → Затем: `@speccrew-team-leader инициализировать бизнес-базу знаний`
+
+- **Я хочу продолжить предыдущую работу**
+  → `@speccrew-team-leader каков текущий прогресс?`
+
+- **Я хочу проверить состояние здоровья системы**
+  → Выполнить в терминале: `speccrew doctor`
+
+- **Я не уверен, что делать**
+  → `@speccrew-team-leader помогите мне начать`
+  → Team Leader автоматически определит статус вашего проекта и направит вас
+
+---
+
+## 4. Краткая справка по Agents
+
+| Роль | Agent | Обязанности | Пример команды |
+|------|-------|-----------------|-----------------|
+| Лидер команды | `@speccrew-team-leader` | Навигация по проекту, инициализация базы знаний, проверка статуса | "Помогите мне начать" |
+| Менеджер продукта | `@speccrew-product-manager` | Анализ требований, генерация PRD | "У меня новое требование: ..." |
+| Дизайнер функций | `@speccrew-feature-designer` | Анализ функций, проектирование спецификаций, API контракты | "Начать проектирование функций для итерации X" |
+| Системный дизайнер | `@speccrew-system-designer` | Проектирование архитектуры, детальное проектирование платформы | "Начать системное проектирование для итерации X" |
+| Системный разработчик | `@speccrew-system-developer` | Координация разработки, генерация кода | "Начать разработку для итерации X" |
+| Менеджер тестирования | `@speccrew-test-manager` | Планирование тестирования, проектирование случаев, выполнение | "Начать тестирование для итерации X" |
+
+> **Примечание**: Вам не нужно запоминать всех агентов. Просто поговорите с `@speccrew-team-leader`, и он направит ваш запрос к правильному агенту.
+
+---
+
+## 5. Обзор рабочего процесса
 
 ### Полная диаграмма потока
 
 ```mermaid
 flowchart LR
-    PRD[Этап 1<br/>Анализ требований<br/>Product Manager] --> FD[Этап 2<br/>Проектирование функций<br/>Feature Designer]
-    FD --> SD[Этап 3<br/>Проектирование системы<br/>System Designer]
-    SD --> DEV[Этап 4<br/>Разработка<br/>System Developer]
-    DEV --> TEST[Этап 5<br/>Тестирование системы<br/>Test Manager]
-    TEST --> ARCHIVE[Этап 6<br/>Архивирование]
+    PRD[Фаза 1<br/>Анализ требований<br/>Product Manager] --> FD[Фаза 2<br/>Feature Design<br/>Feature Designer]
+    FD --> SD[Фаза 3<br/>System Design<br/>System Designer]
+    SD --> DEV[Фаза 4<br/>Разработка<br/>System Developer]
+    DEV --> TEST[Фаза 5<br/>Системное тестирование<br/>Test Manager]
+    TEST --> ARCHIVE[Фаза 6<br/>Архивирование]
     
-    KB[(База знаний<br/>На протяжении всего процесса)] -.-> PRD
+    KB[(База знаний<br/>Весь процесс)] -.-> PRD
     KB -.-> FD
     KB -.-> SD
     KB -.-> DEV
@@ -84,26 +158,26 @@ flowchart LR
 
 ### Основные принципы
 
-1. **Зависимости этапов**: Результаты каждого этапа являются входными данными для следующего этапа
-2. **Подтверждение контрольных точек**: Каждый этап имеет точку подтверждения, требующую одобрения пользователя перед переходом к следующему этапу
-3. **Управление базой знаний**: База знаний проходит через весь процесс, предоставляя контекст для всех этапов
+1. **Зависимости фаз**: Результат каждой фазы является входом для следующей фазы
+2. **Подтверждение checkpoint**: Каждая фаза имеет точку подтверждения, требующую одобрения пользователя перед переходом к следующей фазе
+3. **Управляемо базой знаний**: База знаний проходит через весь процесс, предоставляя контекст для всех фаз
 
 ---
 
-## 3. Нулевой шаг: Инициализация базы знаний
+## 6. Шаг ноль: Инициализация базы знаний
 
 Перед началом формального инженерного процесса необходимо инициализировать базу знаний проекта.
 
-### 3.1 Инициализация технической базы знаний
+### 6.1 Инициализация технической базы знаний
 
-**Пример диалога**:
+**Пример разговора**:
 ```
 @speccrew-team-leader инициализировать техническую базу знаний
 ```
 
-**Трехэтапный процесс**:
-1. Обнаружение платформы — Идентификация технологических платформ в проекте
-2. Генерация технической документации — Создание документов технических спецификаций для каждой платформы
+**Трехфазный процесс**:
+1. Обнаружение платформы — Идентификация технических платформ в проекте
+2. Генерация технической документации — Генерация документов технических спецификаций для каждой платформы
 3. Генерация индекса — Создание индекса базы знаний
 
 **Результат**:
@@ -116,18 +190,18 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Файл индекса
 ```
 
-### 3.2 Инициализация бизнес-базы знаний
+### 6.2 Инициализация бизнес-базы знаний
 
-**Пример диалога**:
+**Пример разговора**:
 ```
 @speccrew-team-leader инициализировать бизнес-базу знаний
 ```
 
-**Четырехэтапный процесс**:
-1. Инвентаризация функций — Сканирование кода для идентификации всех функциональных возможностей
-2. Анализ функций — Анализ бизнес-логики каждой функции
-3. Сводка по модулям — Суммаризация функций по модулям
-4. Сводка системы — Создание бизнес-обзора на уровне системы
+**Четырехфазный процесс**:
+1. Инвентаризация функций — Сканирование кода для идентификации всех функций
+2. Анализ функций — Анализ бизнес-логики для каждой функции
+3. Сводка по модулю — Сводка функций по модулю
+4. Системная сводка — Генерация бизнес-обзора на уровне системы
 
 **Результат**:
 ```
@@ -140,19 +214,19 @@ speccrew-workspace/knowledges/bizs/
 
 ---
 
-## 4. Руководство по диалогу этап за этапом
+## 7. Пошаговое руководство по разговору
 
-### 4.1 Этап 1: Анализ требований (Product Manager)
+### 7.1 Фаза 1: Анализ требований (Product Manager)
 
 **Как начать**:
 ```
-@speccrew-product-manager у меня новое требование: [опишите ваше требование]
+@speccrew-product-manager У меня новое требование: [опишите ваше требование]
 ```
 
-**Рабочий процесс Агента**:
-1. Чтение обзора системы для понимания существующих модулей
-2. Анализ требований пользователя
-3. Генерация структурированного документа PRD
+**Рабочий процесс Agent**:
+1. Прочитать обзор системы для понимания существующих модулей
+2. Анализировать требования пользователя
+3. Сгенерировать структурированный документ PRD
 
 **Результат**:
 ```
@@ -169,47 +243,47 @@ iterations/{номер}-{тип}-{имя}/01.product-requirement/
 
 ---
 
-### 4.2 Этап 2: Проектирование функций (Feature Designer)
+### 7.2 Фаза 2: Feature Design (Feature Designer)
 
 **Как начать**:
 ```
-@speccrew-feature-designer начать проектирование функций
+@speccrew-feature-designer начать feature design
 ```
 
-**Рабочий процесс Агента**:
-1. Автоматическое обнаружение подтвержденного документа PRD
-2. Загрузка бизнес-базы знаний
-3. Генерация проектирования функций (включая UI-вейрфреймы, потоки взаимодействия, определения данных, API-контракты)
+**Рабочий процесс Agent**:
+1. Автоматически найти подтвержденный документ PRD
+2. Загрузить бизнес-базу знаний
+3. Сгенерировать feature design (включая UI wireframes, потоки взаимодействия, определения данных, API контракты)
 4. Для нескольких PRD использовать Task Worker для параллельного проектирования
 
 **Результат**:
 ```
 iterations/{iter}/02.feature-design/
-└── [feature-name]-feature-spec.md  # Документ проектирования функций
+└── [feature-name]-feature-spec.md  # Документ feature design
 ```
 
 **Контрольный список подтверждения**:
-- [ ] Все пользовательские сценарии покрыты?
+- [ ] Все пользовательские сценарии охвачены?
 - [ ] Потоки взаимодействия ясны?
 - [ ] Определения полей данных полны?
-- [ ] Обработка исключений всесторонняя?
+- [ ] Обработка исключений комплексна?
 
 ---
 
-### 4.3 Этап 3: Проектирование системы (System Designer)
+### 7.3 Фаза 3: System Design (System Designer)
 
 **Как начать**:
 ```
-@speccrew-system-designer начать проектирование системы
+@speccrew-system-designer начать system design
 ```
 
-**Рабочий процесс Агента**:
-1. Обнаружение Feature Spec и API Contract
-2. Загрузка технической базы знаний (технологический стек, архитектура, спецификации для каждой платформы)
-3. **Контрольная точка A**: Оценка фреймворка — Анализ технических пробелов, рекомендация новых фреймворков (при необходимости), ожидание подтверждения пользователя
-4. Генерация DESIGN-OVERVIEW.md
-5. Использование Task Worker для параллельной рассылки проектирования для каждой платформы (frontend/backend/мобильный/настольный)
-6. **Контрольная точка B**: Совместное подтверждение — Показ сводки всех дизайнов платформ, ожидание подтверждения пользователя
+**Рабочий процесс Agent**:
+1. Найти Feature Spec и API Contract
+2. Загрузить техническую базу знаний (технологический стек, архитектура, спецификации для каждой платформы)
+3. **Checkpoint A**: Оценка framework — Анализ технических пробелов, рекомендация новых frameworks (если необходимо), ожидание подтверждения пользователя
+4. Сгенерировать DESIGN-OVERVIEW.md
+5. Использовать Task Worker для параллельного распределения проектирования для каждой платформы (frontend/backend/mobile/desktop)
+6. **Checkpoint B**: Совместное подтверждение — Показать сводку всех дизайнов платформ, ожидание подтверждения пользователя
 
 **Результат**:
 ```
@@ -217,34 +291,34 @@ iterations/{iter}/03.system-design/
 ├── DESIGN-OVERVIEW.md              # Обзор дизайна
 ├── {platform-id}/
 │   ├── INDEX.md                    # Индекс дизайна платформы
-│   └── {module}-design.md          # Проектирование модуля на уровне псевдокода
+│   └── {module}-design.md          # Проектирование модуля уровня pseudocode
 ```
 
 **Контрольный список подтверждения**:
-- [ ] Псевдокод использует реальный синтаксис фреймворка?
-- [ ] Кросс-платформенные API-контракты согласованы?
-- [ ] Стратегия обработки ошибок унифицирована?
+- [ ] Pseudocode использует фактический синтаксис framework?
+- [ ] Кросс-платформенные API контракты согласованы?
+- [ ] Стратегия обработки ошибок едина?
 
 ---
 
-### 4.4 Этап 4: Реализация разработки (System Developer)
+### 7.4 Фаза 4: Разработка (System Developer)
 
 **Как начать**:
 ```
 @speccrew-system-developer начать разработку
 ```
 
-**Рабочий процесс Агента**:
-1. Чтение документов проектирования системы
-2. Загрузка технических знаний для каждой платформы
-3. **Контрольная точка A**: Предварительная проверка среды — Проверка версий runtime, зависимостей, доступности сервисов; при сбое ожидание решения пользователя
-4. Использование Task Worker для параллельной рассылки разработки для каждой платформы
-5. Проверка интеграции: Выравнивание API-контрактов, согласованность данных
-6. Вывод отчета о доставке
+**Рабочий процесс Agent**:
+1. Прочитать документы системного дизайна
+2. Загрузить технические знания для каждой платформы
+3. **Checkpoint A**: Предварительная проверка среды — Проверить версии runtime, зависимости, доступность сервисов; ожидать решения пользователя при сбое
+4. Использовать Task Worker для параллельного распределения разработки для каждой платформы
+5. Проверка интеграции: выравнивание API контрактов, согласованность данных
+6. Сформировать отчет о поставке
 
 **Результат**:
 ```
-# Исходный код записан в фактический каталог исходного кода проекта
+# Исходный код записывается в фактический каталог исходного кода проекта
 iterations/{iter}/04.development/
 ├── {platform-id}/
 │   └── tasks/                      # Записи задач разработки
@@ -253,49 +327,49 @@ iterations/{iter}/04.development/
 
 **Контрольный список подтверждения**:
 - [ ] Среда готова?
-- [ ] Проблемы интеграции в приемлемых пределах?
+- [ ] Проблемы интеграции в приемлемом диапазоне?
 - [ ] Код соответствует спецификациям разработки?
 
 ---
 
-### 4.5 Этап 5: Тестирование системы (Test Manager)
+### 7.5 Фаза 5: Системное тестирование (Test Manager)
 
 **Как начать**:
 ```
 @speccrew-test-manager начать тестирование
 ```
 
-**Трехэтапный процесс тестирования**:
+**Трехфазный процесс тестирования**:
 
-| Этап | Описание | Контрольная точка |
-|------|----------|-------------------|
-| Проектирование тест-кейсов | Генерация тест-кейсов на основе PRD и Feature Spec | A: Показать статистику покрытия кейсов и матрицу трассировки, ожидание подтверждения пользователем достаточного покрытия |
-| Генерация тестового кода | Генерация исполняемого тестового кода | B: Показать сгенерированные тестовые файлы и маппинг кейсов, ожидание подтверждения пользователя |
-| Выполнение тестов и отчет о багах | Автоматическое выполнение тестов и генерация отчетов | Нет (автоматическое выполнение) |
+| Фаза | Описание | Checkpoint |
+|-------|-------------|------------|
+| Проектирование тестовых случаев | Генерация тестовых случаев на основе PRD и Feature Spec | A: Показать статистику покрытия случаев и матрицу трассировки, ожидание подтверждения пользователем достаточного покрытия |
+| Генерация тестового кода | Генерация исполняемого тестового кода | B: Показать сгенерированные тестовые файлы и отображение случаев, ожидание подтверждения пользователя |
+| Выполнение тестов и отчеты об ошибках | Автоматическое выполнение тестов и генерация отчетов | Нет (автоматическое выполнение) |
 
 **Результат**:
 ```
 iterations/{iter}/05.system-test/
 ├── cases/
-│   └── {platform-id}/              # Документы тест-кейсов
+│   └── {platform-id}/              # Документы тестовых случаев
 ├── code/
 │   └── {platform-id}/              # План тестового кода
 ├── reports/
 │   └── test-report-{date}.md       # Отчет о тестировании
 └── bugs/
-    └── BUG-{id}-{title}.md         # Отчеты о багах (один файл на баг)
+    └── BUG-{id}-{title}.md         # Отчеты об ошибках (один файл на ошибку)
 ```
 
 **Контрольный список подтверждения**:
-- [ ] Покрытие кейсов полное?
+- [ ] Покрытие случаев полное?
 - [ ] Тестовый код исполняемый?
-- [ ] Оценка серьезности багов точна?
+- [ ] Оценка серьезности ошибок точна?
 
 ---
 
-### 4.6 Этап 6: Архивирование
+### 7.6 Фаза 6: Архивирование
 
-Итерации архивируются автоматически при завершении:
+Итерации автоматически архивируются после завершения:
 
 ```
 speccrew-workspace/iteration-archives/
@@ -309,11 +383,11 @@ speccrew-workspace/iteration-archives/
 
 ---
 
-## 5. Обзор базы знаний
+## 8. Обзор базы знаний
 
-### 5.1 Бизнес-база знаний (bizs)
+### 8.1 Бизнес-база знаний (bizs)
 
-**Назначение**: Хранение описаний бизнес-функций проекта, разделений модулей, характеристик API
+**Назначение**: Хранение описаний бизнес-функций проекта, деления на модули, характеристик API
 
 **Структура каталогов**:
 ```
@@ -326,7 +400,7 @@ knowledges/bizs/
 
 **Сценарии использования**: Product Manager, Feature Designer
 
-### 5.2 Техническая база знаний (techs)
+### 8.2 Техническая база знаний (techs)
 
 **Назначение**: Хранение технологического стека проекта, архитектурных соглашений, спецификаций разработки, спецификаций тестирования
 
@@ -344,21 +418,21 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Управление прогрессом рабочего процесса
+## 9. Управление прогрессом рабочего процесса
 
-Виртуальная команда SpecCrew следует строгому механизму фазовых ворот, где каждая фаза должна быть подтверждена пользователем перед переходом к следующей. Также поддерживает возобновляемое выполнение — при перезапуске после прерывания автоматически продолжает с места остановки.
+Виртуальная команда SpecCrew следует строгому механизму stage-gating, где каждая фаза должна быть подтверждена пользователем перед переходом к следующей. Также поддерживает возобновляемое выполнение — при перезапуске после прерывания автоматически продолжается с места остановки.
 
-### 6.1 Трёхуровневые файлы прогресса
+### 9.1 Трехуровневые файлы прогресса
 
 Рабочий процесс автоматически поддерживает три типа JSON файлов прогресса, расположенных в каталоге итерации:
 
 | Файл | Расположение | Назначение |
 |------|----------|---------|
-| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Записывает статус каждого этапа пайплайна |
-| `.checkpoints.json` | В каждом каталоге фазы | Записывает статус подтверждения контрольных точек пользователем |
-| `DISPATCH-PROGRESS.json` | В каждом каталоге фазы | Записывает поэтапный прогресс для параллельных задач (мультиплатформенных/мультимодульных) |
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Записывает статус каждой фазы pipeline |
+| `.checkpoints.json` | Под каждым каталогом фазы | Записывает статус подтверждения checkpoint пользователя |
+| `DISPATCH-PROGRESS.json` | Под каждым каталогом фазы | Записывает поэтапный прогресс для параллельных задач (multi-platform/multi-module) |
 
-### 6.2 Поток статуса фазы
+### 9.2 Поток статуса фазы
 
 Каждая фаза следует этому потоку статуса:
 
@@ -366,57 +440,57 @@ knowledges/techs/{platform-id}/
 pending → in_progress → completed → confirmed
 ```
 
-- **pending**: Ещё не начато
-- **in_progress**: В данный момент выполняется
-- **completed**: Выполнение Агента завершено, ожидание подтверждения пользователя
-- **confirmed**: Пользователь подтвердил через финальную контрольную точку, следующая фаза может начаться
+- **pending**: Еще не начато
+- **in_progress**: Выполняется
+- **completed**: Выполнение агента завершено, ожидание подтверждения пользователя
+- **confirmed**: Пользователь подтвердил через финальный checkpoint, следующая фаза может начаться
 
-### 6.3 Возобновляемое выполнение
+### 9.3 Возобновляемое выполнение
 
-При перезапуске Агента для фазы:
+При перезапуске Agent для фазы:
 
-1. **Автоматическая проверка вверх по потоку**: Проверяет, подтверждена ли предыдущая фаза, блокирует и уведомляет, если нет
-2. **Восстановление контрольных точек**: Читает `.checkpoints.json`, пропускает пройденные контрольные точки, продолжает с последней точки прерывания
+1. **Автоматическая проверка upstream**: Проверяет, подтверждена ли предыдущая фаза, блокирует и запрашивает, если нет
+2. **Восстановление Checkpoint**: Читает `.checkpoints.json`, пропускает пройденные checkpoints, продолжает с последней точки прерывания
 3. **Восстановление параллельных задач**: Читает `DISPATCH-PROGRESS.json`, повторно выполняет только задачи со статусом `pending` или `failed`, пропускает задачи `completed`
 
-### 6.4 Просмотр текущего прогресса
+### 9.4 Просмотр текущего прогресса
 
-Просмотр панорамного статуса пайплайна через Агента Team Leader:
+Просмотр статуса panorama pipeline через Agent Team Leader:
 
 ```
-@speccrew-team-leader просмотр текущего прогресса итерации
+@speccrew-team-leader просмотреть текущий прогресс итерации
 ```
 
-Team Leader прочитает файлы прогресса и отобразит обзор статуса, подобный:
+Team Leader прочитает файлы прогресса и покажет обзор статуса, подобный:
 
 ```
 Pipeline Status: i001-user-management
-  01 PRD:            ✅ Подтверждено
-  02 Feature Design: 🔄 В процессе (Контрольная точка A пройдена)
-  03 System Design:  ⏳ Ожидание
-  04 Development:    ⏳ Ожидание
-  05 System Test:    ⏳ Ожидание
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
 ```
 
-### 6.5 Обратная совместимость
+### 9.5 Обратная совместимость
 
-Механизм файлов прогресса полностью обратно совместим — если файлы прогресса не существуют (например, в устаревших проектах или новых итерациях), все Агенты будут выполняться нормально в соответствии с исходной логикой.
+Механизм файлов прогресса полностью обратно совместим — если файлы прогресса не существуют (например, в legacy проектах или новых итерациях), все Agents будут выполняться нормально согласно оригинальной логике.
 
 ---
 
-## 7. Часто задаваемые вопросы (FAQ)
+## 10. Часто задаваемые вопросы (FAQ)
 
-### В1: Что делать, если Агент не работает как ожидается?
+### В1: Что делать, если Agent не работает как ожидалось?
 
-1. Выполните `speccrew doctor` для проверки целостности установки
-2. Подтвердите, что база знаний инициализирована
-3. Подтвердите, что результаты предыдущего этапа существуют в текущем каталоге итерации
+1. Выполнить `speccrew doctor` для проверки целостности установки
+2. Подтвердить, что база знаний инициализирована
+3. Подтвердить, что результат предыдущей фазы существует в текущем каталоге итерации
 
-### В2: Как пропустить этап?
+### В2: Как пропустить фазу?
 
-**Не рекомендуется** — Вывод каждого этапа является вводом для следующего этапа.
+**Не рекомендуется** — Выход каждой фазы является входом для следующей фазы.
 
-Если необходимо пропустить, подготовьте вручную входной документ соответствующего этапа и убедитесь, что он соответствует спецификациям формата.
+Если необходимо пропустить, вручную подготовьте входной документ соответствующей фазы и убедитесь, что он соответствует спецификациям формата.
 
 ### В3: Как обрабатывать несколько параллельных требований?
 
@@ -432,87 +506,92 @@ iterations/
 
 ### В4: Как обновить версию SpecCrew?
 
-Обновление требует два этапа:
+Обновление требует двух шагов:
 
 ```bash
-# Этап 1: Обновить глобальный CLI-инструмент
+# Шаг 1: Обновить глобальный инструмент CLI
 npm install -g speccrew@latest
 
-# Этап 2: Синхронизировать Агентов и Навыки в директории проекта
+# Шаг 2: Синхронизировать Agents и Skills в каталоге проекта
 cd /path/to/your-project
 speccrew update
 ```
 
-- `npm install -g speccrew@latest`: Обновляет сам CLI-инструмент (новые версии могут включать новые определения Агентов/Навыков, исправления ошибок и т.д.)
-- `speccrew update`: Синхронизирует файлы определений Агентов и Навыков в вашем проекте до последней версии
+- `npm install -g speccrew@latest`: Обновляет сам инструмент CLI (новые версии могут включать новые определения Agent/Skill, исправления ошибок и т.д.)
+- `speccrew update`: Синхронизирует файлы определения Agent и Skill в вашем проекте до последней версии
 - `speccrew update --ide cursor`: Обновляет конфигурацию только для конкретной IDE
 
-> **Примечание**: Оба этапа обязательны. Выполнение только `speccrew update` не обновит сам CLI-инструмент; выполнение только `npm install` не обновит файлы проекта.
+> **Примечание**: Оба шага требуются. Выполнение только `speccrew update` не обновит сам инструмент CLI; выполнение только `npm install` не обновит файлы проекта.
+
+### В5: `speccrew update` показывает доступную новую версию, но `npm install -g speccrew@latest` все еще устанавливает старую версию?
 
-### В5: `speccrew update` показывает новую версию, но после установки всё ещё старая?
+Это обычно вызвано кэшем npm. Решение:
 
-Обычно это вызвано кэшем npm. Решение:
 ```bash
+# Очистить кэш npm и переустановить
 npm cache clean --force
 npm install -g speccrew@latest
+
+# Проверить версию
 npm list -g speccrew
 ```
-Если всё ещё не работает, установите конкретную версию:
+
+Если все еще не работает, попробуйте установить с конкретным номером версии:
 ```bash
 npm install -g speccrew@0.5.6
 ```
 
-### В6: Как посмотреть исторические итерации?
+### В6: Как просмотреть исторические итерации?
 
-После архивирования смотрите в `speccrew-workspace/iteration-archives/`, организовано в формате `{номер}-{тип}-{имя}-{дата}/`.
+После архивирования просмотреть в `speccrew-workspace/iteration-archives/`, организовано по формату `{номер}-{тип}-{имя}-{дата}/`.
 
-### В7: Нужна ли базе знаний регулярная актуализация?
+### В7: Требуется ли регулярное обновление базы знаний?
 
-Реинициализация требуется в следующих ситуациях:
-- Значительные изменения структуры проекта
+Повторная инициализация требуется в следующих ситуациях:
+- Значительные изменения в структуре проекта
 - Обновление или замена технологического стека
 - Добавление/удаление бизнес-модулей
 
 ---
 
-## 8. Быстрая справка
+## 11. Краткая справка
 
-### Быстрая справка по запуску Агентов
+### Краткая справка по запуску Agents
 
-| Этап | Агент | Начальный диалог |
-|------|-------|-------------------|
+| Фаза | Agent | Начальный разговор |
+|-------|-------|-------------------|
 | Инициализация | Team Leader | `@speccrew-team-leader инициализировать техническую базу знаний` |
-| Анализ требований | Product Manager | `@speccrew-product-manager у меня новое требование: [описание]` |
-| Проектирование функций | Feature Designer | `@speccrew-feature-designer начать проектирование функций` |
-| Проектирование системы | System Designer | `@speccrew-system-designer начать проектирование системы` |
+| Анализ требований | Product Manager | `@speccrew-product-manager У меня новое требование: [описание]` |
+| Feature Design | Feature Designer | `@speccrew-feature-designer начать feature design` |
+| System Design | System Designer | `@speccrew-system-designer начать system design` |
 | Разработка | System Developer | `@speccrew-system-developer начать разработку` |
-| Тестирование системы | Test Manager | `@speccrew-test-manager начать тестирование` |
+| Системное тестирование | Test Manager | `@speccrew-test-manager начать тестирование` |
 
-### Контрольный список контрольных точек
+### Контрольный список Checkpoint
 
-| Этап | Количество контрольных точек | Ключевые элементы проверки |
-|------|-----------------------------|---------------------------|
+| Фаза | Количество Checkpoint | Ключевые элементы проверки |
+|-------|----------------------|-----------------|
 | Анализ требований | 1 | Точность требований, полнота бизнес-правил, измеримость критериев приемки |
-| Проектирование функций | 1 | Покрытие сценариев, ясность взаимодействия, полнота данных, обработка исключений |
-| Проектирование системы | 2 | A: Оценка фреймворка; B: Синтаксис псевдокода, кросс-платформенная согласованность, обработка ошибок |
+| Feature Design | 1 | Покрытие сценариев, ясность взаимодействия, полнота данных, обработка исключений |
+| System Design | 2 | A: Оценка framework; B: Синтаксис pseudocode, кросс-платформенная согласованность, обработка ошибок |
 | Разработка | 1 | A: Готовность среды, проблемы интеграции, спецификации кода |
-| Тестирование системы | 2 | A: Покрытие кейсов; B: Исполняемость тестового кода |
+| Системное тестирование | 2 | A: Покрытие случаев; B: Исполняемость тестового кода |
 
-### Быстрая справка по путям результатов
+### Краткая справка по путям результатов
 
-| Этап | Выходной каталог | Формат файла |
-|------|-----------------|-------------|
+| Фаза | Выходной каталог | Формат файла |
+|-------|-----------------|-------------|
 | Анализ требований | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
-| Проектирование функций | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
-| Проектирование системы | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
+| Feature Design | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
+| System Design | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
 | Разработка | `iterations/{iter}/04.development/` | Исходный код + `delivery-report.md` |
-| Тестирование системы | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
-| Архивирование | `iteration-archives/{iter}-{дата}/` | Полная копия итерации |
+| Системное тестирование | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
+| Архивирование | `iteration-archives/{iter}-{date}/` | Полная копия итерации |
 
 ---
 
 ## Следующие шаги
 
 1. Выполните `speccrew init --ide qoder` для инициализации вашего проекта
-2. Выполните Нулевой шаг: Инициализация базы знаний
-3. Продвигайтесь через каждый этап следуя рабочему процессу, наслаждаясь опытом разработки на основе спецификаций!
+2. Выполните Шаг Ноль: Инициализация базы знаний
+3. Продвигайтесь фаза за фазой согласно рабочему процессу, наслаждайтесь опытом разработки на основе спецификаций!