Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or…
Use when exploring product ideas, evaluating architectural alternatives, defining user journeys, or clarifying underspecified requirements before writing specs or code.
Guidelines and best practices for Kotlin Multiplatform (KMP) architecture, source set hierarchies (commonMain, androidMain, iosMain), expect/actual declarations, and platform isolation. Use when adding multiplatform abstractions, platform-specific engines, or organizing shared business logic.
Compose Multiplatform UI patterns, state hoisting, Material 3 theming, Navigation Compose routing, responsive screen layouts, and lifecycle-aware coroutine side effects. Use when building or updating Compose screens and UI components.
Multiplatform dependency injection using Koin 4.x. Use when setting up or modifying modules for networking clients, repositories, platform dependencies, and Compose ViewModels.
Best practices for configuring Ktor Client 3.x in KMP projects, sharing HttpClient instances, installing SSE and ContentNegotiation plugins, handling connection lifecycles, and managing multiplatform engines (OkHttp/Darwin). Use when implementing HTTP, SSE, or MCP transports.
Guidelines for resilient JSON serialization using kotlinx.serialization with unversioned REST APIs and polymorphic SSE events. Use when defining API data models or parsing server payloads.
Use when decomposing large tasks across specialized subagents (e.g. codebase researcher, test runner, accessibility auditor) to run parallel, focused investigation and execution.
Use when debugging issues, crashes, failing tests, or unexpected runtime behaviors. Mandates a 4-phase root-cause analysis process to isolate the real issue before attempting fixes.
Enforce a strict Test-Driven Development (TDD) cycle (Red-Green-Refactor) for implementing logic, fixing bugs, and validating contracts. Use when creating new classes, repositories, ViewModels, parsers, or fixing runtime defects.
Instructions for kareemessam09/Openship-App, covering project instructions for ai agents, beads issue tracker, quick reference, rules and agent context profiles.