Введение

CodeSpeak Workshop

Шаг 0 · Установка

Установка

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv tool install codespeak-cli
codespeak --version
rm -f ~/.codespeak/token.json
CODESPEAK_DIRECT_LOGIN=workshop_2026_05_21 codespeak login

Windows — через WSL. Если 400 — повторите команду.

Обо мне

Серик Бейсенов

  • сооснователь и CTO Effective
  • AI энтузиаст
  • не разработчик CodeSpeak
План

Что сегодня делаем

  1. Установим CodeSpeak
  2. Соберем простое приложение
  3. Добавим фичу через спеку
  4. Сгенерируем спеку на основе кода, если успеем
Шаг 0 · Установка

Установка

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv tool install codespeak-cli
codespeak --version
rm -f ~/.codespeak/token.json
CODESPEAK_DIRECT_LOGIN=workshop_2026_05_21 codespeak login

Windows — через WSL. Если 400 — повторите команду.

Шаг 0 · Файлы

Берем стартовые файлы

git clone https://github.com/serik-effective/codespeak-workshop
cd codespeak-workshop/workshop/<PLATFORM>

Либо скачайте файлы из инструкции

Шаг 1 · Первое приложение

Первое приложение

codespeak init
codespeak build <SPEC_FILE>

Результат: появились файлы приложения

Шаг 2 · Меняем спеку

Добавляем Speed Slider

UI
The bottom-right corner has a speed slider.
codespeak build <SPEC_FILE>
Шаг 3 · Takeover

Выбираем репозиторий

  • Android: Effective Office
  • iOS: SmartSpend
  • Flutter: SyncSpend
  • CodeSpeak example: markitdown
Шаг 3 · Clone

Клонируем проект

git clone <TAKEOVER_REPO_URL>
cd <TAKEOVER_REPO_NAME>
codespeak init
Шаг 3 · Takeover

Генерируем спеку из кода

codespeak takeover clients/tablet/feature/main/src/commonMain/kotlin -o tablet-main.spec.md
Шаг 3 · Build

Меняем спеку и запускаем build

codespeak build tablet-main.spec.md --skip-tests
Если что-то сломалось

Не геройствуем.
Переключаемся на Web.

cd workshop/web
codespeak init
codespeak build geese.spec.md
Финал

Что попробовать дальше

  1. `change` — исправить реализацию
  2. `takeover` — восстановить intent
  3. modular takeover — брать проект частями
  4. coverage — добрать тесты

Начинать с маленького эксперимента

Спасибо

Спасибо

Инструкция останется доступна по ссылке