Setup claude code rules

Author: e5l

.gitignore

@@ -13,7 +13,7 @@ build
 !.idea/icon.svg
 out
 *.iml
-.vscode
+.vscode`
 
 *.versionsBackup
 *.releaseBackup
@@ -42,3 +42,5 @@ gradle-user-home
 .kotlin
 
 scan-journal.log
+
+**/.claude/settings.local.json

CLAUDE.md

@@ -0,0 +1,40 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build Commands
+- Build: `./gradlew assemble`
+- Run all JVM tests: `./gradlew jvmTest`
+- Run specific test: `./gradlew :module-name:jvmTest --tests "fully.qualified.TestClassName"`
+- Run all tests: `./gradlew allTests`
+- Code coverage: `./gradlew koverHtmlReport`
+- Linting: `./gradlew lintKotlin`
+- Format code: `./gradlew formatKotlin`
+
+## Code Style Guidelines
+- Follow Kotlin [official style guide](https://kotlinlang.org/docs/coding-conventions.html)
+- Use star imports for `io.ktor.*` packages (configured in .editorconfig)
+- Max line length: 120 characters
+- Indent: 4 spaces (2 for JSON, YAML)
+- Include copyright header in new files
+- Document all public APIs including parameters, return types, and exceptions
+- Mark internal APIs with `@InternalAPI` annotation
+- Prefix commit messages with KTOR-{NUM} (YouTrack issue)
+- Write commit messages in present tense, imperative mood
+
+## Development Practices
+- Always use Test-Driven Development (TDD) approach
+- Write tests before implementing new features or fixing issues
+- Ensure all code is covered by appropriate tests
+- Follow test naming pattern: `DescribeWhatIsBeingTested`
+- Always verify compilation with `./gradlew assemble` before submitting changes
+- Run relevant tests with `./gradlew jvmTest` to verify functionality
+- Never return control to the user without ensuring code compiles and tests pass
+- Start with JVM-only implementation and tests unless the user specifically requests otherwise
+- Focus on core functionality first before expanding to other platforms (JS, Native)
+
+## Project Requirements
+- JDK 21 required for building
+- Multiplatform project (JVM, JS, Native)
+- Tests organized by platform in module's test directories
+- Error handling follows Kotlin conventions with specific Ktor exceptions