Welcome to the AI Workshop

Today you will use AI-assisted development tools to work on VetHub — a veterinary clinic management application. You are not building AI features. You are learning to use AI as a development tool: to explore code, fix bugs, write tests, and implement features faster.

VetHub is hosted at https://github.com/Bartcardi82/vethub-go.

Before you start the exercises, make sure you have completed these steps:

Read the AI Richtlijnen — Kadaster’s rules for using AI in development. During the workshop we experiment freely, but these rules apply when you use AI on real projects.
Follow the Setup Guide — install Go, Node.js, fork the repo, and verify everything runs.
Browse the GitHub Copilot section — understand the three modes (inline, chat, agent) before you start coding.

The exercises are designed as a guided progression. Everyone works through the same sequence, at their own pace.

Exercise	What you will do	Time
00 — Environment Setup	Verify your setup, confirm your AI tools are connected	~15 min
01 — Let AI Explain the Project	Have your AI assistant walk you through the VetHub codebase	~20 min
02 — Give AI a Memory	Create project instructions so AI remembers your project context	~15 min
03 — Refine a Story	Use AI to turn a vague request into a concrete, implementable story	~25 min
04 — Build the Pets Page	Build a frontend feature from your refined story, matching existing patterns	~25 min
05 — Theme Selector	Set up project workflow tracking, then refine and build a theme switcher	~30 min
06 — Test-Driven Development	Write tests first, then let AI implement the code to pass them	~30 min
07 — Implement a Full Feature	Run a complete SCRUM cycle: refine a vague request, then build it end-to-end	~45 min
08 — Apply to Your Own Codebase	Take what you learned and try it on your own project	remaining time

Not familiar with the tech stack? No problem.

VetHub uses Go on the backend and SvelteKit (TypeScript) on the frontend. You do not need prior experience with either.

The code follows familiar patterns: HTTP handlers, middleware, SQL queries, components. If you have built anything with net/http, Gin, Echo, Django, Express, Angular, or Vue, it will feel recognisable.
Every exercise comes with clear acceptance criteria and hints — including working code examples you can use directly.
GitHub Copilot is your pair partner. It will help you navigate unfamiliar frameworks, explain patterns, and generate code in languages you may not know well.
The frontend (Vite HMR) has a fast feedback loop with hot reload. The Go backend restarts quickly (just re-run go run).
Your facilitator is here to help. Ask questions early and often.

The struggle is part of the learning. Give yourself at least 15 minutes on an exercise before reaching for the hints — and then absolutely use them.

What you will work on

VetHub is a fullstack veterinary clinic management application:

Component	Stack	What it does
`server/`	Go 1.22+, net/http, SQLite (in-memory)	REST API for managing owners, pets, vets, visits, specialties
`client/`	SvelteKit 2, Svelte 5	Web UI for the clinic management system

The backend follows a domain-based package structure:

server/internal/
    api/
        owner.go       -- Owner CRUD (handler functions, SQL queries, response types)
        pet.go         -- Pet and PetType management
        vet.go         -- Vet and Specialty management
        visit.go       -- Visit tracking
        respond.go     -- Shared HTTP response helpers
    db/
        db.go          -- Database initialisation (schema + seed data)
        schema.sql     -- DDL for 7 tables
        seed.sql       -- Sample data loaded at startup
    middleware/
        auth.go        -- HTTP Basic Auth
        cors.go        -- CORS for SPA

Key technologies: Go stdlib net/http (routing), database/sql (data access), modernc.org/sqlite (pure-Go SQLite driver), go:embed (embedded SQL files), openapi-fetch (type-safe API client in the frontend).

How to use this site

Use the sidebar to navigate:

Exercises — work through them in order, starting with 00
Hints — step-by-step guidance with code examples; open when you need them
GitHub Copilot — documentation for the AI coding assistant you will use
Facilitator Guide — for the people running the session

Ready? Head to the Setup Guide to get your environment ready, then move on to exercise 00.