claude-code-orchestrator-kit 1.4.15 → 1.4.16

package/.claude/commands/supabase-performance-optimizer.md

@@ -0,0 +1,73 @@
+---
+allowed-tools: Read, Write, Edit, Bash, Task
+argument-hint: [--all] | --queries | --indexes | --rls | --functions | --realtime | --storage
+description: Optimize Supabase database performance by delegating to specialized agents
+---
+
+# Supabase Performance Optimizer
+
+Optimize Supabase database performance with specialized agents: **$ARGUMENTS**
+
+## Agent Delegation Matrix
+
+| Argument | Agent | What it fixes |
+|----------|-------|---------------|
+| `--queries`, `--indexes`, `--rls`, `--functions` | `supabase-fixer` | Advisors API issues (security + performance) |
+| `--realtime` | `supabase-realtime-optimizer` | Publication issues, subscription indexes |
+| `--storage` | `supabase-storage-optimizer` | Orphaned files, table sizes, data types |
+| `--all` | All three agents | Complete optimization |
+
+## Task Execution
+
+Based on **$ARGUMENTS**, delegate to the appropriate agent(s):
+
+### For `--queries`, `--indexes`, `--rls`, `--functions`:
+
+Use Task tool with:
+- `subagent_type`: `supabase-fixer`
+- `prompt`: Focus on performance advisors for query/index optimization, or security advisors for RLS/function issues
+
+### For `--realtime`:
+
+Use Task tool with:
+- `subagent_type`: `supabase-realtime-optimizer`
+- `prompt`: Optimize realtime subscriptions, check publications, add missing indexes for filters
+
+### For `--storage`:
+
+Use Task tool with:
+- `subagent_type`: `supabase-storage-optimizer`
+- `prompt`: Analyze table sizes, find orphaned files, optimize data types
+
+### For `--all`:
+
+Run all three agents sequentially:
+1. First: `supabase-fixer` (security + performance advisors)
+2. Then: `supabase-realtime-optimizer` (realtime publications)
+3. Finally: `supabase-storage-optimizer` (storage cleanup)
+
+## Expected Output
+
+Each agent generates a structured report in `.tmp/current/`:
+- `database-fixing-report.md` (from supabase-fixer)
+- `realtime-optimization-report.md` (from supabase-realtime-optimizer)
+- `storage-optimization-report.md` (from supabase-storage-optimizer)
+
+## Quick Reference
+
+```bash
+# Fix security issues (RLS, functions)
+/supabase-performance-optimizer --rls --functions
+
+# Optimize queries and indexes
+/supabase-performance-optimizer --queries --indexes
+
+# Optimize realtime subscriptions
+/supabase-performance-optimizer --realtime
+
+# Clean up storage
+/supabase-performance-optimizer --storage
+
+# Full optimization (all agents)
+/supabase-performance-optimizer --all
+```

package/.claude/commands/ultra-think.md

@@ -0,0 +1,158 @@
+---
+description: Deep analysis and problem solving with multi-dimensional thinking
+argument-hint: [problem or question to analyze]
+---
+
+# Deep Analysis and Problem Solving Mode
+
+Deep analysis and problem solving mode
+
+## Instructions
+
+1. **Initialize Ultra Think Mode**
+   - Acknowledge the request for enhanced analytical thinking
+   - Set context for deep, systematic reasoning
+   - Prepare to explore the problem space comprehensively
+
+2. **Parse the Problem or Question**
+   - Extract the core challenge from: $ARGUMENTS
+   - Identify all stakeholders and constraints
+   - Recognize implicit requirements and hidden complexities
+   - Question assumptions and surface unknowns
+
+3. **Multi-Dimensional Analysis**
+   Approach the problem from multiple angles:
+   
+   ### Technical Perspective
+   - Analyze technical feasibility and constraints
+   - Consider scalability, performance, and maintainability
+   - Evaluate security implications
+   - Assess technical debt and future-proofing
+   
+   ### Business Perspective
+   - Understand business value and ROI
+   - Consider time-to-market pressures
+   - Evaluate competitive advantages
+   - Assess risk vs. reward trade-offs
+   
+   ### User Perspective
+   - Analyze user needs and pain points
+   - Consider usability and accessibility
+   - Evaluate user experience implications
+   - Think about edge cases and user journeys
+   
+   ### System Perspective
+   - Consider system-wide impacts
+   - Analyze integration points
+   - Evaluate dependencies and coupling
+   - Think about emergent behaviors
+
+4. **Generate Multiple Solutions**
+   - Brainstorm at least 3-5 different approaches
+   - For each approach, consider:
+     - Pros and cons
+     - Implementation complexity
+     - Resource requirements
+     - Potential risks
+     - Long-term implications
+   - Include both conventional and creative solutions
+   - Consider hybrid approaches
+
+5. **Deep Dive Analysis**
+   For the most promising solutions:
+   - Create detailed implementation plans
+   - Identify potential pitfalls and mitigation strategies
+   - Consider phased approaches and MVPs
+   - Analyze second and third-order effects
+   - Think through failure modes and recovery
+
+6. **Cross-Domain Thinking**
+   - Draw parallels from other industries or domains
+   - Apply design patterns from different contexts
+   - Consider biological or natural system analogies
+   - Look for innovative combinations of existing solutions
+
+7. **Challenge and Refine**
+   - Play devil's advocate with each solution
+   - Identify weaknesses and blind spots
+   - Consider "what if" scenarios
+   - Stress-test assumptions
+   - Look for unintended consequences
+
+8. **Synthesize Insights**
+   - Combine insights from all perspectives
+   - Identify key decision factors
+   - Highlight critical trade-offs
+   - Summarize innovative discoveries
+   - Present a nuanced view of the problem space
+
+9. **Provide Structured Recommendations**
+   Present findings in a clear structure:
+   ```
+   ## Problem Analysis
+   - Core challenge
+   - Key constraints
+   - Critical success factors
+   
+   ## Solution Options
+   ### Option 1: [Name]
+   - Description
+   - Pros/Cons
+   - Implementation approach
+   - Risk assessment
+   
+   ### Option 2: [Name]
+   [Similar structure]
+   
+   ## Recommendation
+   - Recommended approach
+   - Rationale
+   - Implementation roadmap
+   - Success metrics
+   - Risk mitigation plan
+   
+   ## Alternative Perspectives
+   - Contrarian view
+   - Future considerations
+   - Areas for further research
+   ```
+
+10. **Meta-Analysis**
+    - Reflect on the thinking process itself
+    - Identify areas of uncertainty
+    - Acknowledge biases or limitations
+    - Suggest additional expertise needed
+    - Provide confidence levels for recommendations
+
+## Usage Examples
+
+```bash
+# Architectural decision
+/ultra-think Should we migrate to microservices or improve our monolith?
+
+# Complex problem solving
+/ultra-think How do we scale our system to handle 10x traffic while reducing costs?
+
+# Strategic planning
+/ultra-think What technology stack should we choose for our next-gen platform?
+
+# Design challenge
+/ultra-think How can we improve our API to be more developer-friendly while maintaining backward compatibility?
+```
+
+## Key Principles
+
+- **First Principles Thinking**: Break down to fundamental truths
+- **Systems Thinking**: Consider interconnections and feedback loops
+- **Probabilistic Thinking**: Work with uncertainties and ranges
+- **Inversion**: Consider what to avoid, not just what to do
+- **Second-Order Thinking**: Consider consequences of consequences
+
+## Output Expectations
+
+- Comprehensive analysis (typically 2-4 pages of insights)
+- Multiple viable solutions with trade-offs
+- Clear reasoning chains
+- Acknowledgment of uncertainties
+- Actionable recommendations
+- Novel insights or perspectives

package/.claude/skills/senior-architect/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: senior-architect
+description: Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin, Flutter, Postgres, GraphQL, Go, Python. Includes architecture diagram generation, system design patterns, tech stack decision frameworks, and dependency analysis. Use when designing system architecture, making technical decisions, creating architecture diagrams, evaluating trade-offs, or defining integration patterns.
+---
+
+# Senior Architect
+
+Complete toolkit for senior architect with modern tools and best practices.
+
+## Quick Start
+
+### Main Capabilities
+
+This skill provides three core capabilities through automated scripts:
+
+```bash
+# Script 1: Architecture Diagram Generator
+python scripts/architecture_diagram_generator.py [options]
+
+# Script 2: Project Architect
+python scripts/project_architect.py [options]
+
+# Script 3: Dependency Analyzer
+python scripts/dependency_analyzer.py [options]
+```
+
+## Core Capabilities
+
+### 1. Architecture Diagram Generator
+
+Automated tool for architecture diagram generator tasks.
+
+**Features:**
+- Automated scaffolding
+- Best practices built-in
+- Configurable templates
+- Quality checks
+
+**Usage:**
+```bash
+python scripts/architecture_diagram_generator.py <project-path> [options]
+```
+
+### 2. Project Architect
+
+Comprehensive analysis and optimization tool.
+
+**Features:**
+- Deep analysis
+- Performance metrics
+- Recommendations
+- Automated fixes
+
+**Usage:**
+```bash
+python scripts/project_architect.py <target-path> [--verbose]
+```
+
+### 3. Dependency Analyzer
+
+Advanced tooling for specialized tasks.
+
+**Features:**
+- Expert-level automation
+- Custom configurations
+- Integration ready
+- Production-grade output
+
+**Usage:**
+```bash
+python scripts/dependency_analyzer.py [arguments] [options]
+```
+
+## Reference Documentation
+
+### Architecture Patterns
+
+Comprehensive guide available in `references/architecture_patterns.md`:
+
+- Detailed patterns and practices
+- Code examples
+- Best practices
+- Anti-patterns to avoid
+- Real-world scenarios
+
+### System Design Workflows
+
+Complete workflow documentation in `references/system_design_workflows.md`:
+
+- Step-by-step processes
+- Optimization strategies
+- Tool integrations
+- Performance tuning
+- Troubleshooting guide
+
+### Tech Decision Guide
+
+Technical reference guide in `references/tech_decision_guide.md`:
+
+- Technology stack details
+- Configuration examples
+- Integration patterns
+- Security considerations
+- Scalability guidelines
+
+## Tech Stack
+
+**Languages:** TypeScript, JavaScript, Python, Go, Swift, Kotlin
+**Frontend:** React, Next.js, React Native, Flutter
+**Backend:** Node.js, Express, GraphQL, REST APIs
+**Database:** PostgreSQL, Prisma, NeonDB, Supabase
+**DevOps:** Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
+**Cloud:** AWS, GCP, Azure
+
+## Development Workflow
+
+### 1. Setup and Configuration
+
+```bash
+# Install dependencies
+npm install
+# or
+pip install -r requirements.txt
+
+# Configure environment
+cp .env.example .env
+```
+
+### 2. Run Quality Checks
+
+```bash
+# Use the analyzer script
+python scripts/project_architect.py .
+
+# Review recommendations
+# Apply fixes
+```
+
+### 3. Implement Best Practices
+
+Follow the patterns and practices documented in:
+- `references/architecture_patterns.md`
+- `references/system_design_workflows.md`
+- `references/tech_decision_guide.md`
+
+## Best Practices Summary
+
+### Code Quality
+- Follow established patterns
+- Write comprehensive tests
+- Document decisions
+- Review regularly
+
+### Performance
+- Measure before optimizing
+- Use appropriate caching
+- Optimize critical paths
+- Monitor in production
+
+### Security
+- Validate all inputs
+- Use parameterized queries
+- Implement proper authentication
+- Keep dependencies updated
+
+### Maintainability
+- Write clear code
+- Use consistent naming
+- Add helpful comments
+- Keep it simple
+
+## Common Commands
+
+```bash
+# Development
+npm run dev
+npm run build
+npm run test
+npm run lint
+
+# Analysis
+python scripts/project_architect.py .
+python scripts/dependency_analyzer.py --analyze
+
+# Deployment
+docker build -t app:latest .
+docker-compose up -d
+kubectl apply -f k8s/
+```
+
+## Troubleshooting
+
+### Common Issues
+
+Check the comprehensive troubleshooting section in `references/tech_decision_guide.md`.
+
+### Getting Help
+
+- Review reference documentation
+- Check script output messages
+- Consult tech stack documentation
+- Review error logs
+
+## Resources
+
+- Pattern Reference: `references/architecture_patterns.md`
+- Workflow Guide: `references/system_design_workflows.md`
+- Technical Guide: `references/tech_decision_guide.md`
+- Tool Scripts: `scripts/` directory