refactor: Consolidate documentation into /docs

- Move module structure, version management, and architectural pattern documentation from `CONTRIBUTING.md` and `AI_AGENT_GUIDE.md` into the `/docs` directory.
- Update `CONTRIBUTING.md` and `AI_AGENT_GUIDE.md` to link to the new centralized documentation in `docs/README.md` and `docs/ARCHITECTURE.md`.
- Remove redundant sections (Key Concepts, Build Commands, Platform Support, etc.) from the main `docs/README.md` to streamline its content.
- Add a new link for "Web Development" to `docs/README.md`.

Author: softartdev

CONTRIBUTING.md

@@ -341,31 +341,7 @@ class FeatureViewModelTest {
 
 ## Module Structure
 
-### Core Modules
-
-- **core:domain** - Pure business logic, no dependencies
-- **core:presentation** - ViewModels, state management
-- **core:data:db-sqldelight** - SQLDelight data implementation (default)
-- **core:data:db-room** - Room data implementation (alternative)
-- **core:test** - Shared test utilities
-
-### UI Modules
-
-- **ui:shared** - Shared Compose UI (100% shared)
-- **ui:test-jvm** - UI testing framework (Kaspresso-inspired)
-
-### App Modules
-
-- **app:android** - Android application
-- **app:desktop** - Desktop JVM application
-- **app:web** - Web/Wasm application
-- **app:ios-kit** - iOS framework (CocoaPods)
-- **app:iosApp** - iOS application (Swift/SwiftUI)
-
-### Build Modules
-
-- **build-logic** - Gradle convention plugins
-- **thirdparty** - Vendored dependencies
+**See [docs/README.md](docs/README.md#module-documentation) for the list of modules and their documentation.**
 
 ### Module Guidelines
 

docs/AI_AGENT_GUIDE.md

@@ -19,20 +19,9 @@ This guide is specifically written for AI agents working on the NoteDelight code
 ./gradlew :app:web:wasmJsBrowserDevelopmentRun --continuous  # Web app
 ```
 
-### Version Management Quick Reference
+### Version Management
 
-```bash
-# Update versions in all platform files, then:
-git add app/*/build.gradle.kts app/iosApp/iosApp.xcodeproj/project.pbxproj app/iosApp/iosApp/Info.plist
-git commit -m "chore: bump version to X.Y.Z"
-
-# Trigger CI/CD workflows:
-git tag android/vX.Y.Z && git push origin android/vX.Y.Z
-git tag desktop/vX.Y.Z && git push origin desktop/vX.Y.Z  
-git tag ios/vX.Y.Z && git push origin ios/vX.Y.Z
-```
-
-**See [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md) for detailed instructions.**
+**See [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md) for detailed instructions and commands.**
 
 ## Understanding the Codebase
 
@@ -285,83 +274,9 @@ sealed class FeatureResult {
 
 #### Screen Pattern with Action Interface
 
-**All ViewModels in this project use the Action interface pattern** to avoid callback hell and reduce `@Composable` function signatures:
-
-```kotlin
-// 1. Define Action Interface (in Result.kt)
-sealed interface FeatureAction {
-    data class Save(val title: String, val text: String) : FeatureAction
-    data object Delete : FeatureAction
-    data object NavigateBack : FeatureAction
-}
-
-// 2. Define State (in Result.kt)
-data class FeatureResult(
-    val loading: Boolean = false,
-    val data: String? = null,
-) {
-    fun showLoading(): FeatureResult = copy(loading = true)
-    fun hideLoading(): FeatureResult = copy(loading = false)
-}
-
-// 3. ViewModel with onAction dispatcher
-class FeatureViewModel(...) : ViewModel() {
-    private val mutableStateFlow = MutableStateFlow(FeatureResult())
-    val stateFlow: StateFlow<FeatureResult> = mutableStateFlow
-    
-    fun onAction(action: FeatureAction) = when (action) {
-        is FeatureAction.Save -> saveData(action.title, action.text)
-        is FeatureAction.Delete -> deleteData()
-        is FeatureAction.NavigateBack -> router.popBackStack()
-    }
-    
-    private fun saveData(title: String, text: String) { /* ... */ }
-    private fun deleteData() { /* ... */ }
-}
-
-// 4. Composable Screen - Single onAction parameter
-@Composable
-fun FeatureScreen(viewModel: FeatureViewModel = koinViewModel()) {
-    val state by viewModel.stateFlow.collectAsState()
-    
-    FeatureContent(
-        state = state,
-        onAction = viewModel::onAction  // Single action handler
-    )
-}
-
-@Composable
-private fun FeatureContent(
-    state: FeatureResult,
-    onAction: (FeatureAction) -> Unit = {}  // Simplified signature
-) {
-    // Use actions in UI events
-    Button(onClick = { onAction(FeatureAction.Save("title", "text")) })
-    IconButton(onClick = { onAction(FeatureAction.Delete) })
-}
-```
+**All ViewModels in this project use the Action interface pattern** to avoid callback hell and reduce `@Composable` function signatures.
 
-**Key Points**:
-- ✅ One `onAction()` method instead of multiple callbacks
-- ✅ Type-safe actions with sealed interfaces
-- ✅ Actions defined in same file as State (`*Result.kt`)
-- ✅ Private implementation methods in ViewModel
-- ✅ Simpler Composable function signatures
-- ✅ Easier to test - mock single `onAction()` method
-
-**When to Use Action Interfaces (Important!)**:
-- ✅ Use for screens with **3+ different actions** passed through Composables
-- ✅ Use when actions need to be passed down multiple layers
-- ❌ **Don't use** for simple 1-2 action cases (call ViewModel methods directly)
-- ❌ **Don't use** for methods called directly where ViewModel is obtained (e.g., `disposeOneTimeEvents()`)
-- ❌ **Don't use** for simple dialog ViewModels not passed down
-
-**Examples**:
-- ✅ `NoteViewModel.onAction(NoteAction.Save)` - Complex screen with 4+ actions
-- ❌ `SignInViewModel.signIn()` - Simple screen, call directly
-- ❌ `noteViewModel.disposeOneTimeEvents()` - Called in same LaunchedEffect
-
-**Rule of Thumb**: The goal is to write **less code**, not more. Only use Actions where they genuinely simplify Composable signatures.
+**Refer to [docs/ARCHITECTURE.md](ARCHITECTURE.md#presentation-layer) for the full pattern definition, code examples, and guidelines on when to use it.**
 
 ## Debugging Strategies
 

docs/README.md

@@ -54,96 +54,8 @@ Each module has its own detailed README.md:
 - **AI Agent Tasks** → [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md)
 - **Manual Build & Install** → [MANUAL_BUILD_INSTALL.md](MANUAL_BUILD_INSTALL.md)
 - **Version Management & CI/CD** → [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md)
+- **Web Development** → [WEB_DEVELOPMENT_WORKFLOW.md](WEB_DEVELOPMENT_WORKFLOW.md)
 - **Platform-Specific** → Module READMEs in `app/` directories
 - **Data & Persistence** → Module READMEs in `core/data/` directories
 
-## Key Concepts
-
-### Project Structure
-```
-NoteDelight/
-├── core/               # Core business logic and presentation
-│   ├── domain/         # Pure business logic (no dependencies)
-│   ├── presentation/   # ViewModels, state management
-│   ├── data/           # Database implementations
-│   └── test/           # Shared test utilities
-├── ui/                 # User interface
-│   ├── shared/         # 100% shared Compose UI
-│   ├── test/           # Multiplatform Compose UI tests
-│   └── test-jvm/       # JVM-specific UI test utilities
-├── app/                # Platform-specific applications
-│   ├── android/        # Android app
-│   ├── desktop/        # Desktop app
-│   ├── web/            # Web app (Wasm)
-│   ├── ios-kit/        # iOS framework
-│   └── iosApp/         # iOS app (Swift)
-├── build-logic/        # Gradle convention plugins
-├── thirdparty/         # Vendored dependencies
-└── docs/               # This documentation
-```
-
-### Technology Stack
-
-**Languages:**
-- Kotlin (multiplatform shared code)
-- Swift (iOS app shell)
-
-**UI:**
-- Compose Multiplatform (100% shared UI)
-
-**Database:**
-- SQLDelight (default, multiplatform)
-- Room (alternative, experimental KMP)
-- SQLCipher (encryption for Android/iOS/Desktop JVM)
-
-**Architecture:**
-- Clean Architecture
-- MVVM pattern
-- Unidirectional data flow
-
-**DI:**
-- Koin (multiplatform dependency injection)
-
-**Testing:**
-- Kotlin Test (multiplatform)
-- JUnit (Android)
-- Mockito (mocking)
-- Compose Test (UI)
-- Kaspresso-inspired pattern (UI tests)
-
-## Build Commands
-
-```bash
-./gradlew build                    # Build everything
-./gradlew test                     # Run tests
-./gradlew :app:android:installDebug # Android app
-./gradlew :app:desktop:run         # Desktop app
-./gradlew :app:web:wasmJsBrowserDevelopmentRun --continuous  # Web app
-```
-
-## Platform Support
-
-| Platform | Status | Encryption | UI | Testing | Adaptive |
-|----------|--------|------------|----|---------|----------|
-| Android  | ✅ Production | ✅ SQLCipher | ✅ Compose | ✅ Full | ✅ |
-| iOS      | ✅ Production | ✅ SQLCipher | ✅ Compose | ⚠️ Manual | ✅ |
-| Desktop  | ✅ Production | ✅ SQLCipher | ✅ Compose | ✅ Full | ✅ |
-| Web      | ⚠️ Experimental | ❌ Browser limitation | ✅ Compose | ⚠️ Limited | ✅ |
-
-## Contributing
-
-- **General guidelines** → [CONTRIBUTING.md](../CONTRIBUTING.md)
-- **Module-specific** → Check module READMEs
-- **Testing** → [TESTING_GUIDE.md](TESTING_GUIDE.md)
-
-## Diagrams
-
-Visual documentation:
-- [Architecture Diagram](diagrams/architecture.png) - System architecture overview
-- [CI/CD Diagram](diagrams/ci_cd.png) - Continuous integration/deployment workflows
-
-## Additional Resources
-
-- [Main README](../README.md) - Project overview
-- [GitHub Repository](https://github.com/softartdev/NoteDelight)