diff --git a/README.md b/README.md
index e51edad..6ace1aa 100644
--- a/README.md
+++ b/README.md
@@ -84,12 +84,12 @@ Agent: Let me check what pattern the existing community roles follow.
        I'll generate the new role following this structure.
 ```
 
-**Without Dervish:** the agent stuffs 15 role files into context (5,000+ tokens per role = beyond any context window), or guesses the pattern from 1–2 examples and often gets it wrong.
+**Without Dervish:** the agent either has to read all 15 role files (5,000+ tokens per role), or guesses the pattern from 1–2 examples and often gets it wrong.
 
 **With Dervish:** one MCP call returns a ~60-token grammar known to match 15/15 existing roles. The agent follows it reliably.
 
-**Core+outlier mode:** When generating a new role, the agent can call with
-`min_coverage=0.8` to learn the mainstream pattern while seeing which roles
+**Core+outlier mode:** When generating a new file, for example a new Ansible role, the agent can call with
+`min_coverage=0.8` to learn the mainstream pattern while seeing which files
 deviate and why — useful when the user's case resembles an outlier
 (e.g., a PHP app like phpmyadmin that needs raw `lineinfile`).