diff --git a/doc/NOTES.md b/doc/NOTES.md
new file mode 100644
index 0000000..cd8da5e
--- /dev/null
+++ b/doc/NOTES.md
@@ -0,0 +1,15 @@
+# Design
+
+* core: only PSL
+* pass if modules are missing
+* minimize dependencies, code
+* test everything
+
+# Features
+
+## Backwards-compatibility
+* aliases
+* charts (hbar, vbar, braille)
+
+## Improvements
+* pango output (improve - maybe autodetect? see #531)