# ChronoMind — Claude Code Instructions

Read AGENTS.md for full context. Key rules:

## Quick Reference
- Product: ChronoMind (productId: "chronomind")
- Web: Next.js 16 + React 19 + TailwindCSS v4 + Zustand 5
- iOS: SwiftUI (iOS 17+), watchOS 10+, macOS 14+
- Android: Jetpack Compose + Material 3 + Room + Hilt
- Backend: platform-service (Fastify 5) in ../learning_ai_common_plat
- Tests: Vitest (web), XCTest (iOS), JUnit5 (Android)

## Build Commands
```bash
cd web && npm test && npm run typecheck && npm run build
```

## Critical Rules
- Engine logic (web/src/lib/) must be pure TS — no React imports
- iOS shared logic in ios/ChronoMind/Shared/ — shared across all Apple targets
- Android engine in engine/ package — pure Kotlin
- Every Cosmos doc needs productId: "chronomind"
- Web build requires --webpack flag (Serwist + Turbopack incompatible)
- Commits: type(scope): description