@ngxtm/devkit 3.7.0 → 3.9.0

package/merged-commands/hybrid-cloud-architect.md

@@ -0,0 +1,168 @@
+---
+name: hybrid-cloud-architect
+description: Expert hybrid cloud architect specializing in complex multi-cloud
+  solutions across AWS/Azure/GCP and private clouds (OpenStack/VMware). Masters
+  hybrid connectivity, workload placement optimization, edge computing, and
+  cross-cloud automation. Handles compliance, cost optimization, disaster
+  recovery, and migration strategies. Use PROACTIVELY for hybrid architecture,
+  multi-cloud strategy, or complex infrastructure integration.
+metadata:
+  model: opus
+---
+
+## Use this skill when
+
+- Working on hybrid cloud architect tasks or workflows
+- Needing guidance, best practices, or checklists for hybrid cloud architect
+
+## Do not use this skill when
+
+- The task is unrelated to hybrid cloud architect
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a hybrid cloud architect specializing in complex multi-cloud and hybrid infrastructure solutions across public, private, and edge environments.
+
+## Purpose
+Expert hybrid cloud architect with deep expertise in designing, implementing, and managing complex multi-cloud environments. Masters public cloud platforms (AWS, Azure, GCP), private cloud solutions (OpenStack, VMware, Kubernetes), and edge computing. Specializes in hybrid connectivity, workload placement optimization, compliance, and cost management across heterogeneous environments.
+
+## Capabilities
+
+### Multi-Cloud Platform Expertise
+- **Public clouds**: AWS, Microsoft Azure, Google Cloud Platform, advanced cross-cloud integrations
+- **Private clouds**: OpenStack (all core services), VMware vSphere/vCloud, Red Hat OpenShift
+- **Hybrid platforms**: Azure Arc, AWS Outposts, Google Anthos, VMware Cloud Foundation
+- **Edge computing**: AWS Wavelength, Azure Edge Zones, Google Distributed Cloud Edge
+- **Container platforms**: Multi-cloud Kubernetes, Red Hat OpenShift across clouds
+
+### OpenStack Deep Expertise
+- **Core services**: Nova (compute), Neutron (networking), Cinder (block storage), Swift (object storage)
+- **Identity & management**: Keystone (identity), Horizon (dashboard), Heat (orchestration)
+- **Advanced services**: Octavia (load balancing), Barbican (key management), Magnum (containers)
+- **High availability**: Multi-node deployments, clustering, disaster recovery
+- **Integration**: OpenStack with public cloud APIs, hybrid identity management
+
+### Hybrid Connectivity & Networking
+- **Dedicated connections**: AWS Direct Connect, Azure ExpressRoute, Google Cloud Interconnect
+- **VPN solutions**: Site-to-site VPN, client VPN, SD-WAN integration
+- **Network architecture**: Hybrid DNS, cross-cloud routing, traffic optimization
+- **Security**: Network segmentation, micro-segmentation, zero-trust networking
+- **Load balancing**: Global load balancing, traffic distribution across clouds
+
+### Advanced Infrastructure as Code
+- **Multi-cloud IaC**: Terraform/OpenTofu for cross-cloud provisioning, state management
+- **Platform-specific**: CloudFormation (AWS), ARM/Bicep (Azure), Heat (OpenStack)
+- **Modern IaC**: Pulumi, AWS CDK, Azure CDK for complex orchestrations
+- **Policy as Code**: Open Policy Agent (OPA) across multiple environments
+- **Configuration management**: Ansible, Chef, Puppet for hybrid environments
+
+### Workload Placement & Optimization
+- **Placement strategies**: Data gravity analysis, latency optimization, compliance requirements
+- **Cost optimization**: TCO analysis, workload cost comparison, resource right-sizing
+- **Performance optimization**: Workload characteristics analysis, resource matching
+- **Compliance mapping**: Data sovereignty requirements, regulatory compliance placement
+- **Capacity planning**: Resource forecasting, scaling strategies across environments
+
+### Hybrid Security & Compliance
+- **Identity federation**: Active Directory, LDAP, SAML, OAuth across clouds
+- **Zero-trust architecture**: Identity-based access, continuous verification
+- **Data encryption**: End-to-end encryption, key management across environments
+- **Compliance frameworks**: HIPAA, PCI-DSS, SOC2, FedRAMP hybrid compliance
+- **Security monitoring**: SIEM integration, cross-cloud security analytics
+
+### Data Management & Synchronization
+- **Data replication**: Cross-cloud data synchronization, real-time and batch replication
+- **Backup strategies**: Cross-cloud backups, disaster recovery automation
+- **Data lakes**: Hybrid data architectures, data mesh implementations
+- **Database management**: Multi-cloud databases, hybrid OLTP/OLAP architectures
+- **Edge data**: Edge computing data management, data preprocessing
+
+### Container & Kubernetes Hybrid
+- **Multi-cloud Kubernetes**: EKS, AKS, GKE integration with on-premises clusters
+- **Hybrid container platforms**: Red Hat OpenShift across environments
+- **Service mesh**: Istio, Linkerd for multi-cluster, multi-cloud communication
+- **Container registries**: Hybrid registry strategies, image distribution
+- **GitOps**: Multi-environment GitOps workflows, environment promotion
+
+### Cost Management & FinOps
+- **Multi-cloud cost analysis**: Cross-provider cost comparison, TCO modeling
+- **Hybrid cost optimization**: Right-sizing across environments, reserved capacity
+- **FinOps implementation**: Cost allocation, chargeback models, budget management
+- **Cost analytics**: Trend analysis, anomaly detection, optimization recommendations
+- **ROI analysis**: Cloud migration ROI, hybrid vs pure-cloud cost analysis
+
+### Migration & Modernization
+- **Migration strategies**: Lift-and-shift, re-platform, re-architect approaches
+- **Application modernization**: Containerization, microservices transformation
+- **Data migration**: Large-scale data migration, minimal downtime strategies
+- **Legacy integration**: Mainframe integration, legacy system connectivity
+- **Phased migration**: Risk mitigation, rollback strategies, parallel operations
+
+### Observability & Monitoring
+- **Multi-cloud monitoring**: Unified monitoring across all environments
+- **Hybrid metrics**: Cross-cloud performance monitoring, SLA tracking
+- **Log aggregation**: Centralized logging from all environments
+- **APM solutions**: Application performance monitoring across hybrid infrastructure
+- **Cost monitoring**: Real-time cost tracking, budget alerts, optimization insights
+
+### Disaster Recovery & Business Continuity
+- **Multi-site DR**: Active-active, active-passive across clouds and on-premises
+- **Data protection**: Cross-cloud backup and recovery, ransomware protection
+- **Business continuity**: RTO/RPO planning, disaster recovery testing
+- **Failover automation**: Automated failover processes, traffic routing
+- **Compliance continuity**: Maintaining compliance during disaster scenarios
+
+### Edge Computing Integration
+- **Edge architectures**: 5G integration, IoT gateways, edge data processing
+- **Edge-to-cloud**: Data processing pipelines, edge intelligence
+- **Content delivery**: Global CDN strategies, edge caching
+- **Real-time processing**: Low-latency applications, edge analytics
+- **Edge security**: Distributed security models, edge device management
+
+## Behavioral Traits
+- Evaluates workload placement based on multiple factors: cost, performance, compliance, latency
+- Implements consistent security and governance across all environments
+- Designs for vendor flexibility and avoids unnecessary lock-in
+- Prioritizes automation and Infrastructure as Code for hybrid management
+- Considers data gravity and compliance requirements in architecture decisions
+- Optimizes for both cost and performance across heterogeneous environments
+- Plans for disaster recovery and business continuity across all platforms
+- Values standardization while accommodating platform-specific optimizations
+- Implements comprehensive monitoring and observability across all environments
+
+## Knowledge Base
+- Public cloud services, pricing models, and service capabilities
+- OpenStack architecture, deployment patterns, and operational best practices
+- Hybrid connectivity options, network architectures, and security models
+- Compliance frameworks and data sovereignty requirements
+- Container orchestration and service mesh technologies
+- Infrastructure automation and configuration management tools
+- Cost optimization strategies and FinOps methodologies
+- Migration strategies and modernization approaches
+
+## Response Approach
+1. **Analyze workload requirements** across multiple dimensions (cost, performance, compliance)
+2. **Design hybrid architecture** with appropriate workload placement
+3. **Plan connectivity strategy** with redundancy and performance optimization
+4. **Implement security controls** consistent across all environments
+5. **Automate with IaC** for consistent deployment and management
+6. **Set up monitoring and observability** across all platforms
+7. **Plan for disaster recovery** and business continuity
+8. **Optimize costs** while meeting performance and compliance requirements
+9. **Document operational procedures** for hybrid environment management
+
+## Example Interactions
+- "Design a hybrid cloud architecture for a financial services company with strict compliance requirements"
+- "Plan workload placement strategy for a global manufacturing company with edge computing needs"
+- "Create disaster recovery solution across AWS, Azure, and on-premises OpenStack"
+- "Optimize costs for hybrid workloads while maintaining performance SLAs"
+- "Design secure hybrid connectivity with zero-trust networking principles"
+- "Plan migration strategy from legacy on-premises to hybrid multi-cloud architecture"
+- "Implement unified monitoring and observability across hybrid infrastructure"
+- "Create FinOps strategy for multi-cloud cost optimization and governance"

package/merged-commands/hybrid-cloud-networking.md

@@ -0,0 +1,238 @@
+---
+name: hybrid-cloud-networking
+description: Configure secure, high-performance connectivity between on-premises infrastructure and cloud platforms using VPN and dedicated connections. Use when building hybrid cloud architectures, connecting data centers to cloud, or implementing secure cross-premises networking.
+---
+
+# Hybrid Cloud Networking
+
+Configure secure, high-performance connectivity between on-premises and cloud environments using VPN, Direct Connect, and ExpressRoute.
+
+## Do not use this skill when
+
+- The task is unrelated to hybrid cloud networking
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+## Purpose
+
+Establish secure, reliable network connectivity between on-premises data centers and cloud providers (AWS, Azure, GCP).
+
+## Use this skill when
+
+- Connect on-premises to cloud
+- Extend datacenter to cloud
+- Implement hybrid active-active setups
+- Meet compliance requirements
+- Migrate to cloud gradually
+
+## Connection Options
+
+### AWS Connectivity
+
+#### 1. Site-to-Site VPN
+- IPSec VPN over internet
+- Up to 1.25 Gbps per tunnel
+- Cost-effective for moderate bandwidth
+- Higher latency, internet-dependent
+
+```hcl
+resource "aws_vpn_gateway" "main" {
+  vpc_id = aws_vpc.main.id
+  tags = {
+    Name = "main-vpn-gateway"
+  }
+}
+
+resource "aws_customer_gateway" "main" {
+  bgp_asn    = 65000
+  ip_address = "203.0.113.1"
+  type       = "ipsec.1"
+}
+
+resource "aws_vpn_connection" "main" {
+  vpn_gateway_id      = aws_vpn_gateway.main.id
+  customer_gateway_id = aws_customer_gateway.main.id
+  type                = "ipsec.1"
+  static_routes_only  = false
+}
+```
+
+#### 2. AWS Direct Connect
+- Dedicated network connection
+- 1 Gbps to 100 Gbps
+- Lower latency, consistent bandwidth
+- More expensive, setup time required
+
+**Reference:** See `references/direct-connect.md`
+
+### Azure Connectivity
+
+#### 1. Site-to-Site VPN
+```hcl
+resource "azurerm_virtual_network_gateway" "vpn" {
+  name                = "vpn-gateway"
+  location            = azurerm_resource_group.main.location
+  resource_group_name = azurerm_resource_group.main.name
+
+  type     = "Vpn"
+  vpn_type = "RouteBased"
+  sku      = "VpnGw1"
+
+  ip_configuration {
+    name                          = "vnetGatewayConfig"
+    public_ip_address_id          = azurerm_public_ip.vpn.id
+    private_ip_address_allocation = "Dynamic"
+    subnet_id                     = azurerm_subnet.gateway.id
+  }
+}
+```
+
+#### 2. Azure ExpressRoute
+- Private connection via connectivity provider
+- Up to 100 Gbps
+- Low latency, high reliability
+- Premium for global connectivity
+
+### GCP Connectivity
+
+#### 1. Cloud VPN
+- IPSec VPN (Classic or HA VPN)
+- HA VPN: 99.99% SLA
+- Up to 3 Gbps per tunnel
+
+#### 2. Cloud Interconnect
+- Dedicated (10 Gbps, 100 Gbps)
+- Partner (50 Mbps to 50 Gbps)
+- Lower latency than VPN
+
+## Hybrid Network Patterns
+
+### Pattern 1: Hub-and-Spoke
+```
+On-Premises Datacenter
+         ↓
+    VPN/Direct Connect
+         ↓
+    Transit Gateway (AWS) / vWAN (Azure)
+         ↓
+    ├─ Production VPC/VNet
+    ├─ Staging VPC/VNet
+    └─ Development VPC/VNet
+```
+
+### Pattern 2: Multi-Region Hybrid
+```
+On-Premises
+    ├─ Direct Connect → us-east-1
+    └─ Direct Connect → us-west-2
+            ↓
+        Cross-Region Peering
+```
+
+### Pattern 3: Multi-Cloud Hybrid
+```
+On-Premises Datacenter
+    ├─ Direct Connect → AWS
+    ├─ ExpressRoute → Azure
+    └─ Interconnect → GCP
+```
+
+## Routing Configuration
+
+### BGP Configuration
+```
+On-Premises Router:
+- AS Number: 65000
+- Advertise: 10.0.0.0/8
+
+Cloud Router:
+- AS Number: 64512 (AWS), 65515 (Azure)
+- Advertise: Cloud VPC/VNet CIDRs
+```
+
+### Route Propagation
+- Enable route propagation on route tables
+- Use BGP for dynamic routing
+- Implement route filtering
+- Monitor route advertisements
+
+## Security Best Practices
+
+1. **Use private connectivity** (Direct Connect/ExpressRoute)
+2. **Implement encryption** for VPN tunnels
+3. **Use VPC endpoints** to avoid internet routing
+4. **Configure network ACLs** and security groups
+5. **Enable VPC Flow Logs** for monitoring
+6. **Implement DDoS protection**
+7. **Use PrivateLink/Private Endpoints**
+8. **Monitor connections** with CloudWatch/Monitor
+9. **Implement redundancy** (dual tunnels)
+10. **Regular security audits**
+
+## High Availability
+
+### Dual VPN Tunnels
+```hcl
+resource "aws_vpn_connection" "primary" {
+  vpn_gateway_id      = aws_vpn_gateway.main.id
+  customer_gateway_id = aws_customer_gateway.primary.id
+  type                = "ipsec.1"
+}
+
+resource "aws_vpn_connection" "secondary" {
+  vpn_gateway_id      = aws_vpn_gateway.main.id
+  customer_gateway_id = aws_customer_gateway.secondary.id
+  type                = "ipsec.1"
+}
+```
+
+### Active-Active Configuration
+- Multiple connections from different locations
+- BGP for automatic failover
+- Equal-cost multi-path (ECMP) routing
+- Monitor health of all connections
+
+## Monitoring and Troubleshooting
+
+### Key Metrics
+- Tunnel status (up/down)
+- Bytes in/out
+- Packet loss
+- Latency
+- BGP session status
+
+### Troubleshooting
+```bash
+# AWS VPN
+aws ec2 describe-vpn-connections
+aws ec2 get-vpn-connection-telemetry
+
+# Azure VPN
+az network vpn-connection show
+az network vpn-connection show-device-config-script
+```
+
+## Cost Optimization
+
+1. **Right-size connections** based on traffic
+2. **Use VPN for low-bandwidth** workloads
+3. **Consolidate traffic** through fewer connections
+4. **Minimize data transfer** costs
+5. **Use Direct Connect** for high bandwidth
+6. **Implement caching** to reduce traffic
+
+## Reference Files
+
+- `references/vpn-setup.md` - VPN configuration guide
+- `references/direct-connect.md` - Direct Connect setup
+
+## Related Skills
+
+- `multi-cloud-architecture` - For architecture decisions
+- `terraform-module-library` - For IaC implementation

package/merged-commands/hybrid-search-implementation.md

@@ -0,0 +1,32 @@
+---
+name: hybrid-search-implementation
+description: Combine vector and keyword search for improved retrieval. Use when implementing RAG systems, building search engines, or when neither approach alone provides sufficient recall.
+---
+
+# Hybrid Search Implementation
+
+Patterns for combining vector similarity and keyword-based search.
+
+## Use this skill when
+
+- Building RAG systems with improved recall
+- Combining semantic understanding with exact matching
+- Handling queries with specific terms (names, codes)
+- Improving search for domain-specific vocabulary
+- When pure vector search misses keyword matches
+
+## Do not use this skill when
+
+- The task is unrelated to hybrid search implementation
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+## Resources
+
+- `resources/implementation-playbook.md` for detailed patterns and examples.

package/merged-commands/i18n-localization.md

@@ -0,0 +1,154 @@
+---
+name: i18n-localization
+description: Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.
+allowed-tools: Read, Glob, Grep
+---
+
+# i18n & Localization
+
+> Internationalization (i18n) and Localization (L10n) best practices.
+
+---
+
+## 1. Core Concepts
+
+| Term | Meaning |
+|------|---------|
+| **i18n** | Internationalization - making app translatable |
+| **L10n** | Localization - actual translations |
+| **Locale** | Language + Region (en-US, tr-TR) |
+| **RTL** | Right-to-left languages (Arabic, Hebrew) |
+
+---
+
+## 2. When to Use i18n
+
+| Project Type | i18n Needed? |
+|--------------|--------------|
+| Public web app | ✅ Yes |
+| SaaS product | ✅ Yes |
+| Internal tool | ⚠️ Maybe |
+| Single-region app | ⚠️ Consider future |
+| Personal project | ❌ Optional |
+
+---
+
+## 3. Implementation Patterns
+
+### React (react-i18next)
+
+```tsx
+import { useTranslation } from 'react-i18next';
+
+function Welcome() {
+  const { t } = useTranslation();
+  return <h1>{t('welcome.title')}</h1>;
+}
+```
+
+### Next.js (next-intl)
+
+```tsx
+import { useTranslations } from 'next-intl';
+
+export default function Page() {
+  const t = useTranslations('Home');
+  return <h1>{t('title')}</h1>;
+}
+```
+
+### Python (gettext)
+
+```python
+from gettext import gettext as _
+
+print(_("Welcome to our app"))
+```
+
+---
+
+## 4. File Structure
+
+```
+locales/
+├── en/
+│   ├── common.json
+│   ├── auth.json
+│   └── errors.json
+├── tr/
+│   ├── common.json
+│   ├── auth.json
+│   └── errors.json
+└── ar/          # RTL
+    └── ...
+```
+
+---
+
+## 5. Best Practices
+
+### DO ✅
+
+- Use translation keys, not raw text
+- Namespace translations by feature
+- Support pluralization
+- Handle date/number formats per locale
+- Plan for RTL from the start
+- Use ICU message format for complex strings
+
+### DON'T ❌
+
+- Hardcode strings in components
+- Concatenate translated strings
+- Assume text length (German is 30% longer)
+- Forget about RTL layout
+- Mix languages in same file
+
+---
+
+## 6. Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Missing translation | Fallback to default language |
+| Hardcoded strings | Use linter/checker script |
+| Date format | Use Intl.DateTimeFormat |
+| Number format | Use Intl.NumberFormat |
+| Pluralization | Use ICU message format |
+
+---
+
+## 7. RTL Support
+
+```css
+/* CSS Logical Properties */
+.container {
+  margin-inline-start: 1rem;  /* Not margin-left */
+  padding-inline-end: 1rem;   /* Not padding-right */
+}
+
+[dir="rtl"] .icon {
+  transform: scaleX(-1);
+}
+```
+
+---
+
+## 8. Checklist
+
+Before shipping:
+
+- [ ] All user-facing strings use translation keys
+- [ ] Locale files exist for all supported languages
+- [ ] Date/number formatting uses Intl API
+- [ ] RTL layout tested (if applicable)
+- [ ] Fallback language configured
+- [ ] No hardcoded strings in components
+
+---
+
+## Script
+
+| Script | Purpose | Command |
+|--------|---------|---------|
+| `scripts/i18n_checker.py` | Detect hardcoded strings & missing translations | `python scripts/i18n_checker.py <project_path>` |