learning_ai_clock/CLAUDE.md
2026-03-21 09:12:18 -07:00

1.2 KiB

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

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

Cross-Repo Automation

See ../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md for periodic maintenance tasks: test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps.