otto/AGENTS.md

Otto — Project Rules

Follow karpathy.md (in this directory) for all behavioral coding guidelines.

In addition:

• All user-facing text, labels, errors, README, comments and LLM prompts must be English only.
• Experience Modes are a first-class concept: Balanced, Cultural Explorer, Foodie, Adventurous, Relaxed, Nightlife & Vibes. The chosen mode must visibly drive candidate selection and LLM prompt weighting.
• Explicit num_days from the user is authoritative (use dates mainly for event filtering).
• Prefer minimal code. No premature abstractions.
• API keys stay server-side only. Never leak to client.
• Every generation must respect budget and selected days.
• When editing, trace every line directly to the plan or user request (surgical).

See the approved plan.md in the session for detailed implementation phases, verification steps, and architecture.

Quick Commands

• docker compose -f docker-compose.dev.yml up --build
• npm run dev
• npm run db:migrate