diff --git a/docs/development-checklist.md b/docs/development-checklist.md
new file mode 100644
index 0000000..f37d33f
--- /dev/null
+++ b/docs/development-checklist.md
@@ -0,0 +1,9 @@
+# Development checklist
+
+Use this checklist before opening a pull request.
+
+- Install dependencies with the repository's supported Node.js and pnpm versions.
+- Run `pnpm run check` for syntax, unit, and contract checks.
+- Run `pnpm run demo:build` when changing the Base portfolio demo.
+- Keep secrets and private keys out of commits and examples.
+- Update documentation when public behavior or commands change.