From 562554b3183af8e498ce67d0be9121c331dd6a7d Mon Sep 17 00:00:00 2001
From: David Snelling <david@soulcraft.com>
Date: Fri, 17 Oct 2025 15:07:14 -0700
Subject: [PATCH] docs: fix noun count and add use case examples
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixed critical documentation error:
- Corrected 24 nouns → 31 nouns in noun-verb-taxonomy.md (3 locations)
- Updated combination count from 960 → 1,240

Added "What Can You Build?" section to README with real-world use cases:
- Intelligent documentation systems
- AI agents with perfect memory
- Rich interactive experiences
- Next-gen search & discovery
- Enterprise knowledge management
- Creative tools & content platforms

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md                               | 38 +++++++++++++++++++++++++
 docs/architecture/noun-verb-taxonomy.md |  8 +++---
 2 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 9fe93224..f69ecd9f 100644
--- a/README.md
+++ b/README.md
@@ -94,6 +94,44 @@ Model **ANY domain** with 1,240 base type combinations + unlimited metadata:
 
 ---
 
+## 💡 What Can You Build?
+
+**Brainy unlocks entirely new categories of applications.** Here's what developers are building:
+
+### 📚 **Intelligent Documentation Systems**
+- **Living knowledge bases** where docs understand each other and evolve
+- **Smart wikis** that auto-link related concepts and detect outdated information
+- **Research assistants** that remember every paper you've read and find connections
+
+### 🤖 **AI Agents with Perfect Memory**
+- **Conversational AI** that remembers context across months, not just messages
+- **Code assistants** that understand your entire codebase as a knowledge graph
+- **Personal assistants** with unlimited memory that never forgets important details
+
+### 🎮 **Rich Interactive Experiences**
+- **Game worlds** where NPCs remember every interaction and relationships evolve
+- **Story engines** where characters persist across multiple narratives
+- **Educational platforms** that build personalized knowledge graphs as you learn
+
+### 🔍 **Next-Gen Search & Discovery**
+- **Semantic code search** across millions of repositories
+- **Smart file explorers** that understand code relationships, not just folders
+- **Research platforms** that find papers by meaning, not keywords
+
+### 🏢 **Enterprise Knowledge Management**
+- **Corporate memory systems** where institutional knowledge never gets lost
+- **Customer intelligence** platforms that understand every interaction
+- **Product catalogs** with semantic search and relationship-based recommendations
+
+### 🎨 **Creative Tools & Content Platforms**
+- **Writing assistants** that track characters, plotlines, and themes across stories
+- **Content management** where every asset knows its relationships and history
+- **Media libraries** with intelligent tagging and similarity-based discovery
+
+**The Pattern**: If your app needs to **remember**, **understand**, or **connect** information, Brainy makes it trivial.
+
+---
+
 ## ⚡ Quick Start - Zero Configuration
 
 ```bash
diff --git a/docs/architecture/noun-verb-taxonomy.md b/docs/architecture/noun-verb-taxonomy.md
index 7aa550ae..35e81865 100644
--- a/docs/architecture/noun-verb-taxonomy.md
+++ b/docs/architecture/noun-verb-taxonomy.md
@@ -1159,9 +1159,9 @@ We intentionally keep the type system minimal because:
 
 ## Industry-Specific Coverage Analysis
 
-### Why 24 Nouns + 40 Verbs = Universal Coverage
+### Why 31 Nouns + 40 Verbs = Universal Coverage
 
-The combination of **24 noun types** and **40 verb types** creates **960 basic combinations**, but with metadata and multi-hop relationships, this expands to **infinite expressiveness**. Here's how it covers every industry:
+The combination of **31 noun types** and **40 verb types** creates **1,240 basic combinations**, but with metadata and multi-hop relationships, this expands to **infinite expressiveness**. Here's how it covers every industry:
 
 ### Healthcare & Medical
 ```typescript
@@ -1498,8 +1498,8 @@ The noun-verb taxonomy achieves **Turing completeness** for knowledge representa
 #### The Infinity Formula
 
 ```
-Expressiveness = (24 nouns × 40 verbs) × ∞ metadata × ∞ graph depth
-              = 960 × ∞ × ∞
+Expressiveness = (31 nouns × 40 verbs) × ∞ metadata × ∞ graph depth
+              = 1,240 × ∞ × ∞
               = ∞ (Infinite Expressiveness)
 ```