Example mapping

.cursor/skills/user-story/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: user-story
+description: Создает и оформляет пользовательские истории в формате "Как... Я хочу... Чтобы...". Используется при работе с пользовательскими историями, требованиями, user stories, или когда нужно структурировать функциональность с точки зрения пользователя.
+---
+
+# Пользовательские истории
+
+## Формат
+
+Пользовательские истории оформляются в следующем формате:
+
+```markdown
+## История [номер]: [Название]
+
+**Как** [роль пользователя]  
+**Я хочу** [действие или функциональность]  
+**Чтобы** [цель или ценность]
+```
+
+## Структура
+
+### Роль (Как)
+- Указывает, кто является пользователем функциональности
+- Примеры: владелец котика, администратор, пользователь системы
+
+### Действие (Я хочу)
+- Описывает конкретное действие или функциональность
+- Должно быть конкретным и измеримым
+- Избегать абстрактных формулировок
+
+### Цель (Чтобы)
+- Объясняет зачем нужна эта функциональность
+- Показывает ценность для пользователя
+- Связывает действие с бизнес-целью
+
+## Примеры
+
+**Пример 1:**
+```markdown
+## История 1: Напоминание о предстоящей прививке
+
+**Как** владелец котика  
+**Я хочу** получать напоминание о дате следующей прививки за 2 недели  
+**Чтобы** не пропустить важную дату и подготовиться к визиту в ветеринарную клинику
+```
+
+**Пример 2:**
+```markdown
+## История 2: Настройка параметров напоминаний
+
+**Как** владелец котика  
+**Я хочу** выбрать за сколько времени до прививки получать напоминание и сколько напоминаний получать  
+**Чтобы** настроить удобный для себя график уведомлений
+```
+
+## Принципы
+
+1. **Одна история = одна функциональность**
+2. **Фокус на пользователе**, а не на технических деталях
+3. **Измеримость**: должно быть понятно, когда история выполнена
+4. **Ценность**: каждая история должна приносить пользу пользователю
+
+## Оформление файла
+
+При создании файла с пользовательскими историями:
+
+1. Используйте заголовок `# Пользовательские истории`
+2. Разделяйте истории горизонтальной линией `---`
+3. Нумеруйте истории последовательно
+4. Давайте каждой истории понятное название
+

.cursor/skills/user-story/example-mapping.md

@@ -0,0 +1,82 @@
+name: example-mapping
+description: Разбивает пользовательские истории на Example Mapping: правила, примеры и вопросы. Используется для уточнения требований и подготовки к разработке.
+
+# Example Mapping
+
+Используется для детализации пользовательских историй через:
+- Правила (Rules)
+- Примеры (Examples)
+- Вопросы (Questions)
+
+---
+
+## Формат
+
+Для каждой пользовательской истории используй структуру:
+
+## История [номер]: [Название]
+
+### 🟩 Правила (Rules)
+Краткие утверждения, описывающие поведение системы
+
+- Правило 1
+- Правило 2
+
+---
+
+### 🟦 Примеры (Examples)
+Конкретные сценарии (input → output)
+
+- Пример 1:
+  Дано: ...
+  Когда: ...
+  Тогда: ...
+
+- Пример 2:
+  Дано: ...
+  Когда: ...
+  Тогда: ...
+
+---
+
+### 🟥 Вопросы (Questions)
+Неясности, пробелы, спорные моменты
+
+- Вопрос 1
+- Вопрос 2
+
+---
+
+## Принципы
+
+### Правила
+- Описывают поведение системы
+- Короткие и однозначные
+- Без технической реализации
+
+### Примеры
+- Проверяют правила
+- Конкретные и проверяемые
+- Желательно в формате Given/When/Then
+
+### Вопросы
+- Фиксируют неопределённости
+- Помогают выявить недостающие требования
+
+---
+
+## Важно
+
+- Не придумывай лишнюю функциональность
+- Основывайся только на пользовательской истории
+- Если информации мало — добавляй вопросы
+- Каждое правило должно иметь хотя бы один пример
+
+---
+
+## Оформление файла
+
+- Используй заголовок: # Example Mapping
+- Разделяй истории через ---
+- Сохраняй нумерацию историй
+

.github/workflows/python-app.yml

@@ -24,7 +24,7 @@ jobs:
         python -m pip install --upgrade pip
         pip install flake8 pytest markdown2
         if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-        cd Unit\ 5.\ CICD
+        cd "Unit_5_Autotests_and_Test_Driven_Development"
         rm -rf ./build
         mkdir ./build
         markdown2 Kolobok.md > ./build/Kolobok.html
@@ -36,5 +36,5 @@ jobs:
         flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
     - name: Test with pytest
       run: |
-        cd Unit\ 4.\ Autotests && make test && cd ..
-        cd Unit\ 5.\ CICD && make test && cd ..
+        cd "Unit_5_Autotests_and_Test_Driven_Development" && make test && cd ..
+        cd "Unit_6_Continuous_Integration_and_Continuous_Deployment" && make test && cd ..

.gitignore

@@ -128,4 +128,8 @@ dmypy.json
 # Pyre type checker
 .pyre/
 
-*.pdf
+*.pdf
+.DS_Store
+
+# Unit 7 AI docs
+Unit_7_AI/docs/

README.md

@@ -1,7 +1,7 @@
 # Technical Excellence 101
-Курс про техническое совершенство для нетехнарей (скрам мастеров, владельцев продукта, бизнес аналитиков и т.д.).
+Курс про техническое совершенство для нетехнарей (скрам мастеров, владельцев продукта, бизнес аналитиков, QA и т.д.).
 
-Этот курс представлят из себя серию воркшопов, при помощи которых можно объяснить смысл основных инженерных практик даже тем, кто в жизни не написал ни одной строчки кода. Это могут быть владельцы продукта, бизнес эксперты, скрам-мастера и любые другие участники команды, которые хотят лучше понимать что такое техническое совершенство и почему ему так много внимания уделяют разработчики. Код — это текст, поэтому мы будем объяснять материал на примере обыкновенного текста. Для прохождения курса не требуется никаких специальных знаний, кроме владения текстовым редактором.
+Этот курс представляет из себя серию воркшопов, при помощи которых можно объяснить смысл основных инженерных практик даже тем, кто в жизни не написал ни одной строчки кода. Это могут быть владельцы продукта, бизнес эксперты, скрам-мастера и любые другие участники команды, которые хотят лучше понимать что такое техническое совершенство и почему ему так много внимания уделяют разработчики. Код — это текст, поэтому мы будем объяснять материал на примере обыкновенного текста. Для прохождения курса не требуется никаких специальных знаний, кроме владения текстовым редактором.
 
 Во время курса вы почувствуете себя разработчиком, столкнетесь с препятствиями, с которыми сталкивается каждый разработчик и поймете как инженерные практики помогают преодолеть эти препятствия.
 
@@ -18,72 +18,64 @@
 * Парное программирование
 * Continuous Integration (непрерывная интеграция)
 * Continuous Delivery (непрерывная поставка)
+* AI инструменты
 
 ## Подготовка
-1. Установите [Visual Studio Code](https://code.visualstudio.com/download) (aka VS Code)
-2. Установите [git](https://git-scm.com/downloads)
-3. Проверьте, что git работает
-    * Откройте Terminal в MacOS или Git Bash в Windows (в дальнейшем, если не узказано иное, команды выполняются в Terminal в MacOS и в Git Bash в Windows)
-    * Выполните команду `git --version`
-    * Если вы увидели вывод `git version ...`, значит все в порядке, git установлен.
-4. Создайте папку, в которой вы будете работать, например `Projects`  
-      ```
-      cd ~
-      mkdir Projects
-      cd Projects
-      ```  
-5. Склонируйте репозиторий, выполнив команду   
-`git clone https://github.com/bevzuk/technical-excellence-101.git`
-6. Откройте локальный репозиторий в VS Code
-    * Запустите VS Code
-    * Откройте папку Projects/technical-excellence-101
-      * Меню File -> Open Folder ... или 
-      * Open ... на главном экране
-      * Выберите папку Projects/technical-excellence-101
-      * Нажмите Open или Select Folder
-        ![](images/Open%20folder.png)
-    * В левой панельке Explorer вы должны увидеть структуру проекта
-      ![](images/Project%20structure.png)
-
+1. Установите VS Code https://code.visualstudio.com
+2. Установите Git https://git-scm.com/downloads (Инструкция тут, хотя в целом там должно быть интуитивно https://git-scm.com/book/ru/v2/Введение-Установка-Git)
+3. Проверьте, что git работает \
+  3.1. Откройте Terminal в MacOS или Git Bash в Windows (в дальнейшем, если не узказано иное, команды выполняются в Terminal в MacOS и в Git Bash в Windows) \
+  3.2. Выполните команду git --version \
+  3.3. Если вы увидели вывод git version ..., значит все в порядке, git установлен. 
+4. Сгенерируйте SSH ключ по инструкции https://git-scm.com/book/ru/v2/Git-на-сервере-Генерация-открытого-SSH-ключа  
+5. Добавьте публичный ключ SSH в профиль github https://github.com/settings/keys (New SSH key)
+6. Создайте папку, в которой вы будете работать, например Projects \
+  $ cd ~ \
+  $ mkdir Projects \
+  $ cd Projects
+7. Склонируйте репозиторий. Выполните команду в консоли: \
+  $ git clone [email protected]:svkrivenko/neogenda-technical-excellence-101.git
+8. Откройте проект в VS Code. Если VS Code спросит "Do you trust the authors ... ?", выберете "Yes, ..." \
+  $ code .
+9. В VS Code откройте терминал Terminal -> New  Terminal
+10. В меню VS Code включите опцию File -> AutoSave
+11. Нужно выполнить команды в терминале, подставив своё имя и е-мейл: \
+  $ git config --global user.name "John Doe" \
+  $ git config --global user.email [email protected] \
+  $ git config --global pull.rebase true
 
 ## Структура курса
 
-### Модуль 1. Git
-1. Что такое система управления исходным кодом и какие проблемы она решает
-2. Код = текст
-3. Зачем нужны ветки
-4. Что такое git, github, gitlab, bitbucket
-5. Интерфейс командной строки и VS Code
-6. git clone — клонировать удаленный репозиторий локально
-7. git status — посмотреть статус локального репозитория
-8. git add — добавить измененные файлы в снапшот
-9. git commit — закомитить снапшот
-10. Упражнение. Сохранение изменений в локальном репозитории
-11. git pull — получить изменения из удаленного репозитория в локальный
-12. git push — отправить изменения из локальног репозитория в удаленный
-13. Упражнение. Обмен данными между локальными и удаленным репозиториями
+### Модуль 1. SDLC + настройка
+1. Software Development LifeCycle
+2. Настройка необходимых программ для курса
 
-### Модуль 2. Ветки, конфликты и TBD
-1. git branch — создать ветку в локальном репозитории
-2. git checkout — переключиться в локальную ветку
-3. Упражнение. Создание, просмотр, переключение веток
-4. Слияние веток
-5. Конфликты и способы их разрешения
-6. git merge — смержить ветку в текущую
-7. Упражнение. Смержить ветку и разрешить конфликты
-8. Trunk Based Development (TBD) — практика разработки в одной ветке
-9. Упражнение. Совместная работа над общим кодом, используя TBD
+### Модуль 2. Система контроля версий Git, commit, push, pull
+1. Что такое система управления исходным кодом, и какие проблемы она решает
+2. Зачем нужны ветки
+3. Что такое git, github, gitlab, bitbucket
+4. Основные команды git 
+5. Упражнение. Сохранение изменений в своей ветке в локальном и удаленном резопитории
+6. Упражнение. Переключение между различными ветками и версиями 
 
-### Модуль 3. Code Review
+### Модуль 3. Ветки, конфликты и TBD
+1. Merge
+2. Упражнение на merge
+3. Merge hell
+4. Trunk Based Development
+5. Упражнение на TBD
+6. Дебриф
+
+### Модуль 4. Code Review и Парная работа
 1. Упражнение. Диктант
-2. Code Review — практика, помогающая давать обратную связь на код
-3. Правила хорошего Code Review
-4. Pull Request
-5. Упражнение. Создать Pull Request, дать и получить обратную связь, исправить замечания и запушить код в master
-6. Парное программирование как альтернатива Code Review
-7. Упражнение. Исправить диктант в паре
+2. Pull Request
+3. Упражнение на Pull Request
+4. Code Review + правила
+5. Упражнение на Code Review
+6. Парная работа
+7. Упражнение на Парную работу
 
-### Модуль 4. Автотесты и Test Driven Development
+### Модуль 5. Автотесты и Test Driven Development
 1. Автотесты
 3. Упражнение. Написать автотест на проверку текста
 2. Пирамида тестирования
@@ -92,19 +84,24 @@
 6. Сдвиг влево
 7. Тестировщик vs QA
 
-### Модуль 5. Continuous Integration & Continuous Deployment (CI/CD)
+### Модуль 6. Continuous Integration & Continuous Deployment (CI/CD)
 1. Что такое Continuous Integration
 2. Упражнение. Исправить ошибку в заголовке HTML сказки
 3. Как распознать CI Theatre
 4. CI Do/Don't
 5. Continous Delivery и Continuous Deployment
 6. Как устроен Deployment Pipeline
 
+### Модуль 7. AI инструменты
+1. Решение разного рода задач с помощью AI
+### Модуль 8. Подбор практик для решения ваших проблем
+1. Разбор ваших проблем
+
 ## Авторство
 Идея курса принадлежит Антону Бевзюку (@bevzuk). 
 В создании курса принимали участие 
 * Дарья Баянова
 * Федор Слесаренко
 * Арсений Кельдышев
 * Светлана Кривенко
-* Сергей Леонов
+* Сергей Леонов