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.
114 lines
5.8 KiB
Markdown
114 lines
5.8 KiB
Markdown
# Skills Index
|
|
|
|
## 🏗️ Architecture & Setup
|
|
|
|
- [Architecture Patterns](./architecture-patterns.md) - Common architectural patterns and structures
|
|
- [Monorepo Management](./monorepo-management.md) - Managing multi-repo workspaces
|
|
|
|
## 🔧 Development Workflows
|
|
|
|
- [Debug Service](./debug-service.md) - Systematic debugging methodology
|
|
- [Local Development Setup](./local-development.md) - Starting services locally
|
|
- [Docker Compose](./docker-compose.md) - Full stack containerization
|
|
- [Production Readiness](./production-readiness.md) - Pre-release validation
|
|
- [Backup Main Branch](./backup-main-branch.md) - Smart backup with duplicate detection
|
|
|
|
## 📱 Mobile Development
|
|
|
|
- [Mobile Code Quality](./mobile-code-quality.md) - Cross-platform mobile standards
|
|
- [iOS Development](./ios-development.md) - SwiftUI + Xcode patterns
|
|
- [Android Development](./android-development.md) - Kotlin + Jetpack Compose
|
|
- [KMP Development](./kmp-development.md) - Kotlin Multiplatform best practices
|
|
|
|
## 🚀 Release & Deployment
|
|
|
|
- [Desktop Release](./desktop-release.md) - Cross-platform desktop packaging
|
|
- [iOS Release](./ios-release.md) - TestFlight and App Store deployment
|
|
- [Service Deployment](./service-deployment.md) - Microservice deployment
|
|
- [Dashboard Deployment](./dashboard-deployment.md) - Next.js production deployment
|
|
- [Generate Store Assets](./generate-store-assets.md) - App store artwork generation
|
|
|
|
## 🧪 Testing & Quality
|
|
|
|
- [Test Strategies](./test-strategies.md) - Unit, integration, and E2E testing
|
|
- [Test Desktop App](./test-desktop-app.md) - Desktop application testing
|
|
- [Test iOS App](./test-ios-app.md) - iOS simulator testing
|
|
- [Code Quality](./code-quality.md) - Linting, formatting, static analysis
|
|
- [Security Auditing](./security-auditing.md) - Security checks and best practices
|
|
- [Performance Monitoring](./performance-monitoring.md) - Metrics and performance budgets
|
|
|
|
## 📚 Documentation & Communication
|
|
|
|
- [Agent Behavior Guidelines](./agent-behavior-guidelines.md) - Canonical agent behavior rules (Karpathy + ByteLyst)
|
|
- [Agent Onboarding](./agent-onboarding.md) - Read-order index for agents
|
|
- Update agent docs across repos — see `../../.windsurf/workflows/repo_update-agent-docs.md`
|
|
- [Scan Repo Context](./scan-repo-context.md) - Generate comprehensive project context
|
|
- [API Documentation](./api-documentation.md) - REST API documentation patterns
|
|
- [Architecture Documentation](./architecture-documentation.md) - System design docs
|
|
- [Onboarding Documentation](./onboarding-documentation.md) - Developer onboarding
|
|
|
|
## 🔍 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 | [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 |
|
|
| Mobile code quality | [Mobile Code Quality](./mobile-code-quality.md) | 📱 Mobile Development |
|
|
| Test desktop app | [Test Desktop App](./test-desktop-app.md) | 🧪 Testing & Quality |
|
|
| Test iOS app | [Test iOS App](./test-ios-app.md) | 🧪 Testing & Quality |
|
|
| Update AI docs | `../../.windsurf/workflows/repo_update-agent-docs.md` | 📚 Documentation & Communication |
|
|
| Scan repo for context | [Scan Repo Context](./scan-repo-context.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 |
|
|
|
|
## Skill Levels
|
|
|
|
### 🟢 Beginner
|
|
|
|
- [Local Development Setup](./local-development.md)
|
|
- [Debug Service](./debug-service.md)
|
|
- [Test Strategies](./test-strategies.md)
|
|
|
|
### 🟡 Intermediate
|
|
|
|
- [Production Readiness](./production-readiness.md)
|
|
- [Docker Compose](./docker-compose.md)
|
|
- [Mobile Code Quality](./mobile-code-quality.md)
|
|
- [Security Auditing](./security-auditing.md)
|
|
|
|
### 🔴 Advanced
|
|
|
|
- [Architecture Patterns](./architecture-patterns.md)
|
|
- [Desktop Release](./desktop-release.md)
|
|
- [Service Deployment](./service-deployment.md)
|
|
- [Performance Monitoring](./performance-monitoring.md)
|
|
|
|
## Contributing
|
|
|
|
To add a new skill:
|
|
|
|
1. Create a new markdown file in this directory
|
|
2. Follow the established format (description, when to use, steps, notes)
|
|
3. Add it to this index
|
|
4. Update the README.md
|
|
5. 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
|