Technology — курс по технології в проекті

Аргумент (опціонально): назва технології. Стан курсу: .practicum/course-<tech>.md — окремий файл на кожну технологію, формат як у how-to; <tech> — латиницею в нижньому регістрі.

Вибір режиму

1. Без аргументу → «Інвентаризація».
2. З аргументом визнач, чи технологія реально використовується: файли залежностей (pyproject.toml, requirements*.txt, package.json, go.mod, ...), імпорти в коді, конфіги, docker-compose. Використовується → «Технологія є», ні → «Технології нема».
3. Назва неоднозначна (сервіс чи клієнтська бібліотека, кілька збігів) — перепитай користувача, не вгадуй.

Інвентаризація (без аргументу)

• Просканируй залежності, docker-compose, конфіги, ключові імпорти.
• Покажи список у чаті: технологія + один рядок «що це і де воно у нас» + позначка, чи вже є курс .practicum/course-<tech>.md.
• Зупинись: файлів не пиши, користувач сам викличе /vibe-typing:technology <обрана>.

Технологія є

Дій за ../how-to/SKILL.md (прочитай його), з відмінностями:

• Стан: .practicum/course-<tech>.md — усі згадки course.md у how-to читай як course-<tech>.md.
• Скоуп: ТІЛЬКИ точки дотику технології: залежність → конфіг/env → ініціалізація (клієнт/двигун/підключення) → перше використання → решта патернів (кеш, локи, черги, ... — кожен своїм уроком/етапом).
• План еволюційний: «як би ми додавали цю технологію з нуля».
• Орієнтир 3–10 уроків. Використання тривіальне (1–2 рядки) → чесно попередь, що курс буде закоротким, і спитай, чи продовжувати.
• Ім'я уроків: tech-<tech>-NN-<slug>.html.

Технології нема — інтеграційний курс

Вчитись можна лише на коді, що точно працює: інтеграція реальна, в окремій гілці, з перевіркою.

1. Побудуй план інтеграції: мінімальне робоче ядро технології в ЦЬОМУ проекті — залежність → конфіг → ініціалізація → 1–2 реальні точки використання. НЕ «обвішуй усе». Список файлів, спосіб перевірки.
2. ЯВНО ЗАСТЕРЕЖИ і ДОЧЕКАЙСЯ згоди. Користувач має чітко розуміти, що станеться: це НЕ просто генерація уроку, а повноцінна реалізація — буде створено гілку і написано реальний код; це може бути тривалим і витратити багато токенів. Без явного «так» — стоп.
3. Робоче дерево брудне → зупинись: попроси закомітити або стешнути.
4. Гілка vibe-typing/<tech> від HEAD. Реалізуй: код → самостійне рев'ю → тести проекту → smoke-перевірка. У звіті чесно: що перевірено, що ні.
5. Закоміть у гілці й повернись на вихідну (git checkout -). Далі робоче дерево користувача не чіпай.
6. Запиши .practicum/course-<tech>.md з позначкою «інтеграційний курс, гілка vibe-typing/<tech>, база <вихідна гілка>». Уроки генеруй з diff <вихідна>..vibe-typing/<tech>; актуальний код фрагментів бери З ГІЛКИ (git show vibe-typing/<tech>:шлях), еволюційними етапами.
7. Після останнього уроку запропонуй вибір: змерджити гілку (код готовий) або видалити її і внести зміни руками за уроками (максимум навчання).

Спільне

• Урок — за ../practicum/lesson-format.md (прочитай його), включно з полем tree і правилом точних шляхів у рядках course-<tech>.md.
• Відмічай уроки [x] у course-<tech>.md, як у how-to.