chore(docs): regenerate AI agent config files

This commit is contained in:
saravanakumardb1 2026-03-05 14:37:31 -08:00
parent 909daf8853
commit f9439f4519
6 changed files with 127 additions and 34 deletions

14
.aider.conf.yml Normal file
View File

@ -0,0 +1,14 @@
# .aider.conf.yml — Aider Configuration for ChronoMind
# Helps Aider understand the project structure and conventions.
read:
- AGENTS.md
- docs/PRD.md
conventions: AGENTS.md
lint-cmd:
- 'cd web && npm test 2>&1 | tail -10'
- 'cd web && npm run typecheck 2>&1 | tail -10'
auto-commits: false

24
.clinerules Normal file
View File

@ -0,0 +1,24 @@
# .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`

View File

@ -3,15 +3,30 @@
Project: ChronoMind — AI-Powered Contextual Clock & Timer
Product ID: chronomind
Stack: Next.js 16 (web) + SwiftUI (iOS) + Jetpack Compose (Android) + Fastify 5 (backend)
Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend)
Rules:
- Web engine in web/src/lib/ — pure TS, no React
## Architecture
- 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)
## Rules
- Web engine logic in web/src/lib/ — pure TS, no React imports
- Components in web/src/components/ — React UI only
- iOS shared in ios/ChronoMind/Shared/
- Android engine in android/.../engine/ — pure Kotlin
- Theme: --cm-* CSS props (web), ChronoMindTheme (native)
- Commits: type(scope): description
- Build web with --webpack flag
- Never console.log, never hardcode colors/URLs
- 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: feat(scope): description / fix(scope): description
- Never delete existing comments/documentation unless asked
- Never add emojis unless asked
- Never hardcode secrets, colors, or API URLs
## Build Verification
- cd web && npm test && npm run typecheck && npm run build
## Key Documents
- AGENTS.md — Full AI agent instructions (read this first)

12
.editorconfig Normal file
View File

@ -0,0 +1,12 @@
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
[*.md]
trim_trailing_whitespace = false

40
.github/copilot-instructions.md vendored Normal file
View File

@ -0,0 +1,40 @@
# GitHub Copilot Instructions — ChronoMind
> For full agent instructions, read [`AGENTS.md`](../AGENTS.md) at the repo root.
## Project Context
**ChronoMind** — AI-Powered Contextual Clock & Timer.
Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend)
## Code Generation Rules
### Always
- 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)
- Include `productId: "chronomind"` in every Cosmos DB document
- Use `type(scope): description` commit message format
- Fix source code, not tests (unless the test itself is wrong)
### Never
- `console.log` or `print()` in production code
- Hardcoded secrets, API keys, colors, or URLs
- Delete existing comments or documentation unless explicitly asked
- Add emojis unless asked
## Key Paths
- 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)
## Build Verification
```bash
cd web && npm test && npm run typecheck && npm run build
```

View File

@ -2,36 +2,24 @@
# Read AGENTS.md for full context. These are the critical rules.
Project: ChronoMind — AI-Powered Contextual Clock & Timer
Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Platform-service (Fastify 5)
Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend)
## Architecture Rules
- 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)
## Conventions
- 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/app/.../engine/ — pure Kotlin, no Android framework deps
- Backend: platform-service in sibling repo learning_ai_common_plat (port 4003)
- Product ID: chronomind — every Cosmos document MUST include productId field
## Key Paths
- Web: web/src/ (Next.js 16, App Router)
- iOS: ios/ChronoMind/ (SwiftUI, iOS 17+)
- Watch: ios/ChronoMindWatch/ (watchOS 10+)
- Mac: ios/ChronoMindMac/ (macOS 14+)
- Widgets: ios/ChronoMindWidgets/ (WidgetKit)
- Android: android/app/src/main/java/com/chronomind/app/
- Wear OS: android/wear/
- Docs: docs/ (PRD.md, roadmap.md, INDUSTRY_RESEARCH.md)
- Backend modules: ../learning_ai_common_plat/services/platform-service/src/modules/{timers,routines,households,shared-timers}/
## Conventions
- Theme tokens: --cm-* CSS custom properties (web), ChronoMindTheme (native)
- Commits: feat(scope): description / fix(scope): description
- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps
- Web build: must use --webpack flag (Serwist incompatible with Turbopack)
- Never use console.log — use analytics.ts stub or req.log in Fastify
- Never hardcode colors — use theme tokens
- Never hardcode API URLs — use env vars
- Every Cosmos doc: productId: "chronomind"
- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native)
- Commits: feat(scope): description / fix(scope): description
## Build Verification
- Web: cd web && npm test && npm run typecheck && npm run build
- iOS: Open ChronoMind.xcodeproj, Cmd+B
- Android: cd android && ./gradlew :app:compileDebugKotlin
- cd web && npm test && npm run typecheck && npm run build