Update README with comprehensive documentation

README.md

@@ -1,11 +1,185 @@
 ---
 title: BDR Agent Factory
-emoji: 📉
+emoji: 🏭
 colorFrom: red
 colorTo: gray
 sdk: static
 pinned: false
-short_description: AI Agent Factory - Single Source of Truth for Governed AI Ca
+short_description: AI Agent Factory - Single Source of Truth for Governed AI Capabilities
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🏭 BDR Agent Factory
+
+**Single Source of Truth for Governed AI Capabilities in Insurance**
+
+The BDR Agent Factory is an enterprise governance framework that defines, maps, and manages AI capabilities across insurance business systems. It serves as the central registry for all AI agents, ensuring compliance, explainability, and auditability.
+
+---
+
+## 📋 Overview
+
+This Space contains two critical governance documents:
+
+1. **AI_CAPABILITY_DICTIONARY.yaml** - Comprehensive taxonomy of 50+ AI capabilities
+2. **CAPABILITY_SYSTEM_MAP.yaml** - Mapping of capabilities to 8 business systems
+
+---
+
+## 🎯 Key Features
+
+### AI Capability Dictionary
+- **50+ AI Capabilities** across 8 categories:
+  - 🎨 Generation (text, code, synthetic data)
+  - 🔄 Transformation (translation, summarization, extraction)
+  - 💬 Language (classification, NER, sentiment)
+  - 🎵 Audio (transcription, speech synthesis)
+  - 👁️ Vision (object detection, OCR, damage assessment)
+  - 📄 Document (parsing, analysis, generation)
+  - 📊 Analytics (forecasting, anomaly detection, clustering)
+  - ⚖️ Governance (explainability, audit, compliance)
+
+### System Mapping
+- **8 Production Systems** mapped to capabilities
+- **3 Planned Systems** for future expansion
+- **Governance Requirements** (IFRS 17, HIPAA, GDPR, AML)
+- **Decision Types** (approve, review, reject, escalate)
+
+---
+
+## 🏗️ Architecture
+
+```
+BDR Agent Factory (Governance Hub)
+├── AI Capability Dictionary
+│   ├── Capability Definitions
+│   ├── Insurance Use Cases
+│   └── Governance Flags
+└── System Mapping
+    ├── Business Systems
+    ├── Required Capabilities
+    └── Compliance Requirements
+```
+
+---
+
+## 📊 Mapped Business Systems
+
+1. **ClaimsGPT** - AI-powered claims decision intelligence
+2. **FraudDetectionAgent** - Real-time fraud detection
+3. **PolicyIntelligenceAgent** - RAG-powered policy knowledge
+4. **DamageAssessmentAgent** - Computer vision damage analysis
+5. **CustomerServiceAgent** - Conversational AI support
+6. **UnderwritingAgent** - IFRS-ready risk scoring
+7. **MedicalClaimsAgent** - Healthcare claims processing
+8. **ComplianceMonitoringAgent** - Regulatory compliance tracking
+
+---
+
+## 🔍 Governance Standards
+
+### Compliance Frameworks
+- ✅ **IFRS 17** - Insurance contracts accounting
+- ✅ **HIPAA** - Healthcare data privacy
+- ✅ **GDPR** - Data protection regulation
+- ✅ **AML** - Anti-money laundering
+
+### AI Governance
+- 🔍 **Explainability** - All decisions traceable
+- 📝 **Auditability** - Complete audit trails
+- ⚖️ **Fairness** - Bias detection and mitigation
+- 🔒 **Privacy** - Data protection built-in
+
+---
+
+## 🚀 Usage
+
+### Viewing Capability Dictionary
+1. Navigate to Files tab
+2. Open `AI_CAPABILITY_DICTIONARY.yaml`
+3. Browse 50+ capabilities with detailed metadata
+
+### Viewing System Map
+1. Navigate to Files tab
+2. Open `CAPABILITY_SYSTEM_MAP.yaml`
+3. See business system to capability mappings
+
+---
+
+## 📚 Documentation
+
+Each capability includes:
+- **Unique ID** - Standardized identifier
+- **Name & Description** - Clear definition
+- **Category** - Functional grouping
+- **Supported Domains** - Applicable areas
+- **Insurance Use Cases** - Real-world applications
+- **Decision Types** - Output classifications
+- **Governance Flags** - Explainable, auditable, regulated
+
+---
+
+## 🎓 Example Capability
+
+```yaml
+- id: cap_text_classification
+  name: Text Classification
+  category: language
+  description: Categorize text into predefined classes
+  supported_domains:
+    - claims
+    - underwriting
+    - customer_service
+  insurance_use_cases:
+    - Claim type classification
+    - Policy document categorization
+  decision_types:
+    - approve
+    - review
+    - reject
+  explainable: true
+  auditable: true
+```
+
+---
+
+## 🔗 Related Resources
+
+- [ClaimsGPT](https://huggingface.co/spaces/bdr-ai-org/ClaimsGPT) - Production claims system
+- [ClaimsDecisionDesk](https://huggingface.co/spaces/bdr-ai-org/ClaimsDecisionDesk) - Human-in-loop interface
+- [Insurance Claims Model](https://huggingface.co/bdr-ai-org/insurance-claims-decision-model-v1) - ML model
+- [Motor Claims Dataset](https://huggingface.co/datasets/bdr-ai-org/insurance-motor-claims-decision-v1) - Training data
+
+---
+
+## 📈 Project Status
+
+- ✅ 50+ AI capabilities defined
+- ✅ 8 business systems mapped
+- ✅ 4 compliance frameworks integrated
+- ✅ Production-ready governance structure
+
+---
+
+## 🤝 Contributing
+
+To add new capabilities or systems:
+1. Follow the YAML schema in existing files
+2. Include all required governance metadata
+3. Document insurance-specific use cases
+4. Ensure compliance flags are accurate
+
+---
+
+## 📄 License
+
+MIT License - See individual component licenses for details
+
+---
+
+## 📞 Contact
+
+For questions about the BDR Agent Factory governance framework, please open an issue or discussion.
+
+---
+
+**Built with ❤️ for Enterprise AI Governance in Insurance**