Freak Tasks

The starter project for the "AI Engineering with Claude Code" workshop: a small TODO API (Ruby, Hanami 3, SQLite, RSpec), fully Dockerized. Your job during the workshop is to use Claude Code to fix three intentionally broken tests, then build one small feature test-first.

The two commands that matter

docker compose build         # once, to build the image
docker compose run --rm test # run the full test suite
docker compose up            # run the API on http://localhost:2300

No local Ruby install needed — everything runs in Docker.

Where to go next

• SETUP.md — prerequisites, first build, what to expect, troubleshooting.
• EXERCISES.md — the three workshop blocks, in order.
• FEATURES.md — the feature backlog for Block 3.
• CLAUDE.md — ground rules for working with Claude Code in this repo.