swe-programming-kotlinlisted

# Kotlin Coding Standards ## Purpose Progressive disclosure of Kotlin coding standards for agents writing Kotlin code. **Authoritative Source**: [docs/explanation/software-engineering/programming-languages/kotlin/README.md](../../../docs/explanation/software-engineering/programming-languages/kotlin/README.md) **Usage**: Auto-loaded for agents when writing Kotlin code. Provides quick reference to idioms, best practices, and antipatterns. ## Prerequisite Knowledge **IMPORTANT**: This skill provides **demo-specific style guides**, not educational tutorials. **You MUST understand Kotlin fundamentals before using these standards.** Complete the demo Kotlin learning path first: **What this skill covers**: demo naming conventions, framework choices, repository-specific patterns, how to apply Kotlin knowledge in THIS codebase. **What this skill does NOT cover**: Kotlin syntax, language fundamentals, generic patterns (those are in crud-fs-ts-nextjs). ## Quick Standards Reference ### Naming Conventions **Classes/Types**: PascalCase - `ZakatCalculator`, `MurabahaContract` **Functions/Variables**: camelCase - `calculateZakat()`, `totalAmount` **Constants**: UPPER_SNAKE_CASE - `MAX_NISAB_THRESHOLD`, `ZAKAT_RATE` **Files**: PascalCase matching primary class - `ZakatCalculator.kt` ### Null Safety ```kotlin // CORRECT: Safe call operator val length = text?.length ?: 0 // CORRECT: Smart cast after null check if (contract != null) { println(contract.id) // Smart cast to n