diff --git a/.claude/instructions.md b/.claude/instructions.md
new file mode 100644
index 0000000..90e5b49
--- /dev/null
+++ b/.claude/instructions.md
@@ -0,0 +1,2 @@
+When asked "what's next?" or during downtime, check TODO.md and suggest items to work on.
+
diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..9550158
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,21 @@
+- [ ] Update check script:
+  - [ ] Run `go fmt` on all .go files
+  - [ ] Run prettier on all .ts files
+  - [ ] Eventually, run unit tests
+
+- [ ] Adapt master program so that it reads configuration from command line
+  args instead of from environment variables
+  - Should have sane defaults
+  - Adding new arguments should be easy and obvious
+
+- [ ] Add wrapper script to run main program (so that various assumptions related
+  to relative paths are safer)
+
+- [ ] Add unit tests all over the place.
+  - ⚠️ Huge task - needs breakdown before starting
+
+- [ ] flesh out the `sync.sh` script
+  - [ ] update framework-managed node
+  - [ ] update framework-managed pnpm
+  - [ ] update pnpm-managed deps
+  - [ ] rebuild golang programs