diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b3e08bb
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,22 @@
+# Binaries
+/bin/
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Test binary, output of `go test -c`
+*.test
+
+# Coverage
+*.out
+coverage.html
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# Local env files
+.env
+.env.local
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0195c12
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# package-updater
+
+Webhook-driven Docker Compose service updater. See [design spec](docs/superpowers/specs/2026-05-22-package-updater-design.md) for full design.
+
+## Quick start
+
+(TBD — filled in by final task)
diff --git a/cmd/server/main.go b/cmd/server/main.go
new file mode 100644
index 0000000..4c8b475
--- /dev/null
+++ b/cmd/server/main.go
@@ -0,0 +1,7 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("package-updater (scaffold)")
+}
diff --git a/go.mod b/go.mod
new file mode 100644
index 0000000..bd57448
--- /dev/null
+++ b/go.mod
@@ -0,0 +1,3 @@
+module github.com/shcizo/package-updater
+
+go 1.26.3