# AI Development Skills Repository

This directory contains reusable skills and patterns extracted from Windsurf conversation history across all repositories. These skills represent proven approaches to common development tasks that can be applied consistently across projects.

## Skill Categories

### 🏗️ Architecture & Setup

- **Monorepo Management** - Managing multi-repo workspaces with shared dependencies
- **Service Architecture** - Fastify microservices patterns with Cosmos DB
- **Mobile Architecture** - KMP + Native iOS/Android patterns
- **Dashboard Architecture** - Next.js dashboards with shared packages

### 🔧 Development Workflows

- **Production Readiness** - Comprehensive pre-release validation
- **Debugging Services** - Systematic debugging methodology
- **Local Development** - Starting and managing all services locally
- **Docker Compose** - Container orchestration for full stack

### 📱 Mobile Development

- **Mobile Code Quality** - Cross-platform mobile code standards
- **iOS Development** - SwiftUI + Xcode patterns
- **Android Development** - Kotlin + Jetpack Compose patterns
- **KMP Development** - Kotlin Multiplatform best practices

### 🚀 Release & Deployment

- **Desktop Release** - Cross-platform desktop app packaging
- **iOS Release** - TestFlight and App Store deployment
- **Service Deployment** - Microservice deployment patterns
- **Dashboard Deployment** - Next.js production deployment

### 🧪 Testing & Quality

- **Test Strategies** - Unit, integration, and E2E testing patterns
- **Code Quality** - Linting, formatting, and static analysis
- **Security Auditing** - Dependency and code security checks
- **Performance Monitoring** - Bundle size and performance budgets

### 📚 Documentation & Communication

- **Agent Documentation** - Maintaining AI assistant documentation
- **API Documentation** - REST API documentation patterns
- **Architecture Documentation** - System design documentation
- **Onboarding Documentation** - Developer onboarding materials

## How to Use These Skills

1. **Browse by category** - Each skill has its own markdown file with detailed instructions
2. **Copy-paste commands** - Most skills include ready-to-use command snippets
3. **Adapt patterns** - Modify the patterns to fit your specific project needs
4. **Combine skills** - Many workflows combine multiple skills (e.g., Production Readiness)
5. **Contribute back** - Add new skills or improve existing ones based on your experience

## Skill Format

Each skill follows a consistent format:

- **Description** - What the skill does and when to use it
- **Prerequisites** - Required tools and setup
- **Steps** - Detailed, copy-pasteable instructions
- **Notes** - Important considerations and tips
- **Related Skills** - Links to related skills

## Quick Reference

| Need                            | Skill                                                 | Location                         |
| ------------------------------- | ----------------------------------------------------- | -------------------------------- |
| Fix a failing service           | [Debug Service](./debug-service.md)                   | 🔧 Development Workflows         |
| Prepare for release             | [Production Readiness](./production-readiness.md)     | 🧪 Testing & Quality             |
| Start all services locally      | [Local Development Setup](./local-development.md)     | 🔧 Development Workflows         |
| Backup main branch              | [Backup Main Branch](./backup-main-branch.md)         | 🔧 Development Workflows         |
| Release desktop app             | [Desktop Release](./desktop-release.md)               | 🚀 Release & Deployment          |
| Release iOS app                 | [iOS Release](./ios-release.md)                       | 🚀 Release & Deployment          |
| Generate store assets           | [Generate Store Assets](./generate-store-assets.md)   | 🚀 Release & Deployment          |
| Ensure mobile code quality      | [Mobile Code Quality](./mobile-code-quality.md)       | 📱 Mobile Development            |
| Update AI docs                  | `../../.windsurf/workflows/repo_update-agent-docs.md` | 📚 Documentation & Communication |
| Write tests                     | [Test Strategies](./test-strategies.md)               | 🧪 Testing & Quality             |
| Docker full stack               | [Docker Compose](./docker-compose.md)                 | 🔧 Development Workflows         |
| Security audit                  | [Security Auditing](./security-auditing.md)           | 🧪 Testing & Quality             |
| Architecture patterns           | [Architecture Patterns](./architecture-patterns.md)   | 🏗️ Architecture & Setup          |
| Route `gh` CLI to right account | [GH Account Routing](./gh-account-routing.md)         | 🔧 Development Workflows         |

## Available Skills

### Core Skills ✅

- [Debug Service](./debug-service.md) - Debug any service systematically
- [Production Readiness](./production-readiness.md) - Complete pre-release validation
- [Local Development Setup](./local-development.md) - Run all services locally
- [GH Account Routing](./gh-account-routing.md) - Auto-route `gh` CLI between personal and work GitHub accounts
- [Docker Compose](./docker-compose.md) - Containerized full stack
- [Backup Main Branch](./backup-main-branch.md) - Smart backup with duplicate detection
- [Mobile Code Quality](./mobile-code-quality.md) - Cross-platform mobile standards
- [Desktop Release](./desktop-release.md) - Build and package desktop apps
- [iOS Release](./ios-release.md) - TestFlight and App Store deployment
- [Generate Store Assets](./generate-store-assets.md) - Create app store artwork
- [Agent Behavior Guidelines](./agent-behavior-guidelines.md) - Canonical agent rules
- Update agent docs across repos — see `../../.windsurf/workflows/repo_update-agent-docs.md`
- [Test Strategies](./test-strategies.md) - Comprehensive testing approach
- [Test Desktop App](./test-desktop-app.md) - Desktop app testing
- [Test iOS App](./test-ios-app.md) - iOS simulator testing
- [Architecture Patterns](./architecture-patterns.md) - System design patterns
- [Security Auditing](./security-auditing.md) - Security checks and best practices
- [Scan Repo Context](./scan-repo-context.md) - Generate project documentation

### Planned Skills 📋

- Monorepo Management
- iOS/Android Development
- Service Deployment
- Performance Monitoring
- API Documentation
- And more...

---

_Last updated: 2025-02-12_
