0.4: Агенты и память проекта


Время	20 мин
Уровень	Средний
Команда	`/start-0-4`

Ключевое: Claude Code — это не один ассистент. Это целая команда. Ты можешь запускать несколько агентов параллельно, создавать специализированных помощников, и настраивать память проекта, чтобы Claude всегда понимал контекст.

Почему это важно

Представь, что ты — CEO стартапа. У тебя нет команды, но тебе нужны:

Аналитик — чтобы исследовать рынок
Продакт-менеджер — чтобы описать продукт
Дизайнер — чтобы создать визуалы
Маркетолог — чтобы написать контент

С Claude Code ты можешь создать каждого из них как отдельного агента. Они работают параллельно, у каждого своя специализация, и все они — часть твоей AI-команды.

Агенты: параллельные AI-воркфлоу

Что такое агент

Агент — это отдельный экземпляр Claude, который выполняет конкретную задачу. Пока основной Claude помогает тебе, агент может параллельно:

Анализировать документы
Исследовать конкурентов
Генерировать контент
Проверять код

Как запускать агентов

В Claude Code агенты запускаются автоматически, когда Claude решает, что задачу лучше разделить. Но ты можешь и напрямую попросить:

Запусти параллельно два агента:
1. Первый пусть проанализирует market-brief.md
2. Второй пусть найдёт слабые места в competitive-analysis.md

Claude создаст два агента, каждый сфокусируется на своей задаче, и вернёт результаты.

Мульти-перспективный фидбэк

Одна из самых мощных техник — попросить несколько агентов оценить одну и ту же вещь с разных точек зрения:

Оцени мой PRD из prd.md с трёх перспектив:
1. Как инвестор — стоит ли вкладывать?
2. Как пользователь — стал бы я этим пользоваться?
3. Как инженер — реально ли это построить за 2 недели?

Ты получишь три разных мнения, каждое со своими аргументами. Это как иметь advisory board без advisory board.

Кастомные суб-агенты

Что это

Суб-агент — это агент с предзаданной ролью и характером. В курсе доступны три:

Агент	Файл	Роль
Investor	`.claude/agents/investor.md`	Смотрит на проект глазами VC-инвестора
Founder Coach	`.claude/agents/founder-coach.md`	Персональный наставник, помогает с решениями
Tech Advisor	`.claude/agents/tech-advisor.md`	Консультирует по технической архитектуре

Как они работают

Каждый суб-агент — это markdown-файл с описанием роли, стиля общения и экспертизы. Когда ты вызываешь агента, Claude читает этот файл и «становится» этим персонажем.

Пример: спросить Investor о своём продукте

@.claude/agents/investor.md

Оцени SupportAI как инвестиционную возможность.
Какие red flags? Какие вопросы ты бы задал на pitch?

Investor ответит как настоящий VC: с фокусом на unit economics, рынок, команду и масштабируемость.

Создание своих агентов

Ты можешь создать любого агента. Просто создай markdown-файл с описанием роли:

# Агент: Клиент

## Роль
Ты — потенциальный клиент SupportAI. Средний бизнес, 50 сотрудников,
уставший от плохой клиентской поддержки.

## Стиль
Скептичный, но заинтересованный. Задаёшь острые вопросы.
Тебя волнует цена, интеграция с существующими системами, и надёжность.

## Экспертиза
Знаешь как работает Zendesk, Intercom. Пробовал чат-боты, но они
не справлялись. Ищешь решение, которое реально работает.

Сохрани в .claude/agents/customer.md — и теперь можешь «поговорить» со своим клиентом.

Память проекта: CLAUDE.md

Проблема

Обычные чат-боты забывают всё после закрытия окна. Каждый раз нужно объяснять заново: кто ты, что строишь, какой стек.

Решение: CLAUDE.md

CLAUDE.md — это файл в корне проекта, который Claude Code читает автоматически при каждом запуске. Это его «память». Всё, что ты туда запишешь, Claude будет знать всегда.

Что писать в CLAUDE.md:

# SupportAI — Проект

## О продукте
AI-чат-бот для автоматизации клиентской поддержки.
Целевая аудитория: средний бизнес, 20-200 сотрудников.

## Технический стек
- Frontend: Next.js + Tailwind CSS
- Backend: Supabase
- AI: Claude API

## Стиль кода
- TypeScript строгий
- Tailwind для стилей
- Комментарии на русском

## Текущий статус
MVP готов, тестируем с 5 клиентами.
Фокус: конверсия free → paid.

Теперь Claude знает контекст до того, как ты что-то спросишь. Не нужно каждый раз объяснять, что такое SupportAI.

CLAUDE.md в курсе

В папке course-materials/ уже есть CLAUDE.md с контекстом курса. Он рассказывает Claude, что это обучение, какие уроки есть, и как себя вести (как учитель, а не как чат-бот).

@-упоминания файлов

Как работает

Когда ты пишешь @filename в запросе к Claude, он автоматически читает этот файл и учитывает его содержимое. Это как прикрепить документ к письму.

Примеры:

Проанализируй @market-brief.md и найди 3 главных инсайта

На основе @customer-research-synthesis.md и @competitive-analysis.md
предложи позиционирование продукта

Обнови @prd.md — добавь фичу экспорта данных

Зачем это нужно

Без @: Claude может не знать, о каком файле речь, или прочитать не тот.

С @: Claude гарантированно читает нужный файл и работает с его содержимым. Это делает ответы точнее и конкретнее.

Несколько файлов

Можно упоминать сколько угодно файлов:

Сравни подходы в @market-brief.md и @competitive-analysis.md.
Есть ли противоречия?

Claude прочитает оба файла и проведёт сравнительный анализ.

Практика в курсе

Все эти техники ты будешь использовать на протяжении курса:

Модуль	Что используешь
1: AI Toolkit	@-упоминания файлов исследований, мульти-перспективный фидбэк
2: Vibe Coding	CLAUDE.md как контекст проекта, агенты для code review
3: Nano Banana	Суб-агенты для оценки дизайна, шаблоны как @-файлы

Лучшие практики

CLAUDE.md обновляй регулярно — добавляй решения, статус проекта, изменения в стратегии
@-упоминания > копирование текста — Claude лучше работает с файлами, чем с вставленным текстом
Суб-агенты для сложных решений — когда нужно несколько точек зрения
Называй файлы понятно — market-brief.md лучше, чем doc1.md