# 01 — Введение в AI

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

## Цель

Понять **базовые понятия** агентного ИИ в разработке: чем отличается чат-ассистент от агента, как устроен Cursor, зачем нужна экосистема ECC.

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

- [00 — Карта пути](../00-karta-puti/README.md) (личный план)
- Установленный Cursor IDE
- 30–60 минут без отвлечений

## Время

**6–10 часов** на весь раздел (чтение + первая практика в Cursor)

---

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

| Страница | Тема |
|----------|------|
| [AI-ассистент и агент](ai-assistent-i-agent.md) | Режимы Cursor, инструменты, ответственность |
| [Ментальные модели](mentalnye-modeli.md) | Как думать о AI, чтобы не разочароваться |

---

## Что такое «AI в IDE» простыми словами

**Языковая модель (LLM)** — программа, обученная предсказывать следующее слово в тексте. На огромных объёмах кода и документации она научилась **понимать** запросы разработчика и **генерировать** код, объяснения, тесты.

**Cursor** — это форк VS Code со встроенной моделью. Вы пишете код как обычно, но можете:

- спросить объяснение выделенного фрагмента (**Chat**);
- попросить дописать функцию (**Tab** / autocomplete);
- поручить многошаговую задачу (**Agent / Composer**): «добавь endpoint, тесты и обнови README».

Ключевое отличие от ChatGPT в браузере: Cursor **видит ваш проект** (файлы, которые вы открыли или упомянули через `@`) и может **запускать команды** в терминале (с вашего разрешения).

---

## Зачем курс, если «и так всё работает»

Без системы легко попасть в ловушки:

| Проблема | Причина | Решение в курсе |
|----------|---------|-----------------|
| Агент «ломает» проект | Слишком широкий промпт | Раздел 03, rules |
| Тратите много денег на API | Огромный контекст | Раздел 02 |
| Одинаковые ошибки в каждой сессии | Нет правил | Раздел 04 |
| Хаотичные workflow | Нет skills | Раздел 05 |
| Долгие задачи «зависают» | Нет декомпозиции и субагентов | Раздел 06 |

Курс учит **управлять** AI, а не только «спрашивать красиво».

---

## ECC в одном абзаце

**Everything Claude Code (ECC)** — open-source каталог готовых **rules**, **skills**, **agents**, **hooks** и конфигураций MCP. Автор и сообщество отточили их на реальных продуктах. Вы можете:

- установить весь набор или выборочно (`configure-ecc`);
- переиспользовать `tdd-workflow`, `code-reviewer`, `django-patterns` и сотни других;
- дополнять своими навыками в `.cursor/skills/`.

ECC не заменяет Cursor — он **усиливает** агента постоянными инструкциями и проверенными сценариями.

---

## Три столпа эффективной работы

```mermaid
flowchart TB
  P[Промпт — что сделать сейчас]
  R[Rules — как всегда делать]
  S[Skills — пошаговый рецепт]
  P --> A[Агент Cursor]
  R --> A
  S --> A
  A --> O[Результат в репозитории]
```

- **Промпт** — разовая задача («добавь валидацию email в форму регистрации»).
- **Rules** — «всегда пиши immutable updates», «не коммить без запроса».
- **Skills** — «при новой фиче следуй TDD: тест → код → рефакторинг».

---

## Первая практика (5 минут)

1. Откройте Cursor и любой небольшой репозиторий.
2. `Cmd+L` (Mac) / `Ctrl+L` — откройте **Chat**.
3. Спросите: «Объясни структуру этого репозитория в 5 пунктах».
4. `Cmd+I` — откройте **Agent** (Composer).
5. Попросите: «Найди файл README и предложи одно улучшение формулировки» — **не применяйте**, только посмотрите diff.

Зафиксируйте ощущение: Chat **говорит**, Agent **действует**.

---

## Типичные заблуждения

| Заблуждение | Реальность |
|-------------|------------|
| «AI всегда прав» | Модель галлюцинирует; нужна проверка и тесты |
| «Чем длиннее промпт, тем лучше» | Важны структура и релевантный контекст, не объём |
| «Agent заменит меня» | Вы остаётесь архитектором, ревьюером и ответственным |
| «ECC только для Claude Code» | ECC поддерживает Cursor, Codex, OpenCode и др. |

---

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

1. Назовите три режима Cursor: Chat, Tab, Agent.
2. Чем rules отличаются от одноразового промпта?
3. Для чего нужен ECC, если Cursor уже «умный»?
4. Почему для обучения нужен репозиторий без секретов?

## Дальше

→ [AI-ассистент и агент](ai-assistent-i-agent.md) · [Ментальные модели](mentalnye-modeli.md) · [02 — Эффективное использование](../02-effektivnoe-ispolzovanie/README.md)