diff --git a/include/amduat/tgk/store.h b/include/amduat/tgk/store.h
index 650c26c..527911a 100644
--- a/include/amduat/tgk/store.h
+++ b/include/amduat/tgk/store.h
@@ -151,6 +151,9 @@ bool amduat_tgk_store_scan_edges(amduat_tgk_store_t *store,
                                  bool has_page_token,
                                  amduat_tgk_graph_scan_result_t *out_scan);
 
+/* Cursor format note: the in-memory TGK store adapter encodes page tokens as
+ * ASL1 ReferenceBytes (hash_id + digest) for the last edge_ref returned. */
+
 bool amduat_tgk_store_neighbors(amduat_tgk_store_t *store,
                                 amduat_reference_t node,
                                 amduat_tgk_edge_type_filter_t type_filter,