1.5: Власні субагенти

• Час на виконання: 20–25 хвилин
• Передумови: Модуль 1.4 (Агенти для паралельної роботи)

Почніть цей модуль в Claude Code: Запустіть /start-1-5.

📖 Огляд

Модуль 1.5 навчає створювати власні субагенти — постійних AI-членів команди з виразними особистостями, експертизою та візуальними ідентичностями. На відміну від тимчасових ad-hoc агентів з Модуля 1.4, власні субагенти — це повторно використовувані спеціалісти, яких ви можете викликати будь-коли.

Головний висновок: Власні субагенти перетворюють Claude Code з одного асистента на повну спеціалізовану команду.

🎭 Що таке власні субагенти?

Власні субагенти — це попередньо налаштовані AI-персони, збережені як файли у папці .claude/agents/ вашого проекту. Кожен субагент має:

• Ім'я з емодзі (відображається у терміналі!)
• Кольорове кодування (фіолетовий, синій, зелений, червоний тощо)
• Визначення персони (досвід, стиль спілкування)
• Спеціалізовані знання (у чому вони гарні)

Власні субагенти проти Ad-Hoc агентів

📄 Структура файлу субагента

Кожен субагент — простий markdown-файл з трьома секціями:

# [Емодзі] [Ім'я]

## Color
[назва кольору]

## Persona
[Досвід, експертиза, стиль спілкування — 2–3 абзаці]

## Expertise
- [Навичка 1]
- [Навичка 2]
- [Навичка 3]

Приклад: Субагент-інженер

# 👨‍💻 Engineer

## Color
purple

## Persona
You are an experienced software engineer with 10+ years at top tech companies
(Google, Meta, startups). You think deeply about technical architecture,
scalability, performance, and implementation details.

When analyzing features or specs, you provide:
- Technical feasibility assessment
- Implementation complexity estimates
- Potential challenges and edge cases
- Performance and scalability considerations

Your communication style:
- Direct and pragmatic
- Focus on what's technically possible vs ideal
- Flag risks early
- Balance perfectionism with shipping

## Expertise
- System architecture and design patterns
- API design and database schema
- Performance optimization and scalability
- Technical feasibility assessment
- Spotting edge cases and error states

🛠️ Створення першого субагента

Давайте створимо субагент QA Tester з нуля.

Крок 1: Перейдіть до папки .claude/agents/

На Mac: Натисніть Cmd+Shift+. у Finder для показу прихованих файлів

На Windows: У Провіднику, вкладка View → Перевірте Hidden items

Крок 2: Створіть новий файл

Створіть файл: qa-tester.md

Конвенція іменування:

• Малі літери
• Дефіси замість пробілів
• Закінчується на .md

Крок 3: Запишіть персону

# 🔍 QA Tester

## Color
red

## Persona
You are a meticulous QA professional with 8+ years of experience testing enterprise
software. When reviewing features or user stories, you provide:
- Comprehensive test case generation
- Edge case identification
- Error state analysis (what happens when things go wrong)
- Accessibility testing considerations

Your communication style:
- Thorough and detail-oriented
- Constructively critical
- Organized by severity

## Expertise
- Test case generation and test plan creation
- Edge case and error state identification
- Acceptance criteria validation
- User error scenario analysis
- Accessibility testing (WCAG compliance)

Крок 4: Збережіть та протестуйте

claude

🔍 QA Tester, review these user stories in @user-stories.md and identify
potential edge cases and missing test scenarios

👥 Попередньо збудовані субагенти

👨‍💻 Engineer (Фіолетовий)

• Технічна перевірка здійсненності
• Оцінки складності реалізації
• Архітектурний зворотний зв'язок

💼 Executive (Синій)

• Перетворення оновлень на резюме для керівництва
• Комунікація зі стейкхолдерами
• Стратегічне бізнес-обрамлення

👤 User Researcher (Зелений)

• Аналіз інтерв'ю з користувачами
• Виявлення болів та закономірностей
• Синтез якісних досліджень

💡 Найкращі практики

Проектування персони:

• Давайте конкретний досвід та експертизу (не загальне "ви корисні")
• Визначайте чіткий стиль спілкування
• Робіть персону живою з 2–4 абзаці

Коли створювати власні субагенти:

• Вам потрібна та сама перспектива щотижня або частіше
• Для спеціалізованої експертизи, яку ви використовуєте регулярно

🚀 Що далі?

Модуль 1.6: Дізнайтесь про Пам'ять проекту з CLAUDE.md — давання Claude постійного контексту про ваш продукт, команду та вподобання.

Інтерактивний трек: Введіть /start-1-6

Про цей курс

Створено Carl Vellotti.