# 03 — Промпты

← [Главная](../README.md)

## Цель

Научиться **писать промпты**, которые агент выполняет с первого-второго раза: структура, техники, готовые шаблоны и типичные ошибки.

## Предварительно

- [02 — Эффективное использование](../02-effektivnoe-ispolzovanie/README.md)
- Практика с `@`-упоминаниями

## Время

**12–18 часов** на весь раздел (с упражнениями)

---

## Оглавление раздела

| Страница | Тема |
|----------|------|
| [Структура промпта](struktura-promta.md) | Блоки: цель, контекст, ограничения, формат |
| [Техники промптинга](tehniki-promtinga.md) | CoT, few-shot, декомпозиция, роли |
| [Шаблоны промптов](shablony-promtov.md) | Copy-paste заготовки под типовые задачи |
| [Антипаттерны](anti-patterny.md) | Что ломает результат |

---

## Промпт в экосистеме Cursor + ECC

Промпт — **разовая** инструкция. Он работает вместе с:

| Слой | Длительность | Пример |
|------|--------------|--------|
| Промпт | Одна задача | «Добавь rate limit на /api/login» |
| Rules | Всегда | «Параметризованные SQL» |
| Skills | При триггере | `fastapi-patterns` при новом endpoint |

Не дублируйте в промпте то, что уже в rules — трата токенов.

---

## Минимальный жизнеспособный промпт

```markdown
Цель: [одно предложение]

Контекст: @файлы

Ограничения: [стек, стиль, не трогать]

Готово когда: [тест, метрика, артефакт]
```

Если есть только «Цель» — вы на удачу.

---

## Уровни сложности промптов

| Уровень | Когда | Пример |
|---------|-------|--------|
| L1 — вопрос | Chat, обучение | «Объясни middleware в Express» |
| L2 — задача | Один файл | «Добавь JSDoc к export в utils.ts» |
| L3 — фича | Несколько файлов + тесты | «CRUD для Tag с тестами» |
| L4 — эпик | Декомпозиция, субагенты | «Миграция auth на OAuth2» |

Для L4 сначала [Plan mode](../06-agents/vybor-modeli-i-rezhimov.md) или субагент `planner`.

---

## Язык промпта

- Русский и английский обычно работают; **термины кода** часто лучше на английском (`middleware`, `handler`).
- Имена файлов, символов, API — **как в репозитории**, без перевода.
- Требование «ответ на русском» — явно в блоке **Формат**.

---

## Практика раздела

1. Перепишите свой старый «плохой» промпт по [структуре](struktura-promta.md).
2. Примените две [техники](tehniki-promtinga.md) на одной задаче.
3. Возьмите [шаблон](shablony-promtov.md) для bugfix.
4. Найдите в своей практике два [антипаттерна](anti-patterny.md).

---

## Связь с итерациями

Первый промпт редко идеален. Планируйте **2–4 итерации** в [feedback-цикле](../02-effektivnoe-ispolzovanie/iteracii-i-feedback.md) — это норма, не провал.

---

## Самопроверка

1. Какие четыре блока есть в «минимальном жизнеспособном промпте»?
2. Чем L3 отличается от L4?
3. Почему не стоит дублировать rules в промпте?
4. Какой шаблон вы возьмёте для рефакторинга?

## Дальше

→ [Структура промпта](struktura-promta.md)