Skip to content

Get startedExercises

Exercises

Updated

Page actions

ChatGPT and Claude are third-party services. The link gives them this page's public address and a short instruction. This site records nothing.

Six hands-on exercises, each runnable with make targets alone, with the output to expect and a self-check: trace a search, add a route, bump a pin, write an ADR, fix a poster, add a widget.

Each exercise is short, uses only make targets and the tools the repository already has, says what output to expect, and ends with a self-check. None touches the scripture; several show you the gate that would stop you if you tried. Do them from a fresh branch off integration and throw the branch away afterwards unless a path tells you to open a pull request.

#ExerciseYou learnTime
01Trace a searchwhich tier answered, and why, for three real queries30 min
02Add a route and watch the gatesthe dispatcher, the OpenAPI declarations, the generated pages, and the tests that notice60 min
03Bump a pin in a scratch branchwhat a dataset bump changes, what the integrity gate proves, and why you revert instead of merging30 min
04Write an ADRhow a decision is recorded so it survives its author30 min
05Fix a posterthe poster kit, the drift check, and the walkthrough30 min
06Add a widgetthe widget schema, the fallback rule, the e2e test, and the budget60 min

Before the first one: run it locally once, so make doctor is green and db/sggs.sqlite is installed.