diff --git a/leetcode/AGENTS.md b/leetcode/AGENTS.md
index 4c0ed02..6e4c966 100644
--- a/leetcode/AGENTS.md
+++ b/leetcode/AGENTS.md
@@ -28,14 +28,26 @@ downloads the chunks, and regex-extracts the data structures.
 ## Running
 
 ```bash
-node extract.mjs                  # writes to ./out/
+node extract.mjs                  # writes to ./out/ + org/study_deck_02/roadmap.org
 node extract.mjs --stdout         # prints full JSON to stdout
 node extract.mjs --cache /tmp/nc  # custom cache directory
+node scaffold-notes.mjs           # create missing note files (skips existing)
+node populate-notes.mjs           # fill notes with descriptions + code stubs
+node populate-notes.mjs --force   # overwrite existing content
+node populate-notes.mjs --dry-run # show what would change
 ```
 
 Downloads are cached in `.cache/` (gitignored). Re-runs are instant
 and produce byte-identical output.
 
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `extract.mjs` | Fetch NeetCode data, write JSON/DOT/org files |
+| `scaffold-notes.mjs` | Create empty note files for each problem |
+| `populate-notes.mjs` | Fetch problem descriptions + code stubs from LeetCode API |
+
 ## Output Files
 
 | File | Contents |