diff --git a/README.md b/README.md
index 4b934ea..9a936b7 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,9 @@
 # README
 
-* gen.js is the build script that builds to the target dir
-* serve.js is a local server for your cards interface
-* emit.js will scaffold a dir or update files that are already there
+
+* **`emit.mjs`**: Reconciles deployment templates with target directories by preserving user configurations in files like `wrangler.toml` while propagating structural adapter updates.
+* **`gen.mjs`**: Scans source markdown cards to ensure every item possesses a stable UUID v7 identifier and compiles them into an auto-generated JavaScript manifest module.
+* **`serve.js`**: Edge runtime request handler that safely injects compiled card collections, tag vocabularies, and page titles into an HTML template for client hydration.
 
 
 # gen.mjs