diff --git a/agora-search.md b/agora-search.md
index e794d493f..c17546ddf 100644
--- a/agora-search.md
+++ b/agora-search.md
@@ -22,7 +22,10 @@
 ## Design
 - In [[agora server]], `/search` / `/exec` does the following:
   - It takes a query string in argument 'q' (sort of standard).
-  - It offers the query string
+  - It optionally tokenizes the query string (unsuere if this is the right stage for tokenizing)
+  - It offers the query string or the tokens to [[search providers]], essentially hooks that the volunteer actions -- or perhaps bid in a distributed system modelled as a market (later).
+  - It scores the alternatives and either chooses one for the user (based on programmable rules) or presents them as alternatives.
+  - The default action is 'redirect to the agora node matching/encoding the query'.
 
 
 [//begin]: # "Autogenerated link references for markdown compatibility"