Влад Квітко
📘 Версія 1.0 • Січень 2026

🤖 Методологія роботи з AI-агентом

Гайд для продуктових менеджерів та непрофесійних розробників: як ефективно використовувати AI для створення працюючих прототипів

← Назад до моделі

1. Вступ

Цей гайд для продуктових менеджерів та непрофесійних розробників, які використовують AI (Claude, GPT) для створення працюючих прототипів та MVP.

💡 AI — потужний інструмент, але якість результату залежить від якості завдання.

2. Принципи комунікації

Золоті правила

  • Контекст — це все. Завжди вказуйте проект, стек, поточний стан.
  • Явне краще за неявне. Вказуйте технології, структуру файлів, обмеження.
  • Приклади — найкраще пояснення. Покажіть очікуваний формат результату.
  • Розбивайте великі задачі. "Спочатку БД" → "Потім авторизацію" → "Далі модуль X"
// ❌ Погано: "Зроби форму реєстрації"

// ✅ Добре: "Контекст: SaaS для малого бізнесу, PHP/MySQL Завдання: Форма реєстрації (email, password, company) Вимоги: валідація, хешування, редирект на /dashboard"

Шаблон запиту

КОНТЕКСТ: Проект: [назва та опис] Стек: [технології] Стан: [що вже є] ЗАВДАННЯ: [Що потрібно зробити] ОБМЕЖЕННЯ: [Що враховувати] ФОРМАТ: [Які файли створити]

3. Архітектурні патерни

Ізоляція проекту

/var/www/
├── project_a/ # Окрема папка
│ ├── .env # Окремий конфіг
│ └── ...
└── project_b/ # Інший проект

Правила: Кожен проект у своїй папці, окрема база даних, окремий .env

Малі файли > Великі

❌ MainController.php — 2000 рядків ✅ AuthController.php — 150 рядків PlanController.php — 200 рядків CreditController.php — 100 рядків

Правило: 1 файл = 1 відповідальність, максимум 300 рядків

Модульна структура

app/
├── Core/ # Ядро системи
├── Controllers/ # Обробка запитів
├── Models/ # Робота з БД
├── Services/ # Бізнес-логіка
├── Middleware/ # Auth, logging
└── Helpers/ # Утиліти

4. Структура ТЗ

Обов'язкові елементи

  1. Ізоляція — окрема папка + БД
  2. Структура файлів — дерево з поясненнями
  3. Схема БД — SQL з типами та зв'язками
  4. Логування — що, куди, як вмикати
  5. Малі файли — легше дебагити
  6. Коментарі — українською

5. Дебагінг

Повідомлення про баг

ПРОБЛЕМА: [Що не працює] КРОКИ: 1. [Як відтворити] ОЧІКУВАННЯ: [Як має бути] РЕАЛЬНІСТЬ: [Що відбувається] ЛОГИ: [Помилки з error.log] ФАЙЛИ: [Які можуть бути причиною]

Стратегія виправлення

  1. Відтворити проблему
  2. Перевірити логи
  3. Локалізувати файл/функцію
  4. Виправити мінімально
  5. Протестувати
  6. Задокументувати

6. Чек-листи

📋 Перед новим проектом

  • Мета визначена
  • Стек вибраний
  • БД спроектована
  • Структура файлів готова
  • План етапів є

📋 Перед запитом до AI

  • Контекст вказано
  • Завдання чітке
  • Обмеження описані
  • Формат визначений

📋 При помилці

  • Текст помилки записаний
  • Логи перевірені
  • Файл визначений
  • Контекст зібраний

7. Поради від AI

✅ РОБІТЬ

  • Будьте конкретними
  • Давайте контекст
  • Використовуйте приклади
  • Розбивайте великі задачі
  • Перевіряйте код
  • Зберігайте успішні промпти

❌ НЕ РОБІТЬ

  • Не припускайте
  • Не просіть "все одразу"
  • Не ігноруйте помилки
  • Не копіюйте без розуміння
  • Не забувайте про безпеку

8. Висновок

🎯 AI — це інструмент, що підсилює ваші можливості, але не замінює ваше мислення та прийняття рішень.

Ключі до успіху:

  1. Чіткі завдання
  2. Контекст завжди
  3. Малі кроки
  4. Перевірка результатів
  5. Документування рішень

Успішного прототипування! 🚀