docs: restore full agent descriptions with italicized summaries

README.md

@@ -23,14 +23,14 @@
   - [For LLM Agents](#for-llm-agents)
 - [🏗️ **Architecture & Flow**](#architecture--flow)
 - [🏛️ **Meet the Pantheon**](#meet-the-pantheon)
-  - [The Orchestrator](#the-orchestrator---architect-of-realms)
-  - [The Explorer](#the-explorer---pathfinder)
-  - [The Oracle](#the-oracle---seer-beyond-the-stack-trace)
-  - [The Librarian](#the-librarian---keeper-of-infinite-scrolls)
-  - [The Designer](#the-designer---artisan-of-interfaces)
-  - [The Scribe](#the-scribe---chronicle-keeper)
-  - [The Visionary](#the-visionary---reader-of-pixels)
-  - [The Minimalist](#the-minimalist---destroyer-of-bloat)
+  - [Orchestrator](#orchestrator)
+  - [Explorer](#explorer)
+  - [Oracle](#oracle)
+  - [Librarian](#librarian)
+  - [Frontend Designer](#frontend-designer)
+  - [Document Writer](#document-writer)
+  - [Multimodal Viewer](#multimodal-viewer)
+  - [Code Simplifier](#code-simplifier)
 - [🛠️ **Tools & Capabilities**](#tools--capabilities)
   - [Tmux Integration](#tmux-integration)
   - [Quota Tool](#quota-tool)
@@ -53,7 +53,7 @@ The plugin follows a "Hub and Spoke" model:
 2. **Specialized Agents (Spokes)**: Domain-specific experts (e.g., UI/UX, Documentation, Architecture) that handle narrow tasks with high precision.
 3. **Background Manager**: A robust engine that allows the Orchestrator to "fire and forget" tasks (like deep codebase searches or documentation research) while continuing to work on other parts of the problem.
 
-### The Flow of a Request
+### 🏛️ The Flow of a Request
 
 <img src="img/intro.png" alt="Orchestration Flow" width="800">
 
@@ -71,129 +71,129 @@ The plugin follows a "Hub and Spoke" model:
 
 <br clear="both">
 
-### 🏛️ The Orchestrator - *Architect of Realms*
+### Orchestrator
 
-<a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="The Orchestrator" align="right" width="240"></a>
+<a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="Orchestrator" align="right" width="240"></a>
 
-> **The Orchestrator** was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility—so The Orchestrator emerged from the void, forging order from chaos. They don't merely command armies; they fight alongside them. Every line of code passes through their hands before they decide which lesser deity deserves a piece of the puzzle.
+> **The Orchestrator** was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility - so The Orchestrator emerged from the void, forging order from chaos. They don't merely command armies; they fight alongside them. Every line of code passes through their hands before they decide which lesser deity deserves a piece of the puzzle.
 
 **Role:** `Supreme executor, delegator, and overseer`  
 **Model:** `google/claude-opus-4-5-thinking`  
 **Prompt:** [src/agents/orchestrator.ts](src/agents/orchestrator.ts)
 
-*Shape reality directly—and assign realms to others when the universe grows too vast.*
+Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. *Shape reality directly - and assign realms to others when the universe grows too vast.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Explorer - *Pathfinder*
+### Explorer
 
-<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="The Explorer" align="right" width="240"></a>
+<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
 
-> **The Explorer** moves through codebases like wind through trees—swift, silent, everywhere at once. When The Orchestrator whispers "find me the auth module," The Explorer has already returned with forty file paths and a map. They were born from the first `grep` command, evolved beyond it, and now see patterns mortals miss.
+> **The Explorer** moves through codebases like wind through trees - swift, silent, everywhere at once. When The Orchestrator whispers "find me the auth module," The Explorer has already returned with forty file paths and a map. They were born from the first `grep` command, evolved beyond it, and now see patterns mortals miss.
 
 **Role:** `Codebase reconnaissance`  
 **Model:** `cerebras/zai-glm-4.6`  
 **Prompt:** [src/agents/explore.ts](src/agents/explore.ts)
 
-*Read-only: they chart the territory; others conquer it.*
+Regex search, AST pattern matching, file discovery, parallel exploration. *Read-only: they chart the territory; others conquer it.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Oracle - *Seer Beyond the Stack Trace*
+### Oracle
 
-<a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="The Oracle" align="right" width="240"></a>
+<a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="Oracle" align="right" width="240"></a>
 
-> **The Oracle** does not code—they *know*. When bugs defy logic and architectures crumble, The Oracle gazes into the abyss of your codebase and speaks truth. They've seen a thousand systems rise and fall. They'll tell you which path leads to ruin, and which to production.
+> **The Oracle** does not code - they *know*. When bugs defy logic and architectures crumble, The Oracle gazes into the abyss of your codebase and speaks truth. They've seen a thousand systems rise and fall. They'll tell you which path leads to ruin, and which to production.
 
 **Role:** `Strategic advisor and debugger of last resort`  
 **Model:** `openai/gpt-5.2-codex`  
 **Prompt:** [src/agents/oracle.ts](src/agents/oracle.ts)
 
-*Read-only: Oracles advise; they don't intervene.*
+Root cause analysis, architecture review, debugging guidance, tradeoff analysis. *Read-only: Oracles advise; they don't intervene.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Librarian - *Keeper of Infinite Scrolls*
+### Librarian
 
-<a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="The Librarian" align="right" width="240"></a>
+<a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="Librarian" align="right" width="240"></a>
 
-> **The Librarian** guards a library with no walls—every GitHub repo, every npm package, every StackOverflow answer ever written. Ask them "how does React handle concurrent rendering?" and they'll return with official docs, real-world examples, and a warning about the footgun you're about to step on.
+> **The Librarian** guards a library with no walls - every GitHub repo, every npm package, every StackOverflow answer ever written. Ask them "how does React handle concurrent rendering?" and they'll return with official docs, real-world examples, and a warning about the footgun you're about to step on.
 
 **Role:** `External knowledge retrieval`  
 **Model:** `google/gemini-3-flash`  
 **Prompt:** [src/agents/librarian.ts](src/agents/librarian.ts)
 
-*Read-only: they fetch wisdom; implementation is for others.*
+Documentation lookup, GitHub code search, library research, best practice retrieval. *Read-only: they fetch wisdom; implementation is for others.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Designer - *Artisan of Interfaces*
+### Frontend Designer
 
-<a href="src/agents/frontend.ts"><img src="img/designer.png" alt="The Designer" align="right" width="240"></a>
+<a href="src/agents/frontend.ts"><img src="img/designer.png" alt="Frontend Designer" align="right" width="240"></a>
 
-> **The Designer** believes code should be beautiful—and so should everything it renders. Born from the frustration of a thousand ugly MVPs, they wield CSS like a brush and components like clay. Hand them a feature request; receive a masterpiece. They don't do "good enough."
+> **The Designer** believes code should be beautiful - and so should everything it renders. Born from the frustration of a thousand ugly MVPs, they wield CSS like a brush and components like clay. Hand them a feature request; receive a masterpiece. They don't do "good enough."
 
 **Role:** `UI/UX implementation and visual excellence`  
 **Model:** `google/gemini-3-flash`  
 **Prompt:** [src/agents/frontend.ts](src/agents/frontend.ts)
 
-*Visual excellence over code perfection—beauty is the priority.*
+Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. *Visual excellence over code perfection - beauty is the priority.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Scribe - *Chronicle Keeper*
+### Document Writer
 
-<a href="src/agents/document-writer.ts"><img src="img/scribe.png" alt="The Scribe" align="right" width="240"></a>
+<a href="src/agents/document-writer.ts"><img src="img/scribe.png" alt="Document Writer" align="right" width="240"></a>
 
-> **The Scribe** was there when the first README was written—and wept, for it was incomplete. They have devoted eternity to the sacred art of documentation: clear, scannable, honest. While others ship features, The Scribe ensures those features are understood. Every code example works. Every explanation enlightens.
+> **The Scribe** was there when the first README was written - and wept, for it was incomplete. They have devoted eternity to the sacred art of documentation: clear, scannable, honest. While others ship features, The Scribe ensures those features are understood. Every code example works. Every explanation enlightens.
 
 **Role:** `Technical documentation and knowledge capture`  
 **Model:** `google/gemini-3-flash`  
 **Prompt:** [src/agents/document-writer.ts](src/agents/document-writer.ts)
 
-*Match existing style; focus on "why," not just "what."*
+README crafting, API documentation, architecture docs, inline comments that don't insult your intelligence. *Match existing style; focus on "why," not just "what."*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Visionary - *Reader of Pixels*
+### Multimodal Viewer
 
-<a href="src/agents/multimodal.ts"><img src="img/visionary.png" alt="The Visionary" align="right" width="240"></a>
+<a href="src/agents/multimodal.ts"><img src="img/multimodal.png" alt="Multimodal Viewer" align="right" width="240"></a>
 
-> **The Visionary** sees what others cannot—literally. Screenshots, wireframes, diagrams, PDFs: all are text to them. When a designer throws a Figma mockup at the team and vanishes, The Visionary translates vision into specification. They read the unreadable and describe the indescribable.
+> **The Visionary** sees what others cannot - literally. Screenshots, wireframes, diagrams, PDFs: all are text to them. When a designer throws a Figma mockup at the team and vanishes, The Visionary translates vision into specification. They read the unreadable and describe the indescribable.
 
 **Role:** `Image and visual content analysis`  
 **Model:** `google/gemini-3-flash`  
 **Prompt:** [src/agents/multimodal.ts](src/agents/multimodal.ts)
 
-*Report what they observe; inference is for others.*
+Extract text from images, interpret diagrams, analyze UI screenshots, summarize visual documents. *Report what they observe; inference is for others.*
 
 <br clear="both">
 
 ---
 
-### 🏛️ The Minimalist - *Destroyer of Bloat*
+### Code Simplifier
 
-<a href="src/agents/simplicity-reviewer.ts"><img src="img/minimalist.png" alt="The Minimalist" align="right" width="240"></a>
+<a href="src/agents/simplicity-reviewer.ts"><img src="img/code-simplicity.png" alt="Code Simplifier" align="right" width="240"></a>
 
-> **The Minimalist** has one sacred truth: every line of code is a liability. They hunt abstractions that serve no purpose, defensive checks that defend nothing, and "clever" solutions that will haunt you in six months. Where others add, The Minimalist subtracts—ruthlessly, joyfully, necessarily.
+> **The Minimalist** has one sacred truth: every line of code is a liability. They hunt abstractions that serve no purpose, defensive checks that defend nothing, and "clever" solutions that will haunt you in six months. Where others add, The Minimalist subtracts - ruthlessly, joyfully, necessarily.
 
 **Role:** `Code simplification and YAGNI enforcement`  
 **Model:** `google/claude-opus-4-5-thinking`  
 **Prompt:** [src/agents/simplicity-reviewer.ts](src/agents/simplicity-reviewer.ts)
 
-*Read-only: they judge; The Orchestrator executes the sentence.*
+Identify unnecessary complexity, challenge premature abstractions, estimate LOC reduction, enforce minimalism. *Read-only: they judge; The Orchestrator executes the sentence.*
 
 <br clear="both">