diff --git a/README.md b/README.md
index 04702f4..4929775 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,51 @@
-here be dragons
+here be dragons.
+
+## brief
+
+**NOTE:** a lot of this stuff hasn't been committed yet.
+
+### actual projects
+
+* 6502\_name\_codec - lossless text encoding
+
+* atone\_syntax - general parser (nonfunctional)
+
+* automamba - bash-based auto-installer for mamba/conda/python/MSVC
+
+* bitten - high-level python interface to [biteopt](https://github.com/avaneev/biteopt)
+
+* ciel - useless calculator / masochistic C playground
+
+* direct - pure python **B**IRECT implementation + related algorithms
+
+* envelope\_follower - many ways to attack and release
+
+* pga - code generators for clifford algebras
+
+* phony64 - encode binary data with japanese phonetics
+
+* rs\_dissection - random search experiments
+
+### general stuff
+
+* **library - important code**
+
+* approximation - approximations of specific functions or data
+
+* entropy - entropy encoding
+
+* games - reverse-engineering games (does not contain games)
+
+* hashing - hash functions
+
+* logic - *(TODO)*
+
+* shader - standalone graphical shaders
+
+* sound - analysis of sound files etc.
+
+* tests - i break people's software by accident
+
+* todo - uncategorized stuff that needs to be moved into a general directory
+
+* wat - somewhat surprising behavior