moai-adk 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md

@@ -1,123 +1,179 @@
 ---
-name: moai-domain-database
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: Database design, schema optimization, indexing strategies, and migration management.
-keywords: ['database', 'sql', 'nosql', 'migrations', 'indexing']
+name: "moai-domain-database"
+description: "Database specialist covering PostgreSQL, MongoDB, Redis, and advanced data patterns for modern applications"
+version: 1.0.0
+category: "domain"
+modularized: true
+user-invocable: false
+tags: ['database', 'postgresql', 'mongodb', 'redis', 'data-patterns', 'performance']
+updated: 2026-01-11
 allowed-tools:
   - Read
+  - Write
+  - Edit
   - Bash
+  - Grep
+  - Glob
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
+status: "active"
+author: "MoAI-ADK Team"
 ---
 
-# Domain Database Skill
+# Database Domain Specialist
 
-## Skill Metadata
+## Quick Reference
 
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-domain-database |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Domain |
+Enterprise Database Expertise - Comprehensive database patterns and implementations covering PostgreSQL, MongoDB, Redis, and advanced data management for scalable modern applications.
 
----
+Core Capabilities:
 
-## What It Does
+- PostgreSQL: Advanced relational patterns, optimization, and scaling
+- MongoDB: Document modeling, aggregation, and NoSQL performance tuning
+- Redis: In-memory caching, real-time analytics, and distributed systems
+- Multi-Database: Hybrid architectures and data integration patterns
+- Performance: Query optimization, indexing strategies, and scaling
+- Operations: Connection management, migrations, and monitoring
 
-Database design, schema optimization, indexing strategies, and migration management.
+When to Use:
 
-**Key capabilities**:
-- ✅ Best practices enforcement for domain domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+- Designing database schemas and data models
+- Implementing caching strategies and performance optimization
+- Building scalable data architectures
+- Working with multi-database systems
+- Optimizing database queries and performance
 
 ---
 
-## When to Use
+## Implementation Guide
 
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
+### Quick Start Workflow
 
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+Database Stack Initialization:
 
----
+Create a DatabaseManager instance and configure multiple database connections. Set up PostgreSQL with connection string, pool size of 20, and query logging enabled. Configure MongoDB with connection string, database name, and sharding enabled. Configure Redis with connection string, max connections of 50, and clustering enabled. Use the unified interface to query user data with profile and analytics across all database types.
+
+Single Database Operations:
+
+Run PostgreSQL schema migrations using the migration command with the database type and migration file path. Execute MongoDB aggregation pipelines by specifying the collection name and pipeline JSON file. Warm Redis cache by specifying key patterns and TTL values.
+
+### Core Components
+
+PostgreSQL Module:
+
+- Advanced schema design and constraints
+- Complex query optimization and indexing
+- Window functions and CTEs
+- Partitioning and materialized views
+- Connection pooling and performance tuning
 
-## Tool Version Matrix (2025-10-22)
+MongoDB Module:
 
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **PostgreSQL** | 17.2 | Primary | ✅ Current |
-| **MongoDB** | 8.0.0 | Primary | ✅ Current |
-| **Redis** | 7.4.0 | Primary | ✅ Current |
+- Document modeling and schema design
+- Aggregation pipelines for analytics
+- Indexing strategies and performance
+- Sharding and scaling patterns
+- Data consistency and validation
+
+Redis Module:
+
+- Multi-layer caching strategies
+- Real-time analytics and counting
+- Distributed locking and coordination
+- Pub/sub messaging and streams
+- Advanced data structures including HyperLogLog and Geo
 
 ---
 
-## Inputs
+## Advanced Patterns
 
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
+### Multi-Database Architecture
 
-## Outputs
+Polyglot Persistence Pattern:
 
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
+Create a DataRouter class that initializes connections to PostgreSQL, MongoDB, and Redis. Implement get_user_profile method that retrieves structured user data from PostgreSQL, flexible profile data from MongoDB, and real-time status from Redis, then merges all data sources. Implement update_user_data method that routes structured data updates to PostgreSQL, profile data updates to MongoDB, and real-time data updates to Redis, followed by cache invalidation.
 
-## Failure Modes
+Data Synchronization:
 
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
+Create a DataSyncManager class that synchronizes user data across databases. Implement sync_user_data method that retrieves user from PostgreSQL, creates a search document for MongoDB, upserts to the MongoDB search collection, creates cache data, and updates Redis cache with TTL.
 
-## Dependencies
+### Performance Optimization
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+Query Performance Analysis:
 
----
+For PostgreSQL, execute EXPLAIN ANALYZE BUFFERS on queries and use a QueryAnalyzer to generate optimization suggestions. For MongoDB, create an AggregationOptimizer to analyze and optimize aggregation pipelines. For Redis, retrieve info metrics and use a PerformanceAnalyzer to generate recommendations.
 
-## References (Latest Documentation)
+Scaling Strategies:
 
-_Documentation links updated 2025-10-22_
+Configure PostgreSQL read replicas by providing replica connection URLs. Set up MongoDB sharding with shard key and number of shards. Configure Redis clustering by providing node URLs for the cluster.
 
 ---
 
-## Changelog
+## Works Well With
+
+Complementary Skills:
+
+- moai-domain-backend - API integration and business logic
+- moai-foundation-core - Database migration and schema management
+- moai-workflow-project - Database project setup and configuration
+- moai-platform-supabase - Supabase database integration patterns
+- moai-platform-neon - Neon database integration patterns
+- moai-platform-firestore - Firestore database integration patterns
 
-- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
-- **v1.0.0** (2025-03-29): Initial Skill release
+Technology Integration:
+
+- ORMs and ODMs including SQLAlchemy, Mongoose, and TypeORM
+- Connection pooling with PgBouncer and connection pools
+- Migration tools including Alembic and Flyway
+- Monitoring with pg_stat_statements and MongoDB Atlas
+- Cache invalidation and synchronization
 
 ---
 
-## Works Well With
+## Technology Stack
+
+Relational Database:
+
+- PostgreSQL 14+ as primary database
+- MySQL 8.0+ as alternative
+- Connection pooling with PgBouncer and SQLAlchemy
+
+NoSQL Database:
+
+- MongoDB 6.0+ as primary document store
+- Document modeling and validation
+- Aggregation framework
+- Sharding and replication
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+In-Memory Database:
+
+- Redis 7.0+ as primary cache
+- Redis Stack for advanced features
+- Clustering and high availability
+- Advanced data structures
+
+Supporting Tools:
+
+- Migration tools including Alembic and Flyway
+- Monitoring with Prometheus and Grafana
+- ORMs and ODMs including SQLAlchemy and Mongoose
+- Connection management utilities
+
+Performance Features:
+
+- Query optimization and analysis
+- Index management and strategies
+- Caching layers and invalidation
+- Load balancing and failover
 
 ---
 
-## Best Practices
+## Resources
+
+For working code examples, see [examples.md](examples.md).
 
-✅ **DO**:
-- Follow domain best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+For detailed implementation patterns and database-specific optimizations, see the modules directory.
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Status: Production Ready
+Last Updated: 2026-01-11
+Maintained by: MoAI-ADK Database Team