Meshtastic-Android/conductor/archive/deep_dive_docs_20260316/spec.md

Specification: Deep Dive & Validation of Project Docs & Plans

Overview

This track involves a comprehensive review and deep dive into the project's documentation (/docs, GEMINI.md, etc.) and plans. The goal is to verify the documented state against the actual Kotlin Multiplatform (KMP) codebase and validate it against modern 2026 KMP and Android best practices. The outcome will be updated documentation reflecting the current state and flagged/planned changes for areas not following best practices.

Functional Requirements

• Codebase Verification: Analyze all major areas including Core Logic (core:*), UI & Features (Compose Multiplatform), Dependencies (Gradle version catalogs), and Platform-specific implementations (Android, Desktop).
• Best Practice Validation: Evaluate the codebase against modern standards, specifically focusing on Architecture (MVI/Shared ViewModels), Navigation (Navigation 3), Dependency Injection (Koin Annotations K2), and Testing patterns.
• Documentation Update: Modify existing documentation and plans to accurately reflect the current state of the codebase and dependencies.
• Refactoring Proposals: Identify and flag code or architectural decisions that deviate from best practices, outlining necessary refactoring steps in the project's plans.

Acceptance Criteria

• All documentation in /docs and root-level guides accurately reflect the current codebase.
• A comprehensive audit of major dependencies has been performed and validated against 2026 KMP standards.
• Discrepancies between the codebase and best practices are clearly flagged and actionable tasks are added to the project plans.
• The plan.md reflects the updated status and any new tasks generated from the audit.

Out of Scope

• Direct refactoring or modification of the actual Kotlin/Android codebase during this specific track (this track focuses on documentation, planning, and flagging).