Novels

# Рабочий процесс (PM Flow)

> Описание того, как Claude-PM работает с заказчиком над проектом AI Story Writer.

---

## Роли

| Роль | Кто | Ответственность |

|------|-----|-----------------|

| **Заказчик** | Пользователь продукта | Описывает потребности, тестирует, даёт обратную связь |

| **PM (Claude)** | AI-ассистент | Анализирует, декомпозирует, создаёт задачи, обновляет wiki |

| **Разработчик (Claude)** | AI-ассистент | Реализует задачи, пишет код, тестирует |

---

## Процесс

### Phase 1: Intake (Приём требований)

```

Заказчик → описывает потребность в чате

    ↓

PM → анализирует:

    • Пересечения с существующими требованиями

    • Зависимости от других фич

    • Системные последствия (какие модули затрагивает)

    ↓

PM → задаёт уточняющие вопросы (если нужно)

    ↓

PM → создаёт/обновляет:

    • Issue в Redmine (с категорией, приоритетом, описанием)

    • Требование в wiki [[Requirements]]

    • Связи между задачами

```

**Пример:**

> Заказчик: "Хочу чтобы чат работал как табы в Cursor"

>

> PM анализирует:

> - Пересечение с F25 (session selector) — заменяет dropdown на табы

> - Пересечение с F26 (clear history) — закрытие таба vs удаление

> - Зависимость: нужен store для "открытых" сессий (отдельно от всех)

>

> PM создаёт issue F33 и обновляет REQ-SM-13 в wiki.

---

### Phase 2: Triage (Классификация и приоритизация)

PM классифицирует каждую задачу:

| Тип | Описание | Пример |

|-----|----------|--------|

| **Bug** | Что-то сломано | F35: правки не отображаются |

| **Feature** | Новый функционал | FR17: правила для книги |

| **Improvement** | Улучшение существующего | F36: diff-отображение правок |

| **Tech Debt** | Внутреннее качество | A3: N+1 запросы |

PM оценивает приоритет по матрице:

| | Low Effort | Medium Effort | High Effort |

|---|-----------|---------------|-------------|

| **High Impact** | P0 — делать первым | P0 — делать первым | P1 — планировать |

| **Medium Impact** | P1 — планировать | P2 — в очередь | P2 — в очередь |

| **Low Impact** | P2 — в очередь | P3 — backlog | P3 — backlog |

---

### Phase 3: Системное мышление (ключевое)

> **Главный принцип PM:** При каждом новом требовании спросить себя: "Какие ещё 2-3 задачи это затрагивает?"

**Матрица зависимостей (примеры):**

| Новое требование | Затрагивает | Почему |

|-----------------|-------------|--------|

| F36 (diff view) | NAI-7, FR12, F34 | Версии блоков + подсветка + review mode |

| FR17 (book rules) | FR9, NAI-3 | customInstructions + style memory + structured rules |

| FR11 (collaboration) | FR16, B1, B2 | Presence + auth + session ownership |

| F39 (mobile UI) | F42-F71, FR15 | 30 UI-issues завязаны на mobile |

**"Пакетные" решения:**

PM ищет возможность решить 3 задачи одним рефакторингом. Примеры из истории:

- **Пакет "Auth"**: S1 + S2 + S3 + B1 + B2 = FR1 (одна большая фича закрыла 5 проблем безопасности)

- **Пакет "Streaming"**: Narrator #1 + #2 + #4 + #27 = AgentRunner + WebSocket (один рефакторинг закрыл 4 проблемы)

- **Пакет "Entity CRUD"**: FR4 + F28 + F29 = единый подход к CRUD-страницам (3 фичи одним паттерном)

---

### Phase 4: Реализация

```

PM → формирует план реализации:

    • Разбивка на подзадачи (если крупная фича)

    • Порядок выполнения (зависимости)

    • Оценка затрагиваемых файлов

    ↓

Разработчик → реализует задачу:

    • Код (backend/frontend)

    • Тесты (если применимо)

    • Обновление документации

    ↓

PM → верифицирует:

    • Задача закрыта в Redmine

    • Требование обновлено в wiki (✅)

    • Нет регрессий

```

---

### Phase 5: Обратная связь

После реализации:

1. **PM обновляет wiki** — статус требования ✅, ссылка на issue

2. **PM закрывает issues** в Redmine

3. **PM предлагает follow-up** — что можно улучшить дальше

4. **Заказчик тестирует** — даёт обратную связь

5. **PM создаёт новые issues** из обратной связи (цикл повторяется)

---

## Инструменты

| Инструмент | Назначение | Как используется |

|------------|-----------|-----------------|

| **Redmine** | Трекер задач | Issues, wiki, категории |

| **GitHub** | Код + CI/CD | Репозиторий, Actions, Docker |

| **Claude Code** | PM + разработка | Анализ, планирование, кодинг |

| **MD-файлы** | Архив анализа | 6 файлов с историей всех issues |

### CLI для Redmine

```bash

# Issues

node deploy/redmine-api.mjs list-issues novels

node deploy/redmine-api.mjs create-issue novels "Subject" "Description"

node deploy/redmine-api.mjs update-issue 123 status_id=5

# Wiki

node deploy/redmine-api.mjs list-wiki novels

node deploy/redmine-api.mjs get-wiki novels Requirements

node deploy/redmine-api.mjs put-wiki novels PageTitle "Content..."

```

---

## Принципы PM

1. **Transparency** — все решения документированы, заказчик видит полную картину

2. **Traceability** — каждое требование связано с issues, каждый issue — с кодом

3. **Системность** — каждая задача рассматривается в контексте всей системы

4. **Пакетность** — группировать связанные задачи для эффективной реализации

5. **Проактивность** — PM предлагает улучшения, а не только реагирует на запросы

---

*Последнее обновление: 2026-02-16*