diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b2db0ea
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# ebitengine-tools
+
+CI/CD templates for [Ebitengine](https://ebitengine.org) (Go) game
+projects, in the same spirit as [tic80-tools](../tic80-tools).
+
+- `example-makefile.make` — project Makefile: local dev targets
+  (`build`, `wasm`, `export`, `watch`, `clean`) plus the Woodpecker
+  pipeline targets (`ci-version`, `ci-export`, `ci-upload`,
+  `ci-update`).
+- `example-woodpecker.yaml` — Woodpecker pipeline: version → export
+  (Go, `GOOS=js GOARCH=wasm`) → upload (scp to the droparea) → update
+  (calls the teletypegames `/update` endpoint with
+  `platform=ebitengine`).
+- `example-tasks.json` — VS Code `.vscode/tasks.json` with the common
+  dev tasks: **Run** (`go run .`, default build task, `Cmd+Shift+B`),
+  **Build & Run**, **Build WASM** and **Make build**.
+- `web/index.html` — the HTML shell downloaded by `make export` and
+  packaged next to the `.wasm` build.
+
+## Usage in a game repo
+
+1. Copy `example-makefile.make` to `Makefile` and set `PROJECT`
+   (the native binary is built to `bin/$(PROJECT)`).
+2. Copy `example-woodpecker.yaml` to `.woodpecker.yaml` and add the
+   `droparea_ssh_password` / `update_secret_key` secrets in Woodpecker.
+3. Copy `example-tasks.json` to `.vscode/tasks.json` and replace the
+   binary name (`ebitenginedemo`) with `$(PROJECT)`.
+
+The pipeline uploads `$(PROJECT)-$(VERSION).html.zip` to the droparea,
+then triggers
+`/update?platform=ebitengine&name=$(PROJECT)&version=$(VERSION)`.
+
+Detailed documentation lives on the wiki: `/development/ebitengine`.
diff --git a/example-tasks.json b/example-tasks.json
new file mode 100644
index 0000000..1c1846e
--- /dev/null
+++ b/example-tasks.json
@@ -0,0 +1,35 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    // Copy to .vscode/tasks.json and replace "ebitenginedemo" with your PROJECT name.
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Run",
+            "type": "shell",
+            "command": "go run .",
+            "problemMatcher": [],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        },
+        {
+            "label": "Build & Run",
+            "type": "shell",
+            "command": "make clean && make build && ./bin/ebitenginedemo",
+            "problemMatcher": []
+        },
+        {
+            "label": "Build WASM",
+            "type": "shell",
+            "command": "make wasm",
+            "problemMatcher": []
+        },
+        {
+            "label": "Make build",
+            "type": "shell",
+            "command": "make build"
+        }
+    ]
+}