088a9cabd6
Followup audit of the single-source-of-truth agent-docs rollout. Several AI.dev prompts and skills still taught agents the old 8-file pattern (which would re-introduce drift) and the generator script emitted a misleading summary in --no-commit mode. AI.dev guides: - Delete AI.dev/SKILLS/update-agent-docs.md — entire doc taught the old 8-file pattern. Canonical reference is now .windsurf/workflows/repo_update-agent-docs.md. - AI.dev/SKILLS/index.md + README.md: replace dangling 'Update Agent Documentation' link with pointers to agent-behavior-guidelines.md, agent-onboarding.md, and the workflow doc. - AI.dev/SKILLS/scan-repo-context.md: remove instructions to read .windsurfrules / write .cursorrules. Point at the canonical behavior file. - AI.dev/PROMPTS/new-product-scaffold.md: remove .windsurfrules and CLAUDE.md from the scaffold tree. Add deprecated-files callout + regeneration hint. - AI.dev/PROMPTS/agents-md-sync.md: drop 'Step 4 update CLAUDE.md', point at the generator instead. Remove CLAUDE.md from `git add`. - AI.dev/PROMPTS/ecosystem-audit.md: replace 'CLAUDE.md exists?' with 'canonical-behavior-pointer block present? legacy files absent?'. Script UX: - scripts/update-agent-docs.sh: stop printing 'All repos already in sync' when --no-commit suppressed commits or --dry-run was used. Emit accurate per-mode summaries instead.
5.8 KiB
5.8 KiB
Skills Index
🏗️ Architecture & Setup
- Architecture Patterns - Common architectural patterns and structures
- Monorepo Management - Managing multi-repo workspaces
🔧 Development Workflows
- Debug Service - Systematic debugging methodology
- Local Development Setup - Starting services locally
- Docker Compose - Full stack containerization
- Production Readiness - Pre-release validation
- Backup Main Branch - Smart backup with duplicate detection
📱 Mobile Development
- Mobile Code Quality - Cross-platform mobile standards
- iOS Development - SwiftUI + Xcode patterns
- Android Development - Kotlin + Jetpack Compose
- KMP Development - Kotlin Multiplatform best practices
🚀 Release & Deployment
- Desktop Release - Cross-platform desktop packaging
- iOS Release - TestFlight and App Store deployment
- Service Deployment - Microservice deployment
- Dashboard Deployment - Next.js production deployment
- Generate Store Assets - App store artwork generation
🧪 Testing & Quality
- Test Strategies - Unit, integration, and E2E testing
- Test Desktop App - Desktop application testing
- Test iOS App - iOS simulator testing
- Code Quality - Linting, formatting, static analysis
- Security Auditing - Security checks and best practices
- Performance Monitoring - Metrics and performance budgets
📚 Documentation & Communication
- Agent Behavior Guidelines - Canonical agent behavior rules (Karpathy + ByteLyst)
- Agent Onboarding - Read-order index for agents
- Update agent docs across repos — see
../../.windsurf/workflows/repo_update-agent-docs.md - Scan Repo Context - Generate comprehensive project context
- API Documentation - REST API documentation patterns
- Architecture Documentation - System design docs
- Onboarding Documentation - Developer onboarding
🔍 Quick Reference
| Need | Skill | Location |
|---|---|---|
| Fix a failing service | Debug Service | 🔧 Development Workflows |
| Prepare for release | Production Readiness | 🧪 Testing & Quality |
| Start all services | Local Development Setup | 🔧 Development Workflows |
| Backup main branch | Backup Main Branch | 🔧 Development Workflows |
| Release desktop app | Desktop Release | 🚀 Release & Deployment |
| Release iOS app | iOS Release | 🚀 Release & Deployment |
| Generate store assets | Generate Store Assets | 🚀 Release & Deployment |
| Mobile code quality | Mobile Code Quality | 📱 Mobile Development |
| Test desktop app | Test Desktop App | 🧪 Testing & Quality |
| Test iOS app | Test iOS App | 🧪 Testing & Quality |
| Update AI docs | ../../.windsurf/workflows/repo_update-agent-docs.md |
📚 Documentation & Communication |
| Scan repo for context | Scan Repo Context | 📚 Documentation & Communication |
| Write tests | Test Strategies | 🧪 Testing & Quality |
| Docker full stack | Docker Compose | 🔧 Development Workflows |
| Security audit | Security Auditing | 🧪 Testing & Quality |
| Architecture patterns | Architecture Patterns | 🏗️ Architecture & Setup |
Skill Levels
🟢 Beginner
🟡 Intermediate
🔴 Advanced
Contributing
To add a new skill:
- Create a new markdown file in this directory
- Follow the established format (description, when to use, steps, notes)
- Add it to this index
- Update the README.md
- Commit with message:
docs: add <skill-name> skill
Tags
Each skill includes tags for easy discovery:
#beginner- Easy to get started#intermediate- Requires some experience#advanced- Complex topics#critical- Essential for production#automation- Can be automated#security- Security-related#performance- Performance-related