jean: Instructions file for Claude Code

AI Agents

Current Status

@CLAUDE.local.md

Overview

This repository is a template with sensible defaults for building Tauri React apps.

Core Rules

Codex App Server schema

If you need to check some codex app-server related things, use "codex app-server generate-json-schema --out ./codex-schema" to generate schema and check local dir ./codex-schema for schemas.

New Sessions

• Read @docs/tasks.md for task management
• Review docs/developer/architecture-guide.md for high-level patterns
• Check docs/developer/ for system-specific patterns (command-system.md, performance-patterns.md, etc.)
• Check git status and project structure

Development Practices

CRITICAL: Follow these strictly:

1. Read Before Editing: Always read files first to understand context
2. Follow Established Patterns: Use patterns from this file and docs/developer
3. Senior Architect Mindset: Consider performance, maintainability, testability
4. Batch Operations: Use multiple tool calls in single responses
5. Match Code Style: Follow existing formatting and patterns
6. Test Coverage: Write comprehensive tests for business logic
7. Quality Gates: Run bun run check:all after significant changes
8. Dev Server: You may start the dev server (bun run tauri dev) when needed
9. No Unsolicited Commits: Only when explicitly requested
10. Documentation: Update relevant docs/developer/ files for new patterns
11. Removing files: Always use rm -f

CRITICAL: Use Tauri v2 docs only. Always use modern Rust formatting: format!("{variable}")

Architecture Patterns (CRITICAL)

State Management Onion

useState (component) → Zustand (global UI) → TanStack Query (persistent data)

Decision: Is data needed across components? → Does it persist between sessions?

Performance Pattern (CRITICAL)

// ✅ GOOD: Use getState() to avoid render cascades
const handleAction = useCallback(() => {
  const { data, setData } = useStore.getState()
  setData(newData)
}, []) // Empty deps = stable

// ❌ BAD: Store subscriptions cause cascades
const { data, setData } = useStore()
const handleAction = useCallback(() => {
  setData(newData)
}, [data, setData]) // Re-creates constantly