Как перестать «дергать» разработчиков? Путеводитель PM-а по работе с кодом через Claude Code
Петля зависимости, которая убивает продуктивность
Представьте классическую ситуацию: клиент сообщает о странном поведении калькулятора цен. Разработка по уши в спринте, и вы не можете получить мгновенный ответ на вопрос: «Это баг или фича?». Вы ждете два дня, пока у инженера появится окно, создавая «петлю зависимости» (Dependency Loop).
Проблема глубже, чем просто ваше ожидание. Существует «скрытая стоимость» каждого такого уточнения. Любое прерывание инженера — это минимум 15 минут на переключение контекста. Пять «быстрых вопросов» в день — это более часа чистого времени разработки, потерянного впустую, плюс дни вашего простоя. Использование Claude Code позволяет разорвать этот цикл, сокращая время получения ответов с 2 дней до 10–20 минут. Теперь инженерная команда перестает быть вашим единственным интерфейсом для понимания продукта.
Инсайт №1. Вам не нужно уметь кодить, вам нужно уметь спрашивать
Главный миф, мешающий менеджерам продуктов, — убеждение, что для понимания реализации нужно учить синтаксис языков программирования. На самом деле вам нужен «переводчик», который трансформирует техническую реализацию в продуктовый язык. Claude Code берет на себя роль такого агента.
Альтернатива обучению коду — это прямые вопросы к кодовой базе через агента, который переводит реализацию на язык продукта. Вы по-прежнему будете делегировать сложные задачи инженерам, но первичный анализ теперь в вашей зоне автономии.
Инсайт №2. Архитектурная карта за 20 минут
Прежде чем приступать к расследованиям, важно построить ментальную карту проекта. Без этого каждый поиск будет начинаться с нуля. В Claude Code для этого предусмотрен «Plan mode» (режим планирования), который позволяет изучать код без риска внести в него изменения.
Запустите сессию в корне репозитория:
cd /path/to/your/repository
claude --permission-mode plan
Затем используйте конкретный промпт для обзора архитектуры:
Prompt: Architecture Overview
Explain this codebase’s architecture to a product manager. Cover: what the main components are, how data flows through the system, where user-facing features typically live, and how frontend and backend connect. Keep explanations non-technical, focusing on mental models.
Такая сессия занимает 5–10 минут и обходится примерно в 0.10–0.25. Результат станет вашим ориентиром: вы поймете, где живет логика скидок (backend services), а где — интерфейс корзины (frontend components).
Инсайт №3. Четыре универсальных паттерна для любого расследования
Большинство вопросов PM-а к коду укладываются в четыре паттерна. Используйте эти структуры запросов, чтобы закрыть 90% своих потребностей в информации:
1.How does X work? (Логика фичи). Выясните реальные бизнес-правила.
2.What data does X access? (Зависимости данных). Оцените риски приватности или доступность полей.
3.What happens when X? (Обработка крайних случаев/Edge Cases). Узнайте, что видит пользователь при сбоях.
4.Why does X occur? (Объяснение странного поведения). Разберитесь, баг это или техническое ограничение.
Инсайт №4: Чтение кода без чтения кода (визуализация логики)
Claude Code может выступать в роли интерпретатора, превращая сложные функции в понятные текстовые блок-схемы. Это позволяет увидеть «невидимые» для пользователя процессы.
Например, запросите визуализацию процесса оформления заказа (checkout): Create a text-based flowchart showing what happens when a user submits a checkout form.
Пример вывода Claude:
User submits checkout form
↓
Validate cart (items exist, prices current)
├─ Invalid → Return error to user
└─ Valid → Continue
↓
Process payment via Stripe API
├─ Payment fails → Log error, show user message, preserve cart
└─ Payment succeeds → Continue
↓
Create order in database
├─ DB error → Queue for manual reconciliation, notify team
└─ Success → Send confirmation email
Это «чертеж» вашего продукта, который позволяет сразу увидеть узкие места (например, что происходит, если платеж прошел, а запись в базу упала).
Инсайт №5. CLAUDE.md — ваша «институциональная память»
Чтобы Claude Code работал эффективнее, ему нужен контекст, который не всегда есть в комментариях. Для этого используется файл CLAUDE.md. Это «инструкция по эксплуатации» вашего продукта для ИИ.
Важно помнить, что Claude Code считывает эти файлы иерархически: сначала из вашей домашней директории (~/.claude/CLAUDE.md) для глобальных настроек, а затем из корня проекта для специфики продукта.
Что включить в CLAUDE.md для PM-а:
Это превращает Claude Code в «члена команды», который уже в курсе всех нюансов и не предлагает решений, идущих вразрез с архитектурой.
Петля зависимости, которая убивает продуктивность
Представьте классическую ситуацию: клиент сообщает о странном поведении калькулятора цен. Разработка по уши в спринте, и вы не можете получить мгновенный ответ на вопрос: «Это баг или фича?». Вы ждете два дня, пока у инженера появится окно, создавая «петлю зависимости» (Dependency Loop).
Проблема глубже, чем просто ваше ожидание. Существует «скрытая стоимость» каждого такого уточнения. Любое прерывание инженера — это минимум 15 минут на переключение контекста. Пять «быстрых вопросов» в день — это более часа чистого времени разработки, потерянного впустую, плюс дни вашего простоя. Использование Claude Code позволяет разорвать этот цикл, сокращая время получения ответов с 2 дней до 10–20 минут. Теперь инженерная команда перестает быть вашим единственным интерфейсом для понимания продукта.
Инсайт №1. Вам не нужно уметь кодить, вам нужно уметь спрашивать
Главный миф, мешающий менеджерам продуктов, — убеждение, что для понимания реализации нужно учить синтаксис языков программирования. На самом деле вам нужен «переводчик», который трансформирует техническую реализацию в продуктовый язык. Claude Code берет на себя роль такого агента.
Альтернатива обучению коду — это прямые вопросы к кодовой базе через агента, который переводит реализацию на язык продукта. Вы по-прежнему будете делегировать сложные задачи инженерам, но первичный анализ теперь в вашей зоне автономии.
Инсайт №2. Архитектурная карта за 20 минут
Прежде чем приступать к расследованиям, важно построить ментальную карту проекта. Без этого каждый поиск будет начинаться с нуля. В Claude Code для этого предусмотрен «Plan mode» (режим планирования), который позволяет изучать код без риска внести в него изменения.
Запустите сессию в корне репозитория:
cd /path/to/your/repository
claude --permission-mode plan
Затем используйте конкретный промпт для обзора архитектуры:
Prompt: Architecture Overview
Explain this codebase’s architecture to a product manager. Cover: what the main components are, how data flows through the system, where user-facing features typically live, and how frontend and backend connect. Keep explanations non-technical, focusing on mental models.
Такая сессия занимает 5–10 минут и обходится примерно в 0.10–0.25. Результат станет вашим ориентиром: вы поймете, где живет логика скидок (backend services), а где — интерфейс корзины (frontend components).
Инсайт №3. Четыре универсальных паттерна для любого расследования
Большинство вопросов PM-а к коду укладываются в четыре паттерна. Используйте эти структуры запросов, чтобы закрыть 90% своих потребностей в информации:
1.How does X work? (Логика фичи). Выясните реальные бизнес-правила.
- Промпт: «How does discount code validation work? What rules determine if a code can be applied? Explain in product terms.»
2.What data does X access? (Зависимости данных). Оцените риски приватности или доступность полей.
- Промпт: «What user data does the purchase history feature access? Which specific fields are read from the database?»
3.What happens when X? (Обработка крайних случаев/Edge Cases). Узнайте, что видит пользователь при сбоях.
- Промпт: «What happens when a payment fails during checkout? Walk me through the error messages and page state.»
4.Why does X occur? (Объяснение странного поведения). Разберитесь, баг это или техническое ограничение.
- Промпт: «Users report that the search filter resets when clicking 'Show More'. Why does this happen in the code? Is it intentional?»
Инсайт №4: Чтение кода без чтения кода (визуализация логики)
Claude Code может выступать в роли интерпретатора, превращая сложные функции в понятные текстовые блок-схемы. Это позволяет увидеть «невидимые» для пользователя процессы.
Например, запросите визуализацию процесса оформления заказа (checkout): Create a text-based flowchart showing what happens when a user submits a checkout form.
Пример вывода Claude:
User submits checkout form
↓
Validate cart (items exist, prices current)
├─ Invalid → Return error to user
└─ Valid → Continue
↓
Process payment via Stripe API
├─ Payment fails → Log error, show user message, preserve cart
└─ Payment succeeds → Continue
↓
Create order in database
├─ DB error → Queue for manual reconciliation, notify team
└─ Success → Send confirmation email
Это «чертеж» вашего продукта, который позволяет сразу увидеть узкие места (например, что происходит, если платеж прошел, а запись в базу упала).
Инсайт №5. CLAUDE.md — ваша «институциональная память»
Чтобы Claude Code работал эффективнее, ему нужен контекст, который не всегда есть в комментариях. Для этого используется файл CLAUDE.md. Это «инструкция по эксплуатации» вашего продукта для ИИ.
Важно помнить, что Claude Code считывает эти файлы иерархически: сначала из вашей домашней директории (~/.claude/CLAUDE.md) для глобальных настроек, а затем из корня проекта для специфики продукта.
Что включить в CLAUDE.md для PM-а:
- Глоссарий. Что такое «активация» или «workspace» в вашем конкретном случае.
- Карта путей (User Journeys). Связка «Signup Flow -> src/auth/signup.js».
- Конвенции. Например, «Pricing logic lives exclusively in backend services».
Это превращает Claude Code в «члена команды», который уже в курсе всех нюансов и не предлагает решений, идущих вразрез с архитектурой.
Инсайт №6. Где проходит «красная линия» эскалации
Главное ограничение, которое нужно осознать: Claude Code делает статический анализ (Static Analysis). Он видит «рецепт» (код), но не видит «готовое блюдо» в процессе (Runtime). Он не знает реальных значений в вашей базе данных или того, какая конфигурация сейчас активна на продакшене.
Используйте это правило (Pattern): Вопросы по структуре → Claude Code. Вопросы по качеству/производительности/продакшену → Engineering.
Главное ограничение, которое нужно осознать: Claude Code делает статический анализ (Static Analysis). Он видит «рецепт» (код), но не видит «готовое блюдо» в процессе (Runtime). Он не знает реальных значений в вашей базе данных или того, какая конфигурация сейчас активна на продакшене.
Используйте это правило (Pattern): Вопросы по структуре → Claude Code. Вопросы по качеству/производительности/продакшену → Engineering.
Относитесь к Claude Code как к «младшему инженеру без опыта работы в продакшене». Он отлично читает код, но не имеет интуиции и доступа к живой среде.
Заключение. От зависимости к автономии
Доступ к коду для PM-а — это не про написание строк, а про глубокое понимание реальности продукта. Когда вы самостоятельно проводите первый этап расследования, вы не просто экономите время — вы приходите к разработчикам не с вопросом «как это работает?», а с конкретным контекстом: «Я вижу, что в discount-validator.js:92 стоит ограничение на комбинацию кодов. Почему мы выбрали именно такую логику?».
Финальный вопрос. Сколько времени ваша команда сэкономила бы за следующий квартал, если бы вы могли отвечать на 90% технических вопросов самостоятельно за 15 минут?
Заключение. От зависимости к автономии
Доступ к коду для PM-а — это не про написание строк, а про глубокое понимание реальности продукта. Когда вы самостоятельно проводите первый этап расследования, вы не просто экономите время — вы приходите к разработчикам не с вопросом «как это работает?», а с конкретным контекстом: «Я вижу, что в discount-validator.js:92 стоит ограничение на комбинацию кодов. Почему мы выбрали именно такую логику?».
Финальный вопрос. Сколько времени ваша команда сэкономила бы за следующий квартал, если бы вы могли отвечать на 90% технических вопросов самостоятельно за 15 минут?
