docs: claim best-agent with an explicit perception-action architecture section

README.md

@@ -15,6 +15,7 @@ tags:
   - off-brand
   - off-the-grid
   - best-demo
+  - best-agent
   - sharing-is-caring
   - community-choice
 ---
@@ -64,6 +65,13 @@ Accessibility shaped the whole interface, because the person it was made for ask
 voice-first frontend is custom, built on **`gr.Server`** (Off-Brand). Inference runs
 in the Space on **ZeroGPU**, with no third-party model APIs.
 
+## Architecture: a small perception-action agent
+Iris is more than one model call. It orchestrates four tools and runs a control loop:
+- **Role prompts** define what each model does: read money and bills, describe a scene for a blind person, report only what is new.
+- **Intent routing** turns a spoken phrase into an action: describe, answer a question, or toggle live mode (forgiving of transcription errors).
+- **Tools it drives:** Whisper to hear, Qwen3-VL to see and read, Piper to speak, and an on-device detector (COCO-SSD) to watch for change.
+- **A live loop** that perceives (camera + detector), decides whether something new is worth saying, acts (calls the vision model and speaks), and remembers what it already said so it doesn't repeat.
+
 ## Safety
 Iris describes surroundings and reads text. Don't use it to get around or avoid
 obstacles. It can't judge distance reliably and isn't safe to walk by.