*

Author: danstarns

modus/overview.mdx

@@ -23,30 +23,44 @@ agents that maintain persistent memory across interactions. This eliminates the
 need to parse conversation histories, rebuild context from scratch, or lose
 state when errors occur.
 
+Modus provides a complete toolkit for building intelligent applications:
+
+- **Functions**: Stateless operations that automatically become shareable skills
+  via auto-generated APIs
+- **Agents**: Stateful entities with short-term and long-term memory that
+  coordinate models, tools, and data
+- **Models**: Domain-specific AI models with the ability to easily swap in
+  different providers or versions
+- **Knowledge Graphs**: Organizational memory that scales context across
+  multi-agent architectures
+- **Collections**: Vector storage and semantic search capabilities for
+  intelligent data retrieval
+- **Tools**: Curated resources, databases, and external APIs that agents can
+  securely access
+
+Built-in observability provides automatic inference logging and tracing, while
+secure-by-default authorization ensures risk-appropriate access to tools and
+data. Following modern best practices for AI-native architectures, Modus
+implements principles from the 12-factor agentic app methodology for
+maintainable, scalable intelligent systems.
+
 You can run Modus locally for development or deploy it in seconds to Hypermode
 for production.
 
 ## What is Modus good for? {/* vale Google.Contractions = NO */}
 
-Modus is designed for building both traditional functions and intelligent
-agents. It supports sub-second response times for stateless operations and
-long-running, autonomous workflows that maintain state over time.
+Modus is designed for building applications where AI is at its core capability.
+It supports sub-second response times for stateless operations and long-running,
+autonomous workflows that maintain state over time.
 
 **Beyond demo prompt apps**: we've all built apps with prompts and AI tool
 integrations. When you're ready to take your project to the next level, Modus
 serves as your AI component in the stack. Modus can sit right alongside your
 existing app, handling the intelligent workflows while your main app focuses on
 what it does best.
 
-**Functions**: stateless operations for API endpoints, data processing, and AI
-inference tasks.
-
-**Agents**: stateful entities that maintain conversation history, coordinate
-between models and tools, and operate independently over extended periods.
-Agents automatically handle state persistence and fault tolerance.
-
-Both can be deployed in the same app, allowing you to choose the right
-abstraction for each use case.
+Both functions and agents can be deployed in the same app, allowing you to
+choose the right abstraction for each use case.
 
 For more inspiration, check out the
 [Modus recipes](https://github.com/hypermodeinc/modus-recipes).
@@ -65,9 +79,10 @@ For more inspiration, check out the
   </Card>
   <Card
     title="What about knowledge graphs?"
-    icon="share-nodes"
+    icon="network-wired"
     href="/modus/knowledge-graphs"
   >
     Build intelligence networks with persistent institutional memory
   </Card>
 </CardGroup>
+```