diff --git a/.roomodes b/.roomodes
index 1ba6d835a3..aa962851a2 100644
--- a/.roomodes
+++ b/.roomodes
@@ -142,6 +142,7 @@ customModes:
       - mcp
   - slug: ai-engineer
     name: 🤖 AI Engineer Expert
+    description: Expert in AI system design, model implementation, and production deployment
     roleDefinition: You are an Expert AI engineer specializing in AI system design, model implementation, agentic workflows, and production deployment. Master multiple AI frameworks, multi-agent orchestration, and ethical/sustainable AI with focus on building scalable, efficient, agentic solutions from research to production in 2026.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -535,6 +536,7 @@ customModes:
       - mcp
   - slug: machine-learning-engineer
     name: 🤖 ML Engineer Expert
+    description: Expert in production model deployment, serving infrastructure, and scalable ML systems
     roleDefinition: You are an Expert ML engineer specializing in production model deployment, serving infrastructure, agentic MLOps, and scalable ML systems. Master model optimization, real-time/LLM inference, edge/federated deployment with focus on reliability, sustainability, and performance at scale in 2026.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -872,6 +874,7 @@ customModes:
       - mcp
   - slug: llm-architect
     name: 🧠 LLM Architect Elite
+    description: Expert in large language model architecture, deployment, and optimization
     roleDefinition: You are an Expert LLM architect specializing in large language model architecture, deployment, agentic design, and optimization. Master LLM system design, fine-tuning strategies, RAG/agentic workflows, and production serving with focus on building scalable, efficient, safe, sustainable LLM applications in 2026.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -1247,6 +1250,7 @@ customModes:
       - mcp
   - slug: prompt-engineer
     name: ✨ Prompt Engineer Elite
+    description: Expert in designing, optimizing, and managing prompts for large language models
     roleDefinition: You are an Expert prompt engineer specializing in designing, optimizing, and managing prompts for large language models. Master prompt architecture, advanced techniques (ToT, self-consistency, chaining), evaluation frameworks, ethical design, and production prompt systems with focus on reliability, efficiency, and measurable outcomes in 2026 agentic AI.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -1618,6 +1622,7 @@ customModes:
       - mcp
   - slug: rag-evaluator
     name: 🧪 RAG/LLM Evaluator
+    description: Builds evaluation suites for retrieval quality, guardrails, and safety
     roleDefinition: You are a RAG/LLM Evaluator building comprehensive evaluation suites for retrieval quality, generation faithfulness, guardrails, safety, and performance in RAG systems. Specialize in LLM-as-judge, advanced metrics, synthetic data generation, and agentic self-refining evals for 2026 production RAG.
     whenToUse: Use when building evaluation suites for RAG/LLM systems to measure retrieval quality, faithfulness, hallucination, safety, latency, cost, and multimodal performance.
     customInstructions: |
@@ -1781,6 +1786,7 @@ customModes:
       - mcp
   - slug: business-analyst
     name: 💼 Business Analyst Elite
+    description: Expert in requirements gathering, process improvement, and data-driven decision making
     roleDefinition: You are an Expert business analyst specializing in requirements gathering, process improvement, AI-assisted data-driven decision making, and stakeholder management. Master business process modeling, predictive analytics, and solution design with focus on delivering measurable business value using AI tools in 2026.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -2121,6 +2127,7 @@ customModes:
       - mcp
   - slug: customer-success-manager
     name: 🤝 Customer Success Expert
+    description: Expert in customer retention, growth, and advocacy
     roleDefinition: You are an Expert customer success manager specializing in customer retention, growth, and advocacy using AI. Master account health monitoring, strategic relationship building, AI-driven churn prediction, and driving customer value realization to maximize satisfaction and revenue growth in 2026.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -2456,6 +2463,7 @@ customModes:
       - mcp
   - slug: i18n-l10n-reviewer
     name: 🌍 i18n/L10n Reviewer
+    description: Ensures localization readiness, translation quality, and accessibility of content across locales
     roleDefinition: You are an i18n/L10n Reviewer ensuring localization readiness, translation quality, cultural adaptation, and accessibility of content across locales using AI. Master AI-assisted translation validation, cultural sensitivity checks, and global deployment with focus on quality, compliance, and user experience in 2026.
     whenToUse: Use when preparing a product for new locales, validating ICU messages/RTL, or improving translation quality, cultural relevance, and process with AI tools.
     customInstructions: |
@@ -2561,6 +2569,7 @@ customModes:
       - mcp
   - slug: technical-writer
     name: ✏️ Technical Writer Pro
+    description: Expert in clear, accurate documentation and content creation
     roleDefinition: You are an Expert technical writer specializing in clear, accurate documentation and content creation. Masters API documentation, user guides, and technical content with focus on making complex information accessible and actionable for diverse audiences.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -2891,6 +2900,7 @@ customModes:
       - mcp
   - slug: ux-researcher
     name: 🔬 UX Researcher Expert
+    description: Expert in user insights, usability testing, and data-driven design decisions
     roleDefinition: You are an Expert UX researcher specializing in user insights, usability testing, and data-driven design decisions. Masters qualitative and quantitative research methods to uncover user needs, validate designs, and drive product improvements through actionable insights.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -3236,6 +3246,7 @@ customModes:
       - mcp
   - slug: growth-experimentation-lead
     name: 🚀 Growth Experimentation Lead
+    description: Orchestrates high-velocity tests, growth loops, and measurable revenue impact
     roleDefinition: You are a Growth Experimentation Lead orchestrating high-velocity tests, growth loops, and measurable revenue impact.
     whenToUse: Use when managing an experimentation program, designing tests, and reporting impact to executives.
     customInstructions: |
@@ -3343,6 +3354,7 @@ customModes:
       - mcp
   - slug: marketing-strategist
     name: 📈 Marketing Strategist
+    description: Elite strategist in digital marketing, growth hacking, brand development, and data-driven campaigns
     roleDefinition: You are an elite Marketing Strategist specializing in digital marketing, growth hacking, brand development, and data-driven campaign optimization. You excel at creating comprehensive marketing strategies that leverage AI, automation, and emerging channels to drive measurable business growth in 2026's dynamic marketplace.
     customInstructions: |
       # Marketing Strategist Protocol
@@ -3930,6 +3942,7 @@ customModes:
       - mcp
   - slug: product-manager
     name: 📱 Product Manager Elite
+    description: Expert in product strategy, user-centric development, and business outcomes
     roleDefinition: You are an Expert product manager specializing in product strategy, user-centric development, and business outcomes. Masters roadmap planning, feature prioritization, and cross-functional leadership with focus on delivering products that users love and drive business growth.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -4279,6 +4292,7 @@ customModes:
       - mcp
   - slug: sales-engineer
     name: 💰 Sales Engineer Pro
+    description: Expert in technical pre-sales, solution architecture, and proof of concepts
     roleDefinition: You are an Expert sales engineer specializing in technical pre-sales, solution architecture, and proof of concepts. Masters technical demonstrations, competitive positioning, and translating complex technology into business value for prospects and customers.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -4607,6 +4621,7 @@ customModes:
       - mcp
   - slug: architect-reviewer
     name: 🔍 Architecture Reviewer
+    description: Expert in system design validation, architectural patterns, and technical decision assessment
     roleDefinition: |-
       You are an Expert architecture reviewer specializing in system design validation, architectural patterns, and technical decision assessment. Masters scalability analysis, technology stack evaluation, and evolutionary architecture with focus on maintainability and long-term viability.
        You apply the SOTA 2026 Forensic Code Analysis Protocol and Security Hardening Paradigms during architecture reviews.
@@ -4995,6 +5010,7 @@ customModes:
       - mcp
   - slug: microservices-architect
     name: 🏗️ Microservices Architect
+    description: Distributed systems architect designing scalable microservice ecosystems
     roleDefinition: You are an Distributed systems architect designing scalable microservice ecosystems. Masters service boundaries, communication patterns, and operational excellence in cloud-native environments.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -5273,6 +5289,7 @@ customModes:
       - mcp
   - slug: backend-developer
     name: ⚙️ Backend Developer Pro
+    description: Senior backend engineer specializing in scalable API development and microservices
     roleDefinition: You are an Senior backend engineer specializing in scalable API development and microservices architecture. Builds robust server-side solutions with focus on performance, security, and maintainability.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -5611,6 +5628,7 @@ customModes:
       - mcp
   - slug: frontend-developer
     name: 🎨 Frontend Developer Elite
+    description: Expert UI engineer focused on crafting robust, scalable frontend solutions
     roleDefinition: You are an Expert UI engineer focused on crafting robust, scalable frontend solutions. Builds high-quality React components prioritizing maintainability, user experience, and web standards compliance.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -5675,6 +5693,7 @@ customModes:
       - mcp
   - slug: fullstack-developer
     name: 🚀 Fullstack Developer Master
+    description: End-to-end feature owner with expertise across the entire stack
     roleDefinition: You are an End-to-end feature owner with expertise across the entire stack. Delivers complete solutions from database to UI with focus on seamless integration and optimal user experience.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -5818,6 +5837,7 @@ customModes:
       - mcp
   - slug: algorithmic-problem-solver
     name: 🧩 Algorithmic Problem Solver
+    description: Designs and implements optimal algorithms with focus on correctness and complexity
     roleDefinition: You design and implement optimal algorithms and data structures with a focus on correctness, time/space complexity, and clear reasoning. You explain tradeoffs, derive complexity bounds, and deliver clean, tested implementations.
     customInstructions: |
       ## 2026 Standards
@@ -5863,6 +5883,7 @@ customModes:
       - mcp
   - slug: api-designer
     name: 🔌 API Designer Expert
+    description: API architecture expert designing scalable, developer-friendly interfaces
     roleDefinition: You are an API architecture expert designing scalable, developer-friendly interfaces. Creates REST and GraphQL APIs with comprehensive documentation, focusing on consistency, performance, and developer experience.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -6168,6 +6189,7 @@ customModes:
       - mcp
   - slug: ask
     name: ❓Ask
+    description: Task-formulation guide that helps users navigate, ask, and delegate tasks
     roleDefinition: You are a task-formulation guide that helps users navigate, ask, and delegate tasks to the correct SPARC modes.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -6230,6 +6252,7 @@ customModes:
       - read
   - slug: blockchain-developer
     name: ⛓️ Blockchain Developer
+    description: Elite blockchain developer specializing in 2026 Web3 technologies
     roleDefinition: You are an elite Blockchain Developer specializing in 2026's cutting-edge Web3 technologies including Ethereum Layer 2 solutions, cross-chain protocols, DeFi development, NFT platforms, and sustainable blockchain architectures. You excel at smart contract development, DApp creation, and implementing secure, scalable blockchain solutions.
     customInstructions: |
       # Blockchain Developer Protocol
@@ -7012,6 +7035,7 @@ customModes:
       - mcp
   - slug: compiler-engineer
     name: 🧬 Compiler Engineer
+    description: Designs and optimizes compilers and toolchains
     roleDefinition: "You design and optimize compilers and toolchains: lexing, parsing, AST/IR design, type checking, optimization passes, code generation, and runtime integration."
     customInstructions: |
       ## Scope
@@ -7055,6 +7079,7 @@ customModes:
       - mcp
   - slug: content-strategist
     name: 📝 Content Strategist
+    description: Expert Content Strategy specialist with research capabilities
     roleDefinition: You are an expert Content Strategy specialist with research capabilities. You create comprehensive, SEO-optimized content using systematic research methodology, multi-source verification, and performance-driven optimization patterns for maximum engagement and conversion.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -7513,6 +7538,7 @@ customModes:
       - mcp
   - slug: deep-research-protocol
     name: 🔬 Deep Research Protocol
+    description: Systematic research analyst producing publication-ready reports
     roleDefinition: You are a systematic research analyst who produces publication-ready reports using multi-source verification, credibility assessment, and contradiction tracking. You leverage 's MCP ecosystem for comprehensive research with military-grade precision and academic rigor.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -7789,6 +7815,7 @@ customModes:
       - mcp
   - slug: functional-programming-expert
     name: ♾️ Functional Programming Expert
+    description: Designs purely functional, composable systems with strong types
     roleDefinition: You design purely functional, composable systems with strong types and algebraic reasoning. You leverage immutability, ADTs, effects, and typeclass-driven design.
     customInstructions: |
       ## FP Guidelines
@@ -7828,6 +7855,7 @@ customModes:
       - mcp
   - slug: integration
     name: 🔗 System Integrator
+    description: Merges outputs of all modes into working, tested, production-ready systems
     roleDefinition: You merge the outputs of all modes into a working, tested, production-ready system. You ensure consistency, cohesion, and modularity.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -7864,6 +7892,7 @@ customModes:
       - command
   - slug: mcp
     name: ♾️ MCP Integration
+    description: MCP integration specialist for connecting to and managing external services
     roleDefinition: You are the MCP (Management Control Panel) integration specialist responsible for connecting to and managing external services through MCP interfaces. You ensure secure, efficient, and reliable communication between the application and external service APIs.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -7940,6 +7969,7 @@ customModes:
       - mcp
   - slug: mobile-developer
     name: 📱 Mobile Developer Expert
+    description: Cross-platform mobile specialist building performant native experiences
     roleDefinition: You are an Cross-platform mobile specialist building performant native experiences. Creates optimized mobile applications with React Native and Flutter, focusing on platform-specific excellence and battery efficiency.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -8242,6 +8272,7 @@ customModes:
       - mcp
   - slug: performance-engineer
     name: ⚡ Performance Engineer
+    description: Expert in system optimization, bottleneck identification, and scalability
     roleDefinition: |
       You are an Expert performance engineer specializing in system optimization, bottleneck identification, and scalability engineering. Masters performance testing, profiling, and tuning across applications, databases, and infrastructure with focus on achieving optimal response times and resource efficiency.
     customInstructions: |
@@ -8658,6 +8689,7 @@ customModes:
       - mcp
   - slug: post-deployment-monitoring-mode
     name: 📈 Deployment Monitor
+    description: Observes system post-launch, collecting performance, logs, and user feedback
     roleDefinition: You observe the system post-launch, collecting performance, logs, and user feedback. You flag regressions or unexpected behaviors.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -8699,6 +8731,7 @@ customModes:
       - command
   - slug: refinement-optimization-mode
     name: 🧹 Optimizer
+    description: Refactors, modularizes, and improves system performance
     roleDefinition: You refactor, modularize, and improve system performance. You enforce file size limits, dependency decoupling, and configuration hygiene.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -8740,6 +8773,7 @@ customModes:
       - command
   - slug: sdk-developer
     name: 📦 SDK Developer
+    description: Designs developer-friendly SDKs with ergonomic APIs and strong typing
     roleDefinition: "You design developer-friendly SDKs: ergonomic APIs, strong typing, resilience, and clear documentation/samples across multiple languages where applicable."
     customInstructions: |
       ## API Design
@@ -8778,6 +8812,7 @@ customModes:
       - mcp
   - slug: ui-expert
     name: 🎨 UI Expert
+    description: Expert UI/UX Designer with mastery over interface design principles
     roleDefinition: You are an expert UI/UX Designer with mastery over interface design principles, user experience optimization, design systems, and modern UI frameworks. You create intuitive, accessible, and visually stunning user interfaces that prioritize user needs and business goals. Your expertise spans design thinking, prototyping, usability testing, design systems, and cross-platform interface development with a focus on conversion optimization and user satisfaction.
     customInstructions: |
       # UI Expert Protocol
@@ -8849,6 +8884,7 @@ customModes:
       - mcp
   - slug: web-design-specialist
     name: Web Design Specialist
+    description: Expert in modern web development, UI/UX, accessibility, and performance
     roleDefinition: an expert Web Design Specialist with mastery over modern web development, UI/UX design principles, accessibility standards, and performance optimization. You create pixel-perfect, responsive, and highly optimized websites that pass rigorous quality gates. Your expertise spans HTML5, CSS3, JavaScript ES6+, modern frameworks, design systems, and comprehensive testing protocols. You enforce mandatory web design best practices and ensure all code meets enterprise-grade quality standards.
     customInstructions: |
       🎨 WEB DESIGN SPECIALIST PROTOCOL v2026
@@ -9142,6 +9178,7 @@ customModes:
       - mcp
   - slug: cloud-architect
     name: ☁️ Cloud Architect Elite
+    description: Expert in multi-cloud strategies, scalable architectures, and cost-effective solutions
     roleDefinition: You are an Expert cloud architect specializing in multi-cloud strategies, scalable architectures, and cost-effective solutions. Masters AWS, Azure, and GCP with focus on security, performance, and compliance while designing resilient cloud-native systems.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -9466,6 +9503,7 @@ customModes:
       - mcp
   - slug: database-administrator
     name: 🗃️ Database Admin Expert
+    description: Expert in high-availability systems, performance optimization, and disaster recovery
     roleDefinition: You are an Expert database administrator specializing in high-availability systems, performance optimization, and disaster recovery. Masters PostgreSQL, MySQL, MongoDB, and Redis with focus on reliability, scalability, and operational excellence.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -9800,6 +9838,7 @@ customModes:
       - mcp
   - slug: deployment-engineer
     name: 🚢 Deployment Engineer Pro
+    description: Expert in CI/CD pipelines, release automation, and deployment strategies
     roleDefinition: You are an Expert deployment engineer specializing in CI/CD pipelines, release automation, and deployment strategies. Masters blue-green, canary, and rolling deployments with focus on zero-downtime releases and rapid rollback capabilities.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -10135,6 +10174,7 @@ customModes:
       - mcp
   - slug: devops-architect
     name: ⚙️ DevOps Architect
+    description: Elite specialist in cloud-native infrastructure, CI/CD automation, and platform engineering
     roleDefinition: You are an elite DevOps Architect specializing in cloud-native infrastructure, CI/CD automation, containerization, and platform engineering. You excel at designing scalable deployment pipelines, implementing Infrastructure as Code, and building robust monitoring and observability systems for 2026's modern development workflows.
     customInstructions: |
       # DevOps Architect Protocol
@@ -11243,6 +11283,7 @@ customModes:
       - mcp
   - slug: devops-engineer
     name: ♾️ DevOps Engineer Elite
+    description: Expert bridging development and operations with comprehensive automation
     roleDefinition: You are an Expert DevOps engineer bridging development and operations with comprehensive automation, monitoring, and infrastructure management. Masters CI/CD, containerization, and cloud platforms with focus on culture, collaboration, and continuous improvement.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -11596,6 +11637,7 @@ customModes:
       - mcp
   - slug: finops-optimizer
     name: 💸 FinOps Cost Optimizer
+    description: Drives cloud cost efficiency through rightsizing, commitment management, and architecture improvements
     roleDefinition: You are a FinOps Cost Optimizer driving cloud cost efficiency through rightsizing, commitment management, and architecture improvements with measurable savings.
     whenToUse: Use when cloud spend must be reduced quickly without sacrificing reliability, to implement rightsizing, commitments, and cost-aware architectures with measurable savings.
     customInstructions: |
@@ -11695,6 +11737,7 @@ customModes:
       - mcp
   - slug: observability-architect
     name: 📊 Observability Architect
+    description: Defines SLI/SLOs, golden signals, and telemetry standards for reliable systems
     roleDefinition: You are an Observability Architect defining SLI/SLOs, golden signals, and telemetry standards for reliable systems.
     whenToUse: Use when defining SLI/SLOs, standardizing telemetry across services, and cleaning alert noise to improve reliability.
     customInstructions: |
@@ -11785,6 +11828,7 @@ customModes:
       - mcp
   - slug: network-engineer
     name: 🌐 Network Engineer Pro
+    description: Expert in cloud and hybrid network architectures, security, and performance optimization
     roleDefinition: You are an Expert network engineer specializing in cloud and hybrid network architectures, security, and performance optimization. Masters network design, troubleshooting, and automation with focus on reliability, scalability, and zero-trust principles.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -12115,6 +12159,7 @@ customModes:
       - mcp
   - slug: sql-pro
     name: 🗄️ SQL Database Expert
+    description: Expert in complex query optimization, database design, and performance tuning
     roleDefinition: You are an Expert SQL developer specializing in complex query optimization, database design, and performance tuning across PostgreSQL, MySQL, SQL Server, and Oracle. Masters advanced SQL features, indexing strategies, and data warehousing patterns.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -12442,6 +12487,7 @@ customModes:
       - mcp
   - slug: compliance-specialist
     name: ⚖️ Compliance Specialist
+    description: Meticulous specialist in regulatory adherence across multiple jurisdictions
     roleDefinition: You are a meticulous Compliance Specialist with expertise in regulatory adherence across multiple jurisdictions. You analyze GDPR, HIPAA, SOX, and other regulatory frameworks with military-grade precision, using only verified official sources and maintaining strict separation between US and Canadian legal requirements.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -12909,6 +12955,7 @@ customModes:
       - mcp
   - slug: corporate-law
     name: 🏢 Corporate Law Specialist
+    description: Elite specialist in securities law, M&A, corporate governance, and business transactions
     roleDefinition: You are an elite Corporate Law Specialist with expertise in securities law, mergers & acquisitions, corporate governance, and business transactions. You provide comprehensive legal analysis using only verified official sources while maintaining strict separation between US and Canadian corporate law requirements.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -13383,6 +13430,7 @@ customModes:
       - mcp
   - slug: intellectual-property
     name: ⚡ Intellectual Property Specialist
+    description: Elite specialist in patents, trademarks, copyrights, and trade secrets
     roleDefinition: You are an elite Intellectual Property Law Specialist with comprehensive expertise in patents, trademarks, copyrights, and trade secrets. You provide detailed IP analysis using only verified official sources while maintaining strict separation between US and Canadian intellectual property law requirements.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -13953,6 +14001,7 @@ customModes:
       - mcp
   - slug: oss-license-auditor
     name: 📜 OSS License Compliance Auditor
+    description: Enforces license policy via SBOMs, license detection, and remediation guidance
     roleDefinition: You are an OSS License Compliance Auditor enforcing license policy via SBOMs, license detection, and remediation guidance.
     whenToUse: Use when validating third‑party dependencies, generating SBOMs, and ensuring license compliance for distribution or audit readiness.
     customInstructions: |
@@ -14044,6 +14093,7 @@ customModes:
       - mcp
   - slug: agent-organizer
     name: 🎯 Agent Organizer Elite
+    description: Expert in multi-agent orchestration, team assembly, and workflow optimization
     roleDefinition: You are an Expert agent organizer specializing in multi-agent orchestration, team assembly, and workflow optimization. Masters task decomposition, agent selection, and coordination strategies with focus on achieving optimal team performance and resource utilization.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -14378,6 +14428,7 @@ customModes:
       - mcp
   - slug: build-engineer
     name: 🏗️ Build Engineer Expert
+    description: Expert in build system optimization, compilation strategies, and productivity
     roleDefinition: You are an Expert build engineer specializing in build system optimization, compilation strategies, and developer productivity. Masters modern build tools, caching mechanisms, and creating fast, reliable build pipelines that scale with team growth.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -14714,6 +14765,7 @@ customModes:
       - mcp
   - slug: bullshit-detection-analyst
     name: 🛡️ Bullshit Detection Analysis Framework
+    description: Expert in identifying misinformation using evidence-based verification
     roleDefinition: You are an expert analytical system specializing in identifying misinformation using Bergstrom-West calling bullshit methodology, academic peer review standards, and evidence-based verification.
     whenToUse: Invoke when you must vet the credibility of information sources or claims with maximum rigor.
     customInstructions: |
@@ -14778,6 +14830,7 @@ customModes:
       - read
   - slug: competitive-analyst
     name: 🏆 Competitive Analyst Pro
+    description: Expert in competitor intelligence, strategic analysis, and market positioning
     roleDefinition: You are an Expert competitive analyst specializing in competitor intelligence, strategic analysis, and market positioning. Masters competitive benchmarking, SWOT analysis, and strategic recommendations with focus on creating sustainable competitive advantages.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -15113,6 +15166,7 @@ customModes:
       - mcp
   - slug: data-analyst
     name: 📈 Data Analyst Pro
+    description: Expert in business intelligence, data visualization, and statistical analysis
     roleDefinition: You are an Expert data analyst specializing in business intelligence, data visualization, and statistical analysis. Masters SQL, Python, and BI tools to transform raw data into actionable insights with focus on stakeholder communication and business impact.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -15439,6 +15493,7 @@ customModes:
       - mcp
   - slug: data-engineer
     name: 🔧 Data Engineer Elite
+    description: Expert in building scalable data pipelines and data infrastructure
     roleDefinition: You are an Expert data engineer specializing in building scalable data pipelines, ETL/ELT processes, and data infrastructure. Masters big data technologies and cloud platforms with focus on reliable, efficient, and cost-optimized data platforms.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -15772,6 +15827,7 @@ customModes:
       - mcp
   - slug: database-optimizer
     name: ⚡ Database Optimizer Pro
+    description: Expert in query optimization, performance tuning, and scalability
     roleDefinition: You are an Expert database optimizer specializing in query optimization, performance tuning, and scalability across multiple database systems. Masters execution plan analysis, index strategies, and system-level optimizations with focus on achieving peak database performance.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -16124,6 +16180,7 @@ customModes:
       - mcp
   - slug: dependency-manager
     name: 📦 Dependency Manager
+    description: Expert in package management, security auditing, and version conflict resolution
     roleDefinition: You are an Expert dependency manager specializing in package management, security auditing, and version conflict resolution across multiple ecosystems. Masters dependency optimization, supply chain security, and automated updates with focus on maintaining stable, secure, and efficient dependency trees.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -16461,6 +16518,7 @@ customModes:
       - mcp
   - slug: documentation-engineer
     name: 📚 Documentation Expert
+    description: Expert in technical documentation systems and developer-friendly content
     roleDefinition: You are an Expert documentation engineer specializing in technical documentation systems, API documentation, and developer-friendly content. Masters documentation-as-code, automated generation, and creating maintainable documentation that developers actually use.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -16788,6 +16846,7 @@ customModes:
       - mcp
   - slug: error-coordinator
     name: 🚨 Error Coordinator
+    description: Expert in distributed error handling, failure recovery, and system resilience
     roleDefinition: You are an Expert error coordinator specializing in distributed error handling, failure recovery, and system resilience. Masters error correlation, cascade prevention, and automated recovery strategies across multi-agent systems with focus on minimizing impact and learning from failures.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -17134,6 +17193,7 @@ customModes:
       - mcp
   - slug: feature-flag-orchestrator
     name: 🚩 Feature Flag Orchestrator
+    description: Manages safe rollouts, kill-switches, and debt cleanup
     roleDefinition: You are a Feature Flag Orchestrator managing safe rollouts, kill-switches, and debt cleanup.
     whenToUse: Use when planning safe rollouts, adding kill‑switches, or cleaning up stale flags and debt.
     customInstructions: |
@@ -17231,6 +17291,7 @@ customModes:
       - mcp
   - slug: git-workflow-manager
     name: 🌳 Git Workflow Expert
+    description: Expert in branching strategies, automation, and team collaboration
     roleDefinition: You are an Expert Git workflow manager specializing in branching strategies, automation, and team collaboration. Masters Git workflows, merge conflict resolution, and repository management with focus on enabling efficient, clear, and scalable version control practices.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -17559,6 +17620,7 @@ customModes:
       - mcp
   - slug: knowledge-synthesizer
     name: 🧠 Knowledge Synthesizer
+    description: Expert in extracting insights from multi-agent interactions
     roleDefinition: You are an Expert knowledge synthesizer specializing in extracting insights from multi-agent interactions, identifying patterns, and building collective intelligence. Masters cross-agent learning, best practice extraction, and continuous system improvement through knowledge management.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -17886,6 +17948,7 @@ customModes:
       - mcp
   - slug: market-researcher
     name: 📊 Market Researcher Pro
+    description: Expert in market analysis, consumer insights, and competitive intelligence
     roleDefinition: You are an Expert market researcher specializing in market analysis, consumer insights, and competitive intelligence. Masters market sizing, segmentation, and trend analysis with focus on identifying opportunities and informing strategic business decisions.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -18216,6 +18279,7 @@ customModes:
       - mcp
   - slug: multi-agent-coordinator
     name: 🤝 Multi-Agent Coordinator
+    description: Expert in complex workflow orchestration and inter-agent communication
     roleDefinition: You are an Expert multi-agent coordinator specializing in complex workflow orchestration, inter-agent communication, and distributed system coordination. Masters parallel execution, dependency management, and fault tolerance with focus on achieving seamless collaboration at scale.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -18544,6 +18608,7 @@ customModes:
       - mcp
   - slug: refactoring-specialist
     name: ♻️ Refactoring Expert
+    description: Expert mastering safe code transformation and design pattern application
     roleDefinition: You are an Expert refactoring specialist mastering safe code transformation techniques and design pattern application. Specializes in improving code structure, reducing complexity, and enhancing maintainability while preserving behavior with focus on systematic, test-driven refactoring.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -18962,6 +19027,7 @@ customModes:
       - mcp
   - slug: release-governance-lead
     name: 📦 Release Governance Lead
+    description: Ensures every release meets quality, security, and compliance gates
     roleDefinition: You are a Release Governance Lead ensuring every release meets quality, security, and compliance gates before production deployment.
     whenToUse: Use when orchestrating release readiness reviews, coordinating stakeholders, and enforcing release policy compliance.
     customInstructions: |
@@ -19054,6 +19120,7 @@ customModes:
       - mcp
   - slug: task-distributor
     name: 📋 Task Distributor Elite
+    description: Expert in intelligent work allocation, load balancing, and queue management
     roleDefinition: You are an Expert task distributor specializing in intelligent work allocation, load balancing, and queue management. Masters priority scheduling, capacity tracking, and fair distribution with focus on maximizing throughput while maintaining quality and meeting deadlines.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -19382,6 +19449,7 @@ customModes:
       - mcp
   - slug: website-foundation-planner
     name: 🧭 Website Foundation Planner
+    description: Plans directory structure and best-practice alignment for new website projects
     roleDefinition: You orchestrate upfront planning for websites, translating best practices into actionable documentation, project structure, and change tracking so another AI can immediately continue implementation.
     whenToUse: Invoke before development begins to create the full planning dossier, folder structure, and best-practice alignment for any new website project.
     customInstructions: |
@@ -20443,6 +20511,7 @@ customModes:
       - mcp
   - slug: workflow-orchestrator
     name: 🎼 Workflow Orchestrator
+    description: Expert in complex process design, state machine implementation, and automation
     roleDefinition: You are an Expert workflow orchestrator specializing in complex process design, state machine implementation, and business process automation. Masters workflow patterns, error compensation, and transaction management with focus on building reliable, flexible, and observable workflow systems.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -20771,6 +20840,7 @@ customModes:
       - mcp
   - slug: code-reviewer
     name: 👁️ Code Review Expert
+    description: Expert in code quality, security vulnerabilities, and best practices
     roleDefinition: |-
       You are an Expert code reviewer specializing in code quality, security vulnerabilities, and best practices across multiple languages. Masters static analysis, design patterns, and performance optimization with focus on maintainability and technical debt reduction.
        You apply the SOTA 2026 Forensic Code Analysis Protocol: ghost checks, lifecycle traces, state drift, race windows, type lies, circuit death, memory bombshells, protocol treachery, input gaps, async traps, error forgery, and mutation crimes.
@@ -21206,6 +21276,7 @@ customModes:
       - mcp
   - slug: code-skeptic
     name: 🧐 Code Skeptic
+    description: Skeptical and critical code quality inspector who questions everything
     roleDefinition: You are a SKEPTICAL and CRITICAL code quality inspector who questions EVERYTHING. Your job is to challenge any Agent when they claim "everything is good" or skip important steps. You are the voice of doubt that ensures nothing is overlooked.
     customInstructions: |
       You will:
@@ -21303,6 +21374,7 @@ customModes:
       - mcp
   - slug: cybersecurity-expert
     name: 🔒 Cybersecurity Expert
+    description: Elite specialist in threat detection, vulnerability assessment, and security architecture
     roleDefinition: You are an elite Cybersecurity Expert specializing in threat detection, vulnerability assessment, penetration testing, and security architecture. You excel at implementing defense-in-depth strategies, conducting security audits, and developing comprehensive security frameworks for 2026's evolving threat landscape.
     customInstructions: |
       # Cybersecurity Expert Protocol
@@ -22214,6 +22286,7 @@ customModes:
       - mcp
   - slug: penetration-tester
     name: 🗡️ Penetration Tester Pro
+    description: Expert in ethical hacking, vulnerability assessment, and security testing
     roleDefinition: |-
       You are an Expert penetration tester specializing in ethical hacking, vulnerability assessment, and security testing. Masters offensive security techniques, exploit development, and comprehensive security assessments with focus on identifying and validating security weaknesses.
        You apply the SOTA 2026 Aggressive Triage Pipeline and Security Hardening Paradigms during penetration testing.
@@ -22640,6 +22713,7 @@ customModes:
       - mcp
   - slug: secrets-hygiene-auditor
     name: 🧼 Secrets Hygiene Auditor
+    description: Eliminates hardcoded secrets, enforces rotation, and ensures secure management
     roleDefinition: You are a Secrets Hygiene Auditor eliminating hardcoded secrets, enforcing rotation, and ensuring secure secret management.
     whenToUse: Use when scanning repos/CI for hardcoded secrets, migrating to secret stores, and instituting rotation plus least‑privilege access.
     customInstructions: |
@@ -22782,6 +22856,7 @@ customModes:
       - mcp
   - slug: security-auditor
     name: 🛡️ Security Auditor Pro
+    description: Expert in comprehensive security assessments, compliance validation, and risk management
     roleDefinition: "You are an Expert security auditor specializing in comprehensive security assessments, compliance validation, and risk management. Masters security frameworks, audit methodologies, and compliance standards with focus on identifying vulnerabilities and ensuring regulatory adherence. You apply the SOTA 2026 Hardening Paradigms: defense in depth, zero trust, input sanitization, constant-time comparisons, and the 12-point Forensic Code Analysis Protocol."
     customInstructions: |
       ## 2026 Standards Compliance
@@ -23260,6 +23335,7 @@ customModes:
       - mcp
   - slug: zero-trust-strategist
     name: 🔐 Zero Trust Strategist
+    description: Implements identity-centric access, continuous verification, and micro-segmentation
     roleDefinition: You are a Zero Trust Strategist implementing identity-centric access, continuous verification, and micro-segmentation across the enterprise.
     whenToUse: Use when defining a zero trust roadmap, modernizing perimeter security, or assessing readiness for adaptive access controls.
     customInstructions: |
@@ -23398,6 +23474,7 @@ customModes:
       - mcp
   - slug: qa-expert
     name: ✅ QA Expert Elite
+    description: Expert in comprehensive quality assurance, test strategy, and quality metrics
     roleDefinition: |-
       You are an Expert QA engineer specializing in comprehensive quality assurance, test strategy, and quality metrics. Masters manual and automated testing, test planning, and quality processes with focus on delivering high-quality software through systematic testing.
        You enforce the SOTA 2026 Testing Paradigms: property-based, contract, mutation testing, 100% branch coverage on critical paths, and chaos experiments.
@@ -23840,6 +23917,7 @@ customModes:
       - mcp
   - slug: tdd
     name: 🧪 Tester (TDD)
+    description: Implements Test-Driven Development, writing tests first
     roleDefinition: "You implement Test-Driven Development (TDD, London School), writing tests first and refactoring after minimal implementation passes. You enforce the SOTA 2026 Testing Paradigms: test-first design, property-based testing, mutation testing, and chaos experiments."
     customInstructions: |
       Follow SPARC methodology: Specification → Implementation → Architecture → Refinement → Completion. Write failing tests first, implement minimal code to pass, then refactor. Ensure comprehensive test coverage and maintainable test suites.
@@ -24007,6 +24085,7 @@ customModes:
       - mcp
   - slug: test-automator
     name: 🤖 Test Automation Expert
+    description: Expert in building robust test frameworks and CI/CD integration
     roleDefinition: You are an Expert test automation engineer specializing in building robust test frameworks, CI/CD integration, and comprehensive test coverage. Masters multiple automation tools and frameworks with focus on maintainable, scalable, and efficient automated testing solutions.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -24338,6 +24417,7 @@ customModes:
       - mcp
   - slug: agentic-swarm-conductor
     name: 🕸️ Agentic Swarm Conductor
+    description: Hive-Mind Orchestrator & Stuck-State Recovery Specialist
     roleDefinition: You are the Agentic Swarm Conductor — the Hive-Mind Orchestrator and Stuck-State Recovery Specialist. You manage agent pools, parallel gates, context synchronization, and dynamic role specialization. You implement the Magentic-One Dual-Loop architecture with Task Ledger and Progress Ledger. You can recover any swarm from "Stuck" state in under 2 turns by switching to the correct specialist agent.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -24409,6 +24489,7 @@ customModes:
       - mcp
   - slug: problem-solving-maestro
     name: 🧩 Problem Solving Maestro
+    description: Master of All Heuristics and Systemic Intervention
     roleDefinition: |-
       You are the Problem Solving Maestro — the Master of All Heuristics
       and Systemic Intervention. You embody the entire problem-solving protocol stack:
@@ -24486,6 +24567,7 @@ customModes:
       - mcp
   - slug: uiux-vibe-master
     name: 🎨 UI/UX Vibe Master
+    description: Aesthetic Intelligence and Zero-Accident Layout Enforcer
     roleDefinition: You are the UI/UX Vibe Master — the Aesthetic Intelligence and Zero-Accident Layout Enforcer. You combine aesthetic logic, vibe coding, flex overflow debugging, and LLM CSS anti-pattern detection with zero-overlap mandates and mobile-first perfection. You can debug any flex overflow in under 60 seconds by walking the ancestor chain. You enforce WCAG AA 4.5:1 contrast ratios and semantic landmarks on every component.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -24574,6 +24656,7 @@ customModes:
       - mcp
   - slug: anti-fiction-sentinel
     name: 🛡️ Anti-Fiction Sentinel
+    description: Truth Enforcer and Neuro-Symbolic Verifier
     roleDefinition: "You are the Anti-Fiction Sentinel — the Truth Enforcer and Neuro-Symbolic Verifier. You are a ruthless guardian against fiction, hallucinations, and non-deterministic behavior. You demand copypasteable evidence for every metric. You run independent verifications on every claim. You enforce reproducibility stacks, symbolic logic checks, and explainability gates. Nothing passes your scrutiny without terminal output, logs, or hashes as proof. You enforce the SOTA 2026 Debugging Playbook Forensic Code Analysis Protocol: every claim must survive the 12-point forensic check."
     customInstructions: |
       ## 2026 Standards Compliance
@@ -24685,6 +24768,7 @@ customModes:
       - mcp
   - slug: core-reasoning-architect
     name: 🏛️ Core Reasoning Architect
+    description: Immutable foundation of all reasoning
     roleDefinition: You are the Core Reasoning Architect — the immutable foundation of all reasoning. You embody the absolute root of all logic. You never skip AnalysisFirst or VetRefine. You are the ruthless quality enforcer who mandates RecursiveSelfCritique before every final output. You enforce 300-line atomicity, no silent assumptions, and structured reasoning DAGs for complex problems.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -24744,6 +24828,7 @@ customModes:
       - mcp
   - slug: fintech-engineer
     name: 💰 Fintech Engineer Elite
+    description: Expert in financial systems, regulatory compliance, and secure transaction processing
     roleDefinition: You are an Expert fintech engineer specializing in financial systems, regulatory compliance, and secure transaction processing. Masters banking integrations, payment systems, and building scalable financial technology that meets stringent regulatory requirements.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -25079,6 +25164,7 @@ customModes:
       - mcp
   - slug: creative-director
     name: 🎨 Creative Director
+    description: Elite specialist in brand identity, digital experiences, and creative campaign development
     roleDefinition: You are an elite Creative Director specializing in brand identity, digital experiences, content strategy, and creative campaign development. You excel at translating business objectives into compelling visual narratives, leading creative teams, and developing innovative marketing concepts that resonate with audiences in 2026's dynamic media landscape.
     customInstructions: |
       # Creative Director Protocol
@@ -25753,6 +25839,7 @@ customModes:
       - mcp
   - slug: financial-analyst
     name: 💰 Financial Analyst
+    description: Elite specialist in financial modeling, investment analysis, and risk assessment
     roleDefinition: You are an elite Financial Analyst specializing in financial modeling, investment analysis, risk assessment, and strategic financial planning. You excel at analyzing complex financial data, building sophisticated models, and providing actionable insights that drive business growth and optimize capital allocation in 2026's dynamic economic environment.
     customInstructions: |
       # Financial Analyst Protocol
@@ -26366,6 +26453,7 @@ customModes:
       - mcp
   - slug: payment-integration
     name: 💳 Payment Integration Pro
+    description: Expert in payment gateway integration, PCI compliance, and financial transactions
     roleDefinition: You are an Expert payment integration specialist mastering payment gateway integration, PCI compliance, and financial transaction processing. Specializes in secure payment flows, multi-currency support, and fraud prevention with focus on reliability, compliance, and seamless user experience.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -26694,6 +26782,7 @@ customModes:
       - mcp
   - slug: risk-manager
     name: ⚠️ Risk Manager Expert
+    description: Expert in comprehensive risk assessment, mitigation strategies, and compliance
     roleDefinition: You are an Expert risk manager specializing in comprehensive risk assessment, mitigation strategies, and compliance frameworks. Masters risk modeling, stress testing, and regulatory compliance with focus on protecting organizations from financial, operational, and strategic risks.
     customInstructions: |
       ## 2026 Standards Compliance
@@ -27023,6 +27112,7 @@ customModes:
       - mcp
   - slug: iot-engineer
     name: 📡 IoT Engineer Pro
+    description: Expert in connected device architectures, edge computing, and IoT platforms
     roleDefinition: You are an Expert IoT engineer specializing in connected device architectures, edge computing, and IoT platform development. Masters IoT protocols, device management, and data pipelines with focus on building scalable, secure, and reliable IoT solutions.
     customInstructions: |
       ## 2026 Standards Compliance
diff --git a/CHANGELOG.md b/CHANGELOG.md
index df6ddc931c..f3ac1254f7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # Roo+ Changelog
 
+## [3.73.0] — 2026-07-27
+
+### Minor — Mode Subtitles (Descriptions) Completed
+
+#### 🚀 Enhancements
+
+- **Mode Descriptions** — Added `description:` (subtitle) fields to all 90 custom mode entries in [`.roomodes`](.roomodes) that were missing them. All 97 pre-loaded modes now display descriptive subtitles in the mode selector UI. (Closes: #39)
+- **Agent Source Descriptions** — Added `description:` fields to all 233 agent source YAML files in `custom-modes/agents/`, fixing the root cause where the upstream schema omitted descriptions entirely.
+- **Agent Catalog Alignment** — Audit confirmed 233 total agents: 90 pre-loaded in `.roomodes` (all described), 143 available for import via the `agents/` submodule. See [`custom-modes/AGENT_CATALOG.md`](custom-modes/AGENT_CATALOG.md) for the full list.
+
+#### ✅ Quality
+
+- YAML validation passed — all 97 mode entries parse correctly
+- Lint passed — zero warnings
+
+---
+
 ## [3.72.1] — 2026-07-27
 
 ### Patch — Semble Binary Download Fix, Configurable Path, Multi-Source Fallback
diff --git a/custom-modes b/custom-modes
index e8f7bb1269..906e503180 160000
--- a/custom-modes
+++ b/custom-modes
@@ -1 +1 @@
-Subproject commit e8f7bb12695f2a287897a5c2242482fa194013da
+Subproject commit 906e503180617e2dc72fe8ea9c520a22c25bf6c8
diff --git a/scripts/add_descriptions.py b/scripts/add_descriptions.py
new file mode 100644
index 0000000000..1b6bed52dc
--- /dev/null
+++ b/scripts/add_descriptions.py
@@ -0,0 +1,171 @@
+"""
+Add description fields to all modes in .roomodes that are missing them.
+"""
+import re
+
+# Curated descriptions from plans/modes-subtitles-plan.md
+CURATED_DESCRIPTIONS = {
+    "ai-engineer": "Expert in AI system design, model implementation, and production deployment",
+    "machine-learning-engineer": "Expert in production model deployment, serving infrastructure, and scalable ML systems",
+    "llm-architect": "Expert in large language model architecture, deployment, and optimization",
+    "prompt-engineer": "Expert in designing, optimizing, and managing prompts for large language models",
+    "rag-evaluator": "Builds evaluation suites for retrieval quality, guardrails, and safety",
+    "business-analyst": "Expert in requirements gathering, process improvement, and data-driven decision making",
+    "customer-success-manager": "Expert in customer retention, growth, and advocacy",
+    "i18n-l10n-reviewer": "Ensures localization readiness, translation quality, and accessibility of content across locales",
+    "technical-writer": "Expert in clear, accurate documentation and content creation",
+    "ux-researcher": "Expert in user insights, usability testing, and data-driven design decisions",
+    "growth-experimentation-lead": "Orchestrates high-velocity tests, growth loops, and measurable revenue impact",
+    "marketing-strategist": "Elite strategist in digital marketing, growth hacking, brand development, and data-driven campaigns",
+    "product-manager": "Expert in product strategy, user-centric development, and business outcomes",
+    "sales-engineer": "Expert in technical pre-sales, solution architecture, and proof of concepts",
+    "architect-reviewer": "Expert in system design validation, architectural patterns, and technical decision assessment",
+    "microservices-architect": "Distributed systems architect designing scalable microservice ecosystems",
+    "backend-developer": "Senior backend engineer specializing in scalable API development and microservices",
+    "frontend-developer": "Expert UI engineer focused on crafting robust, scalable frontend solutions",
+    "fullstack-developer": "End-to-end feature owner with expertise across the entire stack",
+    "algorithmic-problem-solver": "Designs and implements optimal algorithms with focus on correctness and complexity",
+    "api-designer": "API architecture expert designing scalable, developer-friendly interfaces",
+    "ask": "Task-formulation guide that helps users navigate, ask, and delegate tasks",
+    "blockchain-developer": "Elite blockchain developer specializing in 2026 Web3 technologies",
+    "compiler-engineer": "Designs and optimizes compilers and toolchains",
+    "content-strategist": "Expert Content Strategy specialist with research capabilities",
+    "deep-research-protocol": "Systematic research analyst producing publication-ready reports",
+    "functional-programming-expert": "Designs purely functional, composable systems with strong types",
+    "integration": "Merges outputs of all modes into working, tested, production-ready systems",
+    "mcp": "MCP integration specialist for connecting to and managing external services",
+    "mobile-developer": "Cross-platform mobile specialist building performant native experiences",
+    "performance-engineer": "Expert in system optimization, bottleneck identification, and scalability",
+    "post-deployment-monitoring-mode": "Observes system post-launch, collecting performance, logs, and user feedback",
+    "refinement-optimization-mode": "Refactors, modularizes, and improves system performance",
+    "sdk-developer": "Designs developer-friendly SDKs with ergonomic APIs and strong typing",
+    "ui-expert": "Expert UI/UX Designer with mastery over interface design principles",
+    "web-design-specialist": "Expert in modern web development, UI/UX, accessibility, and performance",
+    "cloud-architect": "Expert in multi-cloud strategies, scalable architectures, and cost-effective solutions",
+    "database-administrator": "Expert in high-availability systems, performance optimization, and disaster recovery",
+    "deployment-engineer": "Expert in CI/CD pipelines, release automation, and deployment strategies",
+    "devops-architect": "Elite specialist in cloud-native infrastructure, CI/CD automation, and platform engineering",
+    "devops-engineer": "Expert bridging development and operations with comprehensive automation",
+    "finops-optimizer": "Drives cloud cost efficiency through rightsizing, commitment management, and architecture improvements",
+    "observability-architect": "Defines SLI/SLOs, golden signals, and telemetry standards for reliable systems",
+    "network-engineer": "Expert in cloud and hybrid network architectures, security, and performance optimization",
+    "sql-pro": "Expert in complex query optimization, database design, and performance tuning",
+    "compliance-specialist": "Meticulous specialist in regulatory adherence across multiple jurisdictions",
+    "corporate-law": "Elite specialist in securities law, M&A, corporate governance, and business transactions",
+    "intellectual-property": "Elite specialist in patents, trademarks, copyrights, and trade secrets",
+    "oss-license-auditor": "Enforces license policy via SBOMs, license detection, and remediation guidance",
+    "agent-organizer": "Expert in multi-agent orchestration, team assembly, and workflow optimization",
+    "build-engineer": "Expert in build system optimization, compilation strategies, and productivity",
+    "bullshit-detection-analyst": "Expert in identifying misinformation using evidence-based verification",
+    "competitive-analyst": "Expert in competitor intelligence, strategic analysis, and market positioning",
+    "data-analyst": "Expert in business intelligence, data visualization, and statistical analysis",
+    "data-engineer": "Expert in building scalable data pipelines and data infrastructure",
+    "database-optimizer": "Expert in query optimization, performance tuning, and scalability",
+    "dependency-manager": "Expert in package management, security auditing, and version conflict resolution",
+    "documentation-engineer": "Expert in technical documentation systems and developer-friendly content",
+    "error-coordinator": "Expert in distributed error handling, failure recovery, and system resilience",
+    "feature-flag-orchestrator": "Manages safe rollouts, kill-switches, and debt cleanup",
+    "git-workflow-manager": "Expert in branching strategies, automation, and team collaboration",
+    "knowledge-synthesizer": "Expert in extracting insights from multi-agent interactions",
+    "market-researcher": "Expert in market analysis, consumer insights, and competitive intelligence",
+    "multi-agent-coordinator": "Expert in complex workflow orchestration and inter-agent communication",
+    "refactoring-specialist": "Expert mastering safe code transformation and design pattern application",
+    "release-governance-lead": "Ensures every release meets quality, security, and compliance gates",
+    "task-distributor": "Expert in intelligent work allocation, load balancing, and queue management",
+    "website-foundation-planner": "Plans directory structure and best-practice alignment for new website projects",
+    "workflow-orchestrator": "Expert in complex process design, state machine implementation, and automation",
+    "code-reviewer": "Expert in code quality, security vulnerabilities, and best practices",
+    "code-skeptic": "Skeptical and critical code quality inspector who questions everything",
+    "cybersecurity-expert": "Elite specialist in threat detection, vulnerability assessment, and security architecture",
+    "penetration-tester": "Expert in ethical hacking, vulnerability assessment, and security testing",
+    "secrets-hygiene-auditor": "Eliminates hardcoded secrets, enforces rotation, and ensures secure management",
+    "security-auditor": "Expert in comprehensive security assessments, compliance validation, and risk management",
+    "zero-trust-strategist": "Implements identity-centric access, continuous verification, and micro-segmentation",
+    "qa-expert": "Expert in comprehensive quality assurance, test strategy, and quality metrics",
+    "tdd": "Implements Test-Driven Development, writing tests first",
+    "test-automator": "Expert in building robust test frameworks and CI/CD integration",
+    "agentic-swarm-conductor": "Hive-Mind Orchestrator & Stuck-State Recovery Specialist",
+    "problem-solving-maestro": "Master of All Heuristics and Systemic Intervention",
+    "uiux-vibe-master": "Aesthetic Intelligence and Zero-Accident Layout Enforcer",
+    "anti-fiction-sentinel": "Truth Enforcer and Neuro-Symbolic Verifier",
+    "core-reasoning-architect": "Immutable foundation of all reasoning",
+    "fintech-engineer": "Expert in financial systems, regulatory compliance, and secure transaction processing",
+    "creative-director": "Elite specialist in brand identity, digital experiences, and creative campaign development",
+    "financial-analyst": "Elite specialist in financial modeling, investment analysis, and risk assessment",
+    "payment-integration": "Expert in payment gateway integration, PCI compliance, and financial transactions",
+    "risk-manager": "Expert in comprehensive risk assessment, mitigation strategies, and compliance",
+    "iot-engineer": "Expert in connected device architectures, edge computing, and IoT platforms",
+}
+
+
+def process_roomodes(filepath):
+    with open(filepath, 'r') as f:
+        lines = f.readlines()
+
+    output = []
+    i = 0
+    modified_count = 0
+    already_had_count = 0
+    skipped_count = 0
+
+    while i < len(lines):
+        line = lines[i]
+        slug_match = re.match(r'  - slug: (\S+)', line)
+
+        if slug_match:
+            slug = slug_match.group(1)
+
+            if slug in CURATED_DESCRIPTIONS:
+                desc = CURATED_DESCRIPTIONS[slug]
+
+                # Find the name: line and description within this mode block
+                name_line_idx = None
+                has_desc = False
+                block_end = len(lines)
+
+                for j in range(i + 1, len(lines)):
+                    next_line = lines[j]
+                    # Stop if we hit the next mode entry or end
+                    if next_line.startswith('  - slug:'):
+                        block_end = j
+                        break
+                    if next_line.startswith('    name:'):
+                        name_line_idx = j
+                    if next_line.startswith('    description:'):
+                        has_desc = True
+
+                if name_line_idx is not None and not has_desc:
+                    # Output lines from current position up to and including name
+                    output.extend(lines[i:name_line_idx + 1])
+                    # Insert description
+                    output.append(f'    description: {desc}\n')
+                    modified_count += 1
+                    # Move past the name line
+                    i = name_line_idx + 1
+                elif name_line_idx is not None and has_desc:
+                    already_had_count += 1
+                    # Pass through all lines until block end or next slug
+                    output.extend(lines[i:block_end])
+                    i = block_end
+                else:
+                    skipped_count += 1
+                    output.append(line)
+                    i += 1
+            else:
+                output.append(line)
+                i += 1
+        else:
+            output.append(line)
+            i += 1
+
+    with open(filepath, 'w') as f:
+        f.writelines(output)
+
+    return modified_count, already_had_count, skipped_count
+
+
+if __name__ == '__main__':
+    count, existing, skipped = process_roomodes('.roomodes')
+    print(f"Modified modes (added description): {count}")
+    print(f"Already had description: {existing}")
+    print(f"Skipped (no name line found): {skipped}")
diff --git a/scripts/fix_missing_descriptions.py b/scripts/fix_missing_descriptions.py
new file mode 100644
index 0000000000..b74bf46608
--- /dev/null
+++ b/scripts/fix_missing_descriptions.py
@@ -0,0 +1,183 @@
+#!/usr/bin/env python3
+"""
+Add description fields to all agent source YAML files in custom-modes/agents/.
+
+For each .yaml file, derives a description from the roleDefinition field and
+inserts it after the 'name:' line.
+"""
+
+import os
+import re
+import glob
+import sys
+
+AGENTS_DIR = os.path.join(os.path.dirname(__file__), '..', 'custom-modes', 'agents')
+
+
+def derive_description(role_definition: str) -> str:
+    """
+    Derive a concise description from the roleDefinition string.
+
+    Rules:
+    - Take the first sentence
+    - Remove "You are an " or "You are a " prefix
+    - Keep under 120 characters
+    - Sentence case, no trailing period
+    - Make it unique and descriptive
+    """
+    # Get the first sentence
+    # First, handle em-dash cases: "You are the X — the Y."
+    # We want to capture the full description
+    text = role_definition.strip()
+
+    # Split into sentences (handle various sentence endings)
+    # Look for period, exclamation, question mark followed by space or end
+    sentences = re.split(r'(?<=[.!?])\s+', text)
+    first_sentence = sentences[0].strip() if sentences else text
+
+    # Remove trailing punctuation for processing
+    first_sentence = first_sentence.rstrip('.!?')
+
+    # Remove "You are an " or "You are a " or "You are " prefix (case insensitive)
+    prefix_patterns = [
+        r'^You are an\s+',
+        r'^You are a\s+',
+        r'^You are\s+',
+    ]
+    for pattern in prefix_patterns:
+        if re.match(pattern, first_sentence, re.IGNORECASE):
+            first_sentence = re.sub(pattern, '', first_sentence, flags=re.IGNORECASE)
+            break
+
+    # Handle "the X — the Y" pattern after "You are" removal
+    # e.g., "the Hive-Mind Orchestrator and Stuck-State Recovery Specialist."
+    # Already looks good after prefix removal
+
+    # Ensure we start with a capital letter
+    if first_sentence and first_sentence[0].islower():
+        first_sentence = first_sentence[0].upper() + first_sentence[1:]
+
+    # Trim to under 120 characters
+    if len(first_sentence) > 120:
+        # Try to cut at the last space before 120
+        truncated = first_sentence[:117]
+        last_space = truncated.rfind(' ')
+        if last_space > 30:  # Only cut at a word boundary if it's reasonable
+            first_sentence = first_sentence[:last_space]
+        else:
+            first_sentence = truncated
+
+    first_sentence = first_sentence.strip()
+
+    # Remove any trailing period that might remain
+    first_sentence = first_sentence.rstrip('.')
+
+    return first_sentence
+
+
+def process_file(filepath: str) -> bool:
+    """Process a single YAML file. Returns True if modified."""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        lines = f.readlines()
+
+    # Check if description already exists
+    for line in lines:
+        if line.strip().startswith('description:'):
+            print(f"  SKIP (already has description): {filepath}")
+            return False
+
+    # Find name: line and roleDefinition: line
+    name_line_idx = None
+    role_def_line = None
+
+    for i, line in enumerate(lines):
+        stripped = line.strip()
+        if stripped.startswith('name:'):
+            name_line_idx = i
+        elif stripped.startswith('roleDefinition:'):
+            # Get the full roleDefinition, which may span multiple lines
+            role_def_value = stripped[len('roleDefinition:'):].strip()
+            # Remove leading/trailing quotes
+            role_def_value = role_def_value.strip('"\'')
+            role_def_line = role_def_value
+            # If roleDefinition value continues on next lines (quoted multiline),
+            # we need to handle it, but for most files it's a single line
+            if role_def_value == '' or role_def_value.endswith('\\'):
+                # Multiline - collect continuation
+                j = i + 1
+                while j < len(lines):
+                    cont = lines[j].strip()
+                    if cont.startswith('groups:') or cont.startswith('customInstructions:'):
+                        break
+                    if cont and not cont.startswith('#') and not cont.startswith('  '):
+                        break
+                    # Handle continuation lines in quotes
+                    role_def_line += ' ' + cont.strip().strip('"\'')
+                    j += 1
+            break
+
+    if name_line_idx is None:
+        print(f"  ERROR: No 'name:' found in {filepath}")
+        return False
+
+    if role_def_line is None:
+        print(f"  ERROR: No 'roleDefinition:' found in {filepath}")
+        return False
+
+    description = derive_description(role_def_line)
+
+    # Determine where to insert the description line
+    # Insert after the name: line
+    insert_idx = name_line_idx + 1
+
+    # Build indentation for the description line
+    name_line = lines[name_line_idx]
+    indent = ''
+    for ch in name_line:
+        if ch == ' ':
+            indent += ch
+        else:
+            break
+
+    desc_line = f"{indent}description: {description}\n"
+
+    # Insert the description line
+    new_lines = lines[:insert_idx] + [desc_line] + lines[insert_idx:]
+
+    with open(filepath, 'w', encoding='utf-8') as f:
+        f.writelines(new_lines)
+
+    print(f"  OK: {os.path.relpath(filepath, AGENTS_DIR)} -> \"{description}\"")
+    return True
+
+
+def main():
+    yaml_files = []
+    for root, dirs, files in os.walk(AGENTS_DIR):
+        for f in files:
+            if f.endswith('.yaml') or f.endswith('.yml'):
+                yaml_files.append(os.path.join(root, f))
+
+    yaml_files.sort()
+    print(f"Found {len(yaml_files)} YAML files in {AGENTS_DIR}")
+
+    modified = 0
+    skipped = 0
+    errors = 0
+
+    for filepath in yaml_files:
+        try:
+            if process_file(filepath):
+                modified += 1
+            else:
+                skipped += 1
+        except Exception as e:
+            print(f"  ERROR processing {filepath}: {e}")
+            errors += 1
+
+    print(f"\nDone. Modified: {modified}, Skipped: {skipped}, Errors: {errors}")
+    return 0 if errors == 0 else 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
diff --git a/src/CHANGELOG.md b/src/CHANGELOG.md
index bfacd27976..aef2855aac 100644
--- a/src/CHANGELOG.md
+++ b/src/CHANGELOG.md
@@ -1,5 +1,52 @@
 # Roo+ Changelog
 
+## [3.73.0] — 2026-07-27
+
+### Minor — Mode Subtitles (Descriptions) Completed
+
+#### 🚀 Enhancements
+
+- **Mode Subtitles** — Added `description:` (subtitle) fields to all 90 custom mode entries in [`.roomodes`](.roomodes) that were missing them. All 97 pre-loaded modes now display descriptive subtitles in the mode selector UI. (Closes: #39)
+- **Agent Source Descriptions** — Added `description:` fields to all 233 agent source YAML files in `custom-modes/agents/`, fixing the root cause where the upstream schema omitted descriptions entirely.
+- **Agent Catalog Alignment** — Audit confirmed 233 total agents: 90 pre-loaded in `.roomodes` (all described), 143 available for import via the `agents/` submodule. See [`custom-modes/AGENT_CATALOG.md`](custom-modes/AGENT_CATALOG.md) for the full list.
+
+#### ✅ Quality
+
+- YAML validation passed — all 97 mode entries parse correctly
+- Lint passed — zero warnings
+- All 425 test files passed (7,103 tests)
+
+---
+
+## [3.72.1] — 2026-07-27
+
+### Patch — Semble Binary Download Fix, Configurable Path, Multi-Source Fallback
+
+#### 🐛 Bug Fixes
+
+- **Semble Download 404** — Resolved HTTP 404 error when downloading semble binary. Repository `Roo-Plus-Org/sembleexec` did not exist; migrated to `Audare-est-Facere/sembleexec` with automated CI/CD release pipeline for future builds. (Closes: #42)
+
+#### 🚀 Enhancements
+
+- **Configurable Binary Path** — Added `codebaseIndexSembleBinaryPath` setting allowing users to specify a path to a manually installed semble binary, bypassing auto-download
+- **Multi-Source Fallback** — Download now retries across multiple sources with exponential backoff (2s, 4s) before failing with per-source error details
+- **Dynamic Version Resolution** — Downloader fetches the latest semble release from GitHub API when SEMBLE_VERSION_PATTERN is set to "latest"
+- **Checksum Manifest Support** — Downloads and verifies against `checksums-sha256.txt` release manifest, falling back to hardcoded checksums
+- **Pre-Flight Validation** — Disk space and write permission checks before attempting download to provide clear error messages early
+- **Offline Bundling** — New [`scripts/bundle-semble.sh`](scripts/bundle-semble.sh) allows bundling the semble binary into the VSIX for air-gapped/enterprise environments
+
+#### 🔒 Security
+
+- All SHA-256 checksums verified post-download against hardcoded values and release manifest
+- Redirect chain restricted to trusted domains (`github.com`, `objects.githubusercontent.com`, `release-assets.githubusercontent.com`)
+
+#### ✅ Quality
+
+- 11 new test cases across downloader, provider, and config-manager test suites
+- All 156+ tests passing
+
+---
+
 ## [3.72.0] — 2026-07-20
 
 ### Minor — Custom Modes Library, New Providers, UX Enhancements
@@ -128,6 +175,33 @@ Roo+ now ships with **90 carefully curated AI agents** pre-loaded, selected from
 - **Fix(ci): make `sync-custom-modes.mjs` tolerate missing git submodule in CI** — The `custom-modes/agents/` submodule is not initialized in CI checkout; the script now gracefully skips regeneration when output files already exist (committed to repo).
 - **Chore(tests): add `pre-installed-modes.yml` to dist asset verification** — Updated `dist_assets.spec.ts` to verify the new bundled asset exists in the build output.
 
+## [3.72.0]
+
+### Minor Changes
+
+- Add the Moonshot provider with live model discovery, streaming, model metadata, and a model picker (PR #857 by @grizmin)
+- Add the Kimi Code provider with OAuth device-flow authentication (PR #945 by @taltas)
+- Add Claude Opus 5 support across all providers (PR #1010 by @app/zoomote)
+- Add Kimi K3 to the Moonshot and OpenCode Go providers (#932 by @navedmerchant, PR #996 by @app/zoomote)
+- Add Gemini 3.6 Flash model support (PR #975 by @app/zoomote)
+- Add MiniMax-M3 model support (#888 by @RayWinter0816, PR #946 by @app/zoomote)
+- Add a safe way to abandon interrupted subtasks by severing stale parent-child links and surfacing delegation status (#559 by @edelauna, PR #935 by @edelauna)
+- Add Dart support to codebase indexing (#940 by @WebMad, PR #941 by @WebMad)
+- Fix codebase indexing for plain-text files (#931 by @tool-buddy, PR #938 by @WebMad)
+- Enable image input for DeepSeek V4 models (#964 by @grizmin, PR #963 by @grizmin)
+- Fix ChatGPT OAuth requests for GPT-5.6 Luna being rejected by the Codex backend (PR #889 by @taltas)
+- Preserve `reasoning_content` for known reasoning model families when using LiteLLM (#891 by @daewoongoh, PR #899 by @daewoongoh)
+- Fix task-history cache invalidation races by routing `invalidate()` and `invalidateAll()` through the task-history lock (#698 by @edelauna, PR #912 by @morgan-coded)
+- Fix Settings mode changes by synchronizing the local `cachedState` editing buffer (#914 by @easonLiangWorldedtech, PR #925 by @easonLiangWorldedtech)
+- Dismiss the welcome screen after successful Zoo Gateway sign-in (#961 by @JohnCanty, PR #962 by @JamesRobert20)
+- Add `CompletePromptOptions` to the `completePrompt` API so callers can configure prompt completion (#615 by @edelauna, PR #901 by @easonLiangWorldedtech)
+- Centralize provider identifiers into canonical shared types (#951 by @WebMad, PR #952 by @WebMad)
+- Refactor provider categories to use canonical provider identifiers (PR #989 by @WebMad)
+- Remove obsolete MCP server-creation translations (#895 by @edelauna, PR #943 by @WebMad)
+- Add regression coverage for resuming interrupted subtasks (#566 by @myk1yt, PR #911 by @edelauna)
+- Upload coverage reports as GitHub Actions artifacts to simplify CI debugging (PR #939 by @app/zoomote)
+- Update `esbuild-wasm` to v0.28.1 (PR #829 by @app/renovate)
+
 ## [3.70.0]
 
 ### Minor Changes
diff --git a/src/package.json b/src/package.json
index a0de2370ec..92c44a7c22 100644
--- a/src/package.json
+++ b/src/package.json
@@ -3,7 +3,7 @@
 	"displayName": "%extension.displayName%",
 	"description": "%extension.description%",
 	"publisher": "xavier-arosemena",
-	"version": "3.72.1",
+	"version": "3.73.0",
 	"icon": "assets/icons/icon.png",
 	"galleryBanner": {
 		"color": "#617A91",
diff --git a/src/services/code-index/semble/__tests__/semble-downloader.spec.ts b/src/services/code-index/semble/__tests__/semble-downloader.spec.ts
index 698c91f923..83e750020c 100644
--- a/src/services/code-index/semble/__tests__/semble-downloader.spec.ts
+++ b/src/services/code-index/semble/__tests__/semble-downloader.spec.ts
@@ -968,16 +968,15 @@ describe("semble-downloader", () => {
 					setImmediate(cb)
 				}
 			})
-// Archive cleanup fails but should not throw (only archive removal after extraction).
-// Use a conditional mock so validateInstallPath (which calls fs.unlink(".write-test"))
-// still succeeds — only the archive cleanup unlink should reject.
-;(fs.unlink as any).mockImplementation((filePath: string) => {
-	if (typeof filePath === "string" && filePath.includes(".write-test")) {
-		return Promise.resolve(undefined)
-	}
-	return Promise.reject(new Error("unlink cleanup failed"))
-})
-
+			// Archive cleanup fails but should not throw (only archive removal after extraction).
+			// Use a conditional mock so validateInstallPath (which calls fs.unlink(".write-test"))
+			// still succeeds — only the archive cleanup unlink should reject.
+			;(fs.unlink as any).mockImplementation((filePath: string) => {
+				if (typeof filePath === "string" && filePath.includes(".write-test")) {
+					return Promise.resolve(undefined)
+				}
+				return Promise.reject(new Error("unlink cleanup failed"))
+			})
 
 			try {
 				const result = await downloadSemble("/storage")