--- name: skill-master description: Discover codebase patterns and auto-generate SKILL files for .claude/skills/. Use when analyzing project for missing skills, creating new skills from codebase patterns, or syncing skills with project structure. version: 1.0.0 --- # Skill Master ## Overview Analyze codebase to discover patterns and generate/update SKILL files in `.claude/skills/`. Supports multi-platform projects with stack-specific pattern detection. **Capabilities:** - Scan codebase for architectural patterns (ViewModel, Repository, Room, etc.) - Compare detected patterns with existing skills - Auto-generate SKILL files with real code examples - Version tracking and smart updates ## How the AI discovers and uses this skill This skill triggers when user: - Asks to analyze project for missing skills - Requests skill generation from codebase patterns - Wants to sync or update existing skills - Mentions "skill discovery", "generate skills", or "skill-sync" **Detection signals:** - `.claude/skills/` directory presence - Project structure matching known patterns - Build/config files indicating platform (see references) ## Modes ### Discover Mode Analyze codebase and report missing skills. **Steps:** 1. Detect platform via build/config files (see references) 2. Scan source roots for pattern indicators 3. Compare detected patterns with existing `.claude/skills/` 4. Output gap analysis report **Output format:** ``` Detected Patterns: {count} | Pattern | Files Found | Example Location | |---------|-------------|------------------| | {name} | {count} | {path} | Existing Skills: {count} Missing Skills: {count} - {skill-name}: {pattern}, {file-count} files found ``` ### Generate Mode Create SKILL files from detected patterns. **Steps:** 1. Run discovery to identify missing skills 2. For each missing skill: - Find 2-3 representative source files - Extract: imports, annotations, class structure, conventions - Extract rules from `.ruler/*.md` if present 3. Generate SKILL.md using template structure 4. Add version and source marker **Generated SKILL structure:** ```yaml --- name: {pattern-name} description: {Generated description with trigger keywords} version: 1.0.0 --- # {Title} ## Overview {Brief description from pattern analysis} ## File Structure {Extracted from codebase} ## Implementation Pattern {Real code examples - anonymized} ## Rules ### Do {From .ruler/*.md + codebase conventions} ### Don't {Anti-patterns found} ## File Location {Actual paths from codebase} ``` ## Create Strategy When target SKILL file does not exist: 1. Generate new file using template 2. Set `version: 1.0.0` in frontmatter 3. Include all mandatory sections 4. Add source marker at end (see Marker Format) ## Update Strategy **Marker check:** Look for `<!-- Generated by skill-master command` at file end. **If marker present (subsequent run):** - Smart merge: preserve custom content, add missing sections - Increment version: major (breaking) / minor (feature) / patch (fix) - Update source list in marker **If marker absent (first run on existing file):** - Backup: `SKILL.md` → `SKILL.md.bak` - Use backup as source, extract relevant content - Generate fresh file with marker - Set `version: 1.0.0` ## Marker Format Place at END of generated SKILL.md: ```html <!-- Generated by skill-master command Version: {version} Sources: - path/to/source1.kt - path/to/source2.md - .ruler/rule-file.md Last updated: {YYYY-MM-DD} --> ``` ## Platform References Read relevant reference when platform detected: | Platform | Detection Files | Reference | |----------|-----------------|-----------| | Android/Gradle | `build.gradle`, `settings.gradle` | `references/android.md` | | iOS/Xcode | `*.xcodeproj`, `Package.swift` | `references/ios.md` | | React (web) | `package.json` + react | `references/react-web.md` | | React Native | `package.json` + react-native | `references/react-native.md` | | Flutter/Dart | `pubspec.yaml` | `references/flutter.md` | | Node.js | `package.json` | `references/node.md` | | Python | `pyproject.toml`, `requirements.txt` | `references/python.md` | | Java/JVM | `pom.xml`, `build.gradle` | `references/java.md` | | .NET/C# | `*.csproj`, `*.sln` | `references/dotnet.md` | | Go | `go.mod` | `references/go.md` | | Rust | `Cargo.toml` | `references/rust.md` | | PHP | `composer.json` | `references/php.md` | | Ruby | `Gemfile` | `references/ruby.md` | | Elixir | `mix.exs` | `references/elixir.md` | | C/C++ | `CMakeLists.txt`, `Makefile` | `references/cpp.md` | | Unknown | - | `references/generic.md` | If multiple platforms detected, read multiple references. ## Rules ### Do - Only extract patterns verified in codebase - Use real code examples (anonymize business logic) - Include trigger keywords in description - Keep SKILL.md under 500 lines - Reference external files for detailed content - Preserve custom sections during updates - Always backup before first modification ### Don't - Include secrets, tokens, or credentials - Include business-specific logic details - Generate placeholders without real content - Overwrite user customizations without backup - Create deep reference chains (max 1 level) - Write outside `.claude/skills/` ## Content Extraction Rules **From codebase:** - Extract: class structures, annotations, import patterns, file locations, naming conventions - Never: hardcoded values, secrets, API keys, PII **From .ruler/*.md (if present):** - Extract: Do/Don't rules, architecture constraints, dependency rules ## Output Report After generation, print: ``` SKILL GENERATION REPORT Skills Generated: {count} {skill-name} [CREATED | UPDATED | BACKED_UP+CREATED] ├── Analyzed: {file-count} source files ├── Sources: {list of source files} ├── Rules from: {.ruler files if any} └── Output: .claude/skills/{skill-name}/SKILL.md ({line-count} lines) Validation: ✓ YAML frontmatter valid ✓ Description includes trigger keywords ✓ Content under 500 lines ✓ Has required sections ``` ## Safety Constraints - Never write outside `.claude/skills/` - Never delete content without backup - Always backup before first-time modification - Preserve user customizations - Deterministic: same input → same output FILE:references/android.md # Android (Gradle/Kotlin) ## Detection signals - `settings.gradle` or `settings.gradle.kts` - `build.gradle` or `build.gradle.kts` - `gradle.properties`, `gradle/libs.versions.toml` - `gradlew`, `gradle/wrapper/gradle-wrapper.properties` - `app/src/main/AndroidManifest.xml` ## Multi-module signals - Multiple `include(...)` in `settings.gradle*` - Multiple dirs with `build.gradle*` + `src/` - Common roots: `feature/`, `core/`, `library/`, `domain/`, `data/` ## Pre-generation sources - `settings.gradle*` (module list) - `build.gradle*` (root + modules) - `gradle/libs.versions.toml` (dependencies) - `config/detekt/detekt.yml` (if present) - `**/AndroidManifest.xml` ## Codebase scan patterns ### Source roots - `*/src/main/java/`, `*/src/main/kotlin/` ### Layer/folder patterns (record if present) `features/`, `core/`, `common/`, `data/`, `domain/`, `presentation/`, `ui/`, `di/`, `navigation/`, `network/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | ViewModel | `@HiltViewModel`, `ViewModel()`, `MVI<` | viewmodel-mvi | | Repository | `*Repository`, `*RepositoryImpl` | data-repository | | UseCase | `operator fun invoke`, `*UseCase` | domain-usecase | | Room Entity | `@Entity`, `@PrimaryKey`, `@ColumnInfo` | room-entity | | Room DAO | `@Dao`, `@Query`, `@Insert`, `@Update` | room-dao | | Migration | `Migration(`, `@Database(version=` | room-migration | | Type Converter | `@TypeConverter`, `@TypeConverters` | type-converter | | DTO | `@SerializedName`, `*Request`, `*Response` | network-dto | | Compose Screen | `@Composable`, `NavGraphBuilder.` | compose-screen | | Bottom Sheet | `ModalBottomSheet`, `*BottomSheet(` | bottomsheet-screen | | Navigation | `@Route`, `NavGraphBuilder.`, `composable(` | navigation-route | | Hilt Module | `@Module`, `@Provides`, `@Binds`, `@InstallIn` | hilt-module | | Worker | `@HiltWorker`, `CoroutineWorker`, `WorkManager` | worker-task | | DataStore | `DataStore<Preferences>`, `preferencesDataStore` | datastore-preference | | Retrofit API | `@GET`, `@POST`, `@PUT`, `@DELETE` | retrofit-api | | Mapper | `*.toModel()`, `*.toEntity()`, `*.toDto()` | data-mapper | | Interceptor | `Interceptor`, `intercept()` | network-interceptor | | Paging | `PagingSource`, `Pager(`, `PagingData` | paging-source | | Broadcast Receiver | `BroadcastReceiver`, `onReceive(` | broadcast-receiver | | Android Service | `: Service()`, `ForegroundService` | android-service | | Notification | `NotificationCompat`, `NotificationChannel` | notification-builder | | Analytics | `FirebaseAnalytics`, `logEvent` | analytics-event | | Feature Flag | `RemoteConfig`, `FeatureFlag` | feature-flag | | App Widget | `AppWidgetProvider`, `GlanceAppWidget` | app-widget | | Unit Test | `@Test`, `MockK`, `mockk(`, `every {` | unit-test | ## Mandatory output sections Include if detected (list actual names found): - **Features inventory**: dirs under `feature/` - **Core modules**: dirs under `core/`, `library/` - **Navigation graphs**: `*Graph.kt`, `*Navigator*.kt` - **Hilt modules**: `@Module` classes, `di/` contents - **Retrofit APIs**: `*Api.kt` interfaces - **Room databases**: `@Database` classes - **Workers**: `@HiltWorker` classes - **Proguard**: `proguard-rules.pro` if present ## Command sources - README/docs invoking `./gradlew` - CI workflows with Gradle commands - Common: `./gradlew assemble`, `./gradlew test`, `./gradlew lint` - Only include commands present in repo ## Key paths - `app/src/main/`, `app/src/main/res/` - `app/src/main/java/`, `app/src/main/kotlin/` - `app/src/test/`, `app/src/androidTest/` - `library/database/migration/` (Room migrations) FILE:README.md FILE:references/cpp.md # C/C++ ## Detection signals - `CMakeLists.txt` - `Makefile`, `makefile` - `*.cpp`, `*.c`, `*.h`, `*.hpp` - `conanfile.txt`, `conanfile.py` (Conan) - `vcpkg.json` (vcpkg) ## Multi-module signals - Multiple `CMakeLists.txt` with `add_subdirectory` - Multiple `Makefile` in subdirs - `lib/`, `src/`, `modules/` directories ## Pre-generation sources - `CMakeLists.txt` (dependencies, targets) - `conanfile.*` (dependencies) - `vcpkg.json` (dependencies) - `Makefile` (build targets) ## Codebase scan patterns ### Source roots - `src/`, `lib/`, `include/` ### Layer/folder patterns (record if present) `core/`, `utils/`, `network/`, `storage/`, `ui/`, `tests/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Class | `class *`, `public:`, `private:` | cpp-class | | Header | `*.h`, `*.hpp`, `#pragma once` | header-file | | Template | `template<`, `typename T` | cpp-template | | Smart Pointer | `std::unique_ptr`, `std::shared_ptr` | smart-pointer | | RAII | destructor pattern, `~*()` | raii-pattern | | Singleton | `static *& instance()` | singleton | | Factory | `create*()`, `make*()` | factory-pattern | | Observer | `subscribe`, `notify`, callback pattern | observer-pattern | | Thread | `std::thread`, `std::async`, `pthread` | threading | | Mutex | `std::mutex`, `std::lock_guard` | synchronization | | Network | `socket`, `asio::`, `boost::asio` | network-cpp | | Serialization | `nlohmann::json`, `protobuf` | serialization | | Unit Test | `TEST(`, `TEST_F(`, `gtest` | gtest | | Catch2 Test | `TEST_CASE(`, `REQUIRE(` | catch2-test | ## Mandatory output sections Include if detected: - **Core modules**: main functionality - **Libraries**: internal libraries - **Headers**: public API - **Tests**: test organization - **Build targets**: executables, libraries ## Command sources - `CMakeLists.txt` custom targets - `Makefile` targets - README/docs, CI - Common: `cmake`, `make`, `ctest` - Only include commands present in repo ## Key paths - `src/`, `include/` - `lib/`, `libs/` - `tests/`, `test/` - `build/` (out-of-source) FILE:references/dotnet.md # .NET (C#/F#) ## Detection signals - `*.csproj`, `*.fsproj` - `*.sln` - `global.json` - `appsettings.json` - `Program.cs`, `Startup.cs` ## Multi-module signals - Multiple `*.csproj` files - Solution with multiple projects - `src/`, `tests/` directories with projects ## Pre-generation sources - `*.csproj` (dependencies, SDK) - `*.sln` (project structure) - `appsettings.json` (config) - `global.json` (SDK version) ## Codebase scan patterns ### Source roots - `src/`, `*/` (per project) ### Layer/folder patterns (record if present) `Controllers/`, `Services/`, `Repositories/`, `Models/`, `Entities/`, `DTOs/`, `Middleware/`, `Extensions/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Controller | `[ApiController]`, `ControllerBase`, `[HttpGet]` | aspnet-controller | | Service | `I*Service`, `class *Service` | dotnet-service | | Repository | `I*Repository`, `class *Repository` | dotnet-repository | | Entity | `class *Entity`, `[Table]`, `[Key]` | ef-entity | | DTO | `class *Dto`, `class *Request`, `class *Response` | dto-pattern | | DbContext | `: DbContext`, `DbSet<` | ef-dbcontext | | Middleware | `IMiddleware`, `RequestDelegate` | aspnet-middleware | | Background Service | `BackgroundService`, `IHostedService` | background-service | | MediatR Handler | `IRequestHandler<`, `INotificationHandler<` | mediatr-handler | | SignalR Hub | `: Hub`, `[HubName]` | signalr-hub | | Minimal API | `app.MapGet(`, `app.MapPost(` | minimal-api | | gRPC Service | `*.proto`, `: *Base` | grpc-service | | EF Migration | `Migrations/`, `AddMigration` | ef-migration | | Unit Test | `[Fact]`, `[Theory]`, `xUnit` | xunit-test | | Integration Test | `WebApplicationFactory`, `IClassFixture` | integration-test | ## Mandatory output sections Include if detected: - **Controllers**: API endpoints - **Services**: business logic - **Repositories**: data access (EF Core) - **Entities/DTOs**: data models - **Middleware**: request pipeline - **Background services**: hosted services ## Command sources - `*.csproj` targets - README/docs, CI - Common: `dotnet build`, `dotnet test`, `dotnet run` - Only include commands present in repo ## Key paths - `src/*/`, project directories - `tests/` - `Migrations/` - `Properties/` FILE:references/elixir.md # Elixir/Erlang ## Detection signals - `mix.exs` - `mix.lock` - `config/config.exs` - `lib/`, `test/` directories ## Multi-module signals - Umbrella app (`apps/` directory) - Multiple `mix.exs` in subdirs - `rel/` for releases ## Pre-generation sources - `mix.exs` (dependencies, config) - `config/*.exs` (configuration) - `rel/config.exs` (releases) ## Codebase scan patterns ### Source roots - `lib/`, `apps/*/lib/` ### Layer/folder patterns (record if present) `controllers/`, `views/`, `channels/`, `contexts/`, `schemas/`, `workers/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Phoenix Controller | `use *Web, :controller`, `def index` | phoenix-controller | | Phoenix LiveView | `use *Web, :live_view`, `mount/3` | phoenix-liveview | | Phoenix Channel | `use *Web, :channel`, `join/3` | phoenix-channel | | Ecto Schema | `use Ecto.Schema`, `schema "` | ecto-schema | | Ecto Migration | `use Ecto.Migration`, `create table` | ecto-migration | | Ecto Changeset | `cast/4`, `validate_required` | ecto-changeset | | Context | `defmodule *Context`, `def list_*` | phoenix-context | | GenServer | `use GenServer`, `handle_call` | genserver | | Supervisor | `use Supervisor`, `start_link` | supervisor | | Task | `Task.async`, `Task.Supervisor` | elixir-task | | Oban Worker | `use Oban.Worker`, `perform/1` | oban-worker | | Absinthe | `use Absinthe.Schema`, `field :` | graphql-schema | | ExUnit Test | `use ExUnit.Case`, `test "` | exunit-test | ## Mandatory output sections Include if detected: - **Controllers/LiveViews**: HTTP/WebSocket handlers - **Contexts**: business logic - **Schemas**: Ecto models - **Channels**: real-time handlers - **Workers**: background jobs ## Command sources - `mix.exs` aliases - README/docs, CI - Common: `mix deps.get`, `mix test`, `mix phx.server` - Only include commands present in repo ## Key paths - `lib/*/`, `lib/*_web/` - `priv/repo/migrations/` - `test/` - `config/` FILE:references/flutter.md # Flutter/Dart ## Detection signals - `pubspec.yaml` - `lib/main.dart` - `android/`, `ios/`, `web/` directories - `.dart_tool/` - `analysis_options.yaml` ## Multi-module signals - `melos.yaml` (monorepo) - Multiple `pubspec.yaml` in subdirs - `packages/` directory ## Pre-generation sources - `pubspec.yaml` (dependencies) - `analysis_options.yaml` - `build.yaml` (if using build_runner) - `lib/main.dart` (entry point) ## Codebase scan patterns ### Source roots - `lib/`, `test/` ### Layer/folder patterns (record if present) `screens/`, `widgets/`, `models/`, `services/`, `providers/`, `repositories/`, `utils/`, `constants/`, `bloc/`, `cubit/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Screen/Page | `*Screen`, `*Page`, `extends StatefulWidget` | flutter-screen | | Widget | `extends StatelessWidget`, `extends StatefulWidget` | flutter-widget | | BLoC | `extends Bloc<`, `extends Cubit<` | bloc-pattern | | Provider | `ChangeNotifier`, `Provider.of<`, `context.read<` | provider-pattern | | Riverpod | `@riverpod`, `ref.watch`, `ConsumerWidget` | riverpod-provider | | GetX | `GetxController`, `Get.put`, `Obx(` | getx-controller | | Repository | `*Repository`, `abstract class *Repository` | data-repository | | Service | `*Service` | service-layer | | Model | `fromJson`, `toJson`, `@JsonSerializable` | json-model | | Freezed | `@freezed`, `part '*.freezed.dart'` | freezed-model | | API Client | `Dio`, `http.Client`, `Retrofit` | api-client | | Navigation | `Navigator`, `GoRouter`, `auto_route` | flutter-navigation | | Localization | `AppLocalizations`, `l10n`, `intl` | flutter-l10n | | Testing | `testWidgets`, `WidgetTester`, `flutter_test` | widget-test | | Integration Test | `integration_test`, `IntegrationTestWidgetsFlutterBinding` | integration-test | ## Mandatory output sections Include if detected: - **Screens inventory**: dirs under `screens/`, `pages/` - **State management**: BLoC, Provider, Riverpod, GetX - **Navigation setup**: GoRouter, auto_route, Navigator - **DI approach**: get_it, injectable, manual - **API layer**: Dio, http, Retrofit - **Models**: Freezed, json_serializable ## Command sources - `pubspec.yaml` scripts (if using melos) - README/docs - Common: `flutter run`, `flutter test`, `flutter build` - Only include commands present in repo ## Key paths - `lib/`, `test/` - `lib/screens/`, `lib/widgets/` - `lib/bloc/`, `lib/providers/` - `assets/` FILE:references/generic.md # Generic/Unknown Stack Fallback reference when no specific platform is detected. ## Detection signals - No specific build/config files found - Mixed technology stack - Documentation-only repository ## Multi-module signals - Multiple directories with separate concerns - `packages/`, `modules/`, `libs/` directories - Monorepo structure without specific tooling ## Pre-generation sources - `README.md` (project overview) - `docs/*` (documentation) - `.env.example` (environment vars) - `docker-compose.yml` (services) - CI files (`.github/workflows/`, etc.) ## Codebase scan patterns ### Source roots - `src/`, `lib/`, `app/` ### Layer/folder patterns (record if present) `api/`, `core/`, `utils/`, `services/`, `models/`, `config/`, `scripts/` ### Generic pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Entry Point | `main.*`, `index.*`, `app.*` | entry-point | | Config | `config.*`, `settings.*` | config-file | | API Client | `api/`, `client/`, HTTP calls | api-client | | Model | `model/`, `types/`, data structures | data-model | | Service | `service/`, business logic | service-layer | | Utility | `utils/`, `helpers/`, `common/` | utility-module | | Test | `test/`, `tests/`, `*_test.*`, `*.test.*` | test-file | | Script | `scripts/`, `bin/` | script-file | | Documentation | `docs/`, `*.md` | documentation | ## Mandatory output sections Include if detected: - **Project structure**: main directories - **Entry points**: main files - **Configuration**: config files - **Dependencies**: any package manager - **Build/Run commands**: from README/scripts ## Command sources - `README.md` (look for code blocks) - `Makefile`, `Taskfile.yml` - `scripts/` directory - CI workflows - Only include commands present in repo ## Key paths - `src/`, `lib/` - `docs/` - `scripts/` - `config/` ## Notes When using this generic reference: 1. Scan for any recognizable patterns 2. Document actual project structure found 3. Extract commands from README if available 4. Note any technologies mentioned in docs 5. Keep output minimal and factual FILE:references/go.md # Go ## Detection signals - `go.mod` - `go.sum` - `main.go` - `cmd/`, `internal/`, `pkg/` directories ## Multi-module signals - `go.work` (workspace) - Multiple `go.mod` files - `cmd/*/main.go` (multiple binaries) ## Pre-generation sources - `go.mod` (dependencies) - `Makefile` (build commands) - `config/*.yaml` or `*.toml` ## Codebase scan patterns ### Source roots - `cmd/`, `internal/`, `pkg/` ### Layer/folder patterns (record if present) `handler/`, `service/`, `repository/`, `model/`, `middleware/`, `config/`, `util/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | HTTP Handler | `http.Handler`, `http.HandlerFunc`, `gin.Context` | http-handler | | Gin Route | `gin.Engine`, `r.GET(`, `r.POST(` | gin-route | | Echo Route | `echo.Echo`, `e.GET(`, `e.POST(` | echo-route | | Fiber Route | `fiber.App`, `app.Get(`, `app.Post(` | fiber-route | | gRPC Service | `*.proto`, `pb.*Server` | grpc-service | | Repository | `type *Repository interface`, `*Repository` | data-repository | | Service | `type *Service interface`, `*Service` | service-layer | | GORM Model | `gorm.Model`, `*gorm.DB` | gorm-model | | sqlx | `sqlx.DB`, `sqlx.NamedExec` | sqlx-usage | | Migration | `goose`, `golang-migrate` | db-migration | | Middleware | `func(*Context)`, `middleware.*` | go-middleware | | Worker | `go func()`, `sync.WaitGroup`, `errgroup` | worker-goroutine | | Config | `viper`, `envconfig`, `cleanenv` | config-loader | | Unit Test | `*_test.go`, `func Test*(t *testing.T)` | go-test | | Mock | `mockgen`, `*_mock.go` | go-mock | ## Mandatory output sections Include if detected: - **HTTP handlers**: API endpoints - **Services**: business logic - **Repositories**: data access - **Models**: data structures - **Middleware**: request interceptors - **Migrations**: database migrations ## Command sources - `Makefile` targets - README/docs, CI - Common: `go build`, `go test`, `go run` - Only include commands present in repo ## Key paths - `cmd/`, `internal/`, `pkg/` - `api/`, `handler/` - `migrations/` - `config/` FILE:references/ios.md # iOS (Xcode/Swift) ## Detection signals - `*.xcodeproj`, `*.xcworkspace` - `Package.swift` (SPM) - `Podfile`, `Podfile.lock` (CocoaPods) - `Cartfile` (Carthage) - `*.pbxproj` - `Info.plist` ## Multi-module signals - Multiple targets in `*.xcodeproj` - Multiple `Package.swift` files - Workspace with multiple projects - `Modules/`, `Packages/`, `Features/` directories ## Pre-generation sources - `*.xcodeproj/project.pbxproj` (target list) - `Package.swift` (dependencies, targets) - `Podfile` (dependencies) - `*.xcconfig` (build configs) - `Info.plist` files ## Codebase scan patterns ### Source roots - `*/Sources/`, `*/Source/` - `*/App/`, `*/Core/`, `*/Features/` ### Layer/folder patterns (record if present) `Models/`, `Views/`, `ViewModels/`, `Services/`, `Networking/`, `Utilities/`, `Extensions/`, `Coordinators/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | SwiftUI View | `struct *: View`, `var body: some View` | swiftui-view | | UIKit VC | `UIViewController`, `viewDidLoad()` | uikit-viewcontroller | | ViewModel | `@Observable`, `ObservableObject`, `@Published` | viewmodel-observable | | Coordinator | `Coordinator`, `*Coordinator` | coordinator-pattern | | Repository | `*Repository`, `protocol *Repository` | data-repository | | Service | `*Service`, `protocol *Service` | service-layer | | Core Data | `NSManagedObject`, `@NSManaged`, `.xcdatamodeld` | coredata-entity | | Realm | `Object`, `@Persisted` | realm-model | | Network | `URLSession`, `Alamofire`, `Moya` | network-client | | Dependency | `@Inject`, `Container`, `Swinject` | di-container | | Navigation | `NavigationStack`, `NavigationPath` | navigation-swiftui | | Combine | `Publisher`, `AnyPublisher`, `sink` | combine-publisher | | Async/Await | `async`, `await`, `Task {` | async-await | | Unit Test | `XCTestCase`, `func test*()` | xctest | | UI Test | `XCUIApplication`, `XCUIElement` | xcuitest | ## Mandatory output sections Include if detected: - **Targets inventory**: list from pbxproj - **Modules/Packages**: SPM packages, Pods - **View architecture**: SwiftUI vs UIKit - **State management**: Combine, Observable, etc. - **Networking layer**: URLSession, Alamofire, etc. - **Persistence**: Core Data, Realm, UserDefaults - **DI setup**: Swinject, manual injection ## Command sources - README/docs with xcodebuild commands - `fastlane/Fastfile` lanes - CI workflows (`.github/workflows/`, `.gitlab-ci.yml`) - Common: `xcodebuild test`, `fastlane test` - Only include commands present in repo ## Key paths - `*/Sources/`, `*/Tests/` - `*.xcodeproj/`, `*.xcworkspace/` - `Pods/` (if CocoaPods) - `Packages/` (if SPM local packages) FILE:references/java.md # Java/JVM (Spring, etc.) ## Detection signals - `pom.xml` (Maven) - `build.gradle`, `build.gradle.kts` (Gradle) - `settings.gradle` (multi-module) - `src/main/java/`, `src/main/kotlin/` - `application.properties`, `application.yml` ## Multi-module signals - Multiple `pom.xml` with `<modules>` - Multiple `build.gradle` with `include()` - `modules/`, `services/` directories ## Pre-generation sources - `pom.xml` or `build.gradle*` (dependencies) - `application.properties/yml` (config) - `settings.gradle` (modules) - `docker-compose.yml` (services) ## Codebase scan patterns ### Source roots - `src/main/java/`, `src/main/kotlin/` - `src/test/java/`, `src/test/kotlin/` ### Layer/folder patterns (record if present) `controller/`, `service/`, `repository/`, `model/`, `entity/`, `dto/`, `config/`, `exception/`, `util/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | REST Controller | `@RestController`, `@GetMapping`, `@PostMapping` | spring-controller | | Service | `@Service`, `class *Service` | spring-service | | Repository | `@Repository`, `JpaRepository`, `CrudRepository` | spring-repository | | Entity | `@Entity`, `@Table`, `@Id` | jpa-entity | | DTO | `class *DTO`, `class *Request`, `class *Response` | dto-pattern | | Config | `@Configuration`, `@Bean` | spring-config | | Component | `@Component`, `@Autowired` | spring-component | | Security | `@EnableWebSecurity`, `SecurityFilterChain` | spring-security | | Validation | `@Valid`, `@NotNull`, `@Size` | validation-pattern | | Exception Handler | `@ControllerAdvice`, `@ExceptionHandler` | exception-handler | | Scheduler | `@Scheduled`, `@EnableScheduling` | scheduled-task | | Event | `ApplicationEvent`, `@EventListener` | event-listener | | Flyway Migration | `V*__*.sql`, `flyway` | flyway-migration | | Liquibase | `changelog*.xml`, `liquibase` | liquibase-migration | | Unit Test | `@Test`, `@SpringBootTest`, `MockMvc` | spring-test | | Integration Test | `@DataJpaTest`, `@WebMvcTest` | integration-test | ## Mandatory output sections Include if detected: - **Controllers**: REST endpoints - **Services**: business logic - **Repositories**: data access (JPA, JDBC) - **Entities/DTOs**: data models - **Configuration**: Spring beans, profiles - **Security**: auth config ## Command sources - `pom.xml` plugins, `build.gradle` tasks - README/docs, CI - Common: `./mvnw`, `./gradlew`, `mvn test`, `gradle test` - Only include commands present in repo ## Key paths - `src/main/java/`, `src/main/kotlin/` - `src/main/resources/` - `src/test/` - `db/migration/` (Flyway) FILE:references/node.md # Node.js ## Detection signals - `package.json` (without react/react-native) - `tsconfig.json` - `node_modules/` - `*.js`, `*.ts`, `*.mjs`, `*.cjs` entry files ## Multi-module signals - `pnpm-workspace.yaml`, `lerna.json` - `nx.json`, `turbo.json` - Multiple `package.json` in subdirs - `packages/`, `apps/` directories ## Pre-generation sources - `package.json` (dependencies, scripts) - `tsconfig.json` (paths, compiler options) - `.env.example` (env vars) - `docker-compose.yml` (services) ## Codebase scan patterns ### Source roots - `src/`, `lib/`, `app/` ### Layer/folder patterns (record if present) `controllers/`, `services/`, `models/`, `routes/`, `middleware/`, `utils/`, `config/`, `types/`, `repositories/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------| | Express Route | `app.get(`, `app.post(`, `Router()` | express-route | | Express Middleware | `(req, res, next)`, `app.use(` | express-middleware | | NestJS Controller | `@Controller`, `@Get`, `@Post` | nestjs-controller | | NestJS Service | `@Injectable`, `@Service` | nestjs-service | | NestJS Module | `@Module`, `imports:`, `providers:` | nestjs-module | | Fastify Route | `fastify.get(`, `fastify.post(` | fastify-route | | GraphQL Resolver | `@Resolver`, `@Query`, `@Mutation` | graphql-resolver | | TypeORM Entity | `@Entity`, `@Column`, `@PrimaryGeneratedColumn` | typeorm-entity | | Prisma Model | `prisma.*.create`, `prisma.*.findMany` | prisma-usage | | Mongoose Model | `mongoose.Schema`, `mongoose.model(` | mongoose-model | | Sequelize Model | `Model.init`, `DataTypes` | sequelize-model | | Queue Worker | `Bull`, `BullMQ`, `process(` | queue-worker | | Cron Job | `@Cron`, `node-cron`, `cron.schedule` | cron-job | | WebSocket | `ws`, `socket.io`, `io.on(` | websocket-handler | | Unit Test | `describe(`, `it(`, `expect(`, `jest` | jest-test | | E2E Test | `supertest`, `request(app)` | e2e-test | ## Mandatory output sections Include if detected: - **Routes/controllers**: API endpoints - **Services layer**: business logic - **Database**: ORM/ODM usage (TypeORM, Prisma, Mongoose) - **Middleware**: auth, validation, error handling - **Background jobs**: queues, cron jobs - **WebSocket handlers**: real-time features ## Command sources - `package.json` scripts section - README/docs - CI workflows - Common: `npm run dev`, `npm run build`, `npm test` - Only include commands present in repo ## Key paths - `src/`, `lib/` - `src/routes/`, `src/controllers/` - `src/services/`, `src/models/` - `prisma/`, `migrations/` FILE:references/php.md # PHP ## Detection signals - `composer.json`, `composer.lock` - `public/index.php` - `artisan` (Laravel) - `spark` (CodeIgniter 4) - `bin/console` (Symfony) - `app/Config/App.php` (CodeIgniter 4) - `ext-phalcon` in composer.json (Phalcon) - `phalcon/devtools` (Phalcon) ## Multi-module signals - `packages/` directory - Laravel modules (`app/Modules/`) - CodeIgniter modules (`app/Modules/`, `modules/`) - Phalcon multi-app (`apps/*/`) - Multiple `composer.json` in subdirs ## Pre-generation sources - `composer.json` (dependencies) - `.env.example` (env vars) - `config/*.php` (Laravel/Symfony) - `routes/*.php` (Laravel) - `app/Config/*` (CodeIgniter 4) - `apps/*/config/` (Phalcon) ## Codebase scan patterns ### Source roots - `app/`, `src/`, `apps/` ### Layer/folder patterns (record if present) `Controllers/`, `Services/`, `Repositories/`, `Models/`, `Entities/`, `Http/`, `Providers/`, `Console/` ### Framework-specific structures **Laravel** (record if present): - `app/Http/Controllers`, `app/Models`, `database/migrations` - `routes/*.php`, `resources/views` **Symfony** (record if present): - `src/Controller`, `src/Entity`, `config/packages`, `templates` **CodeIgniter 4** (record if present): - `app/Controllers`, `app/Models`, `app/Views` - `app/Config/Routes.php`, `app/Database/Migrations` **Phalcon** (record if present): - `apps/*/controllers/`, `apps/*/Module.php` - `models/`, `views/` ### Pattern indicators | Pattern | Detection Criteria | Skill Name | |---------|-------------------|------------|