diff --git a/GEMINI.md b/GEMINI.md
index b1188015..7aed6dbc 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -68,6 +68,8 @@ This file contains the accumulated instructions and long-term vision for the aut
     - **Protocol Uniformity**: Standardize on `https://` whenever possible.
     - **Semantic Merge Logic**: If multiple URLs point to the same technical project (e.g., `user.github.io` vs `github.com/user/repo`), the agent MUST consolidate them into a single canonical reference, prioritizing the primary repository root.
     - **Metadata Merge**: Metadata from multiple sources for the same canonical URL MUST be merged, prioritizing the highest star rating and most recent date.
+
+25. **YouTube Content Enrichment**: Featured videos in the V2 Elite Video Hub MUST be enriched using real-time metadata (titles and descriptions) fetched directly from YouTube. This raw data is then synthesized by AI into technical "Curator Insights" and classified into logical architectural dimensions to ensure 100% content-to-description fidelity.
 24. **Multi-Source Knowledge Discovery**: The discovery engine MUST be extensible beyond social media. 
     - **Engineering Blogs**: High-depth technical content from engineering blogs (via RSS/Atom) MUST be prioritized for high-impact dimensions.
     - **Source Diversity**: Monitor X.com, GitHub Trending, and RSS Feeds to maintain a balanced flow of technical news and architectural deep-dives.
diff --git a/README.md b/README.md
index 05e66936..1deee799 100644
--- a/README.md
+++ b/README.md
@@ -991,6 +991,8 @@ To maintain transparency and ease of navigation, all key configuration, database
 - **Orchestration Core:** [`src/main.py`](src/main.py) - Master coordinator for discovery and evaluation.
 - **Curator Logic:** [`src/agentic_curator.py`](src/agentic_curator.py) - Primary classification and description engine.
 - **V2 Vision Engine:** [`src/v2_optimizer.py`](src/v2_optimizer.py) - Elite portal generation and maturity scoring.
+- **Video Hub Enrichment:** [`src/enrich_videos.py`](src/enrich_videos.py) - YouTube metadata extraction and AI synthesis.
+- **Video Portal Logic:** [`src/v2_video_portal.py`](src/v2_video_portal.py) - Categorized layout and O'Reilly journey builder.
 - **V2 Specialized Agents:**
     - **Health Monitor:** [`src/v2_health.py`](src/v2_health.py)
     - **Metadata Engine:** [`src/v2_metadata.py`](src/v2_metadata.py)
@@ -1045,3 +1047,4 @@ The technical resources (links, articles, videos) curated in this archive are th
 
 ### 15.3. Legal Disclaimer
 The information provided in this repository is for educational and professional reference purposes only. While our Agentic AI ensures high-fidelity curation, users should verify production configurations against official vendor documentation (AWS, Red Hat, CNCF) before deployment.
+t official vendor documentation (AWS, Red Hat, CNCF) before deployment.