# .clinerules — Cline / Roo Code Rules for ChronoMind
# Read AGENTS.md for the complete onboarding guide.

## Project: ChronoMind — AI-Powered Contextual Clock & Timer
Architecture: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend)

## Mandatory Rules
- Web engine logic in web/src/lib/ — pure TS, no React imports
- Components in web/src/components/ — React UI only
- iOS shared logic in ios/ChronoMind/Shared/ — consumed by all Apple targets
- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps
- Web build: must use --webpack flag (Serwist incompatible with Turbopack)
- Every Cosmos doc: productId: "chronomind"
- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native)
- Commits: `type(scope): description`
- After changes, verify: `cd web && npm test && npm run typecheck && npm run build`

## Key File Locations
- web/src/lib/ — Pure TS engine modules (timer, cascade, urgency, nl-parser, etc.)
- web/src/components/ — React UI components
- ios/ChronoMind/Shared/ — Shared Swift code (iOS + Watch + Mac + Widgets)
- android/app/.../engine/ — Pure Kotlin engine
- backend/ — Fastify 5 + TypeScript backend (port 4011)
- Full guide: `AGENTS.md`