Internal documentation for engineers and agents working in the Compass repo.

Start with AGENTS.md for repo rules, commands, and conventions. Use the docs below for codebase shape and subsystem behavior.

• Agent Onboarding
• Repo Architecture
• Feature File Map
• Common Change Recipes

• Auth or session behavior: Frontend Runtime Flow, Password Auth Flow, Google Sync And SSE Flow
• Event shape or recurrence behavior: Event And Task Domain Model, Recurrence Handling
• Local-first or storage behavior: Offline Storage And Migrations
• Backend routes and API behavior: Backend Request Flow, API Documentation, Backend Error Handling

• Frontend Runtime Flow
• Google Sync And SSE Flow
• Password Auth Flow

• Repo Architecture
• Event And Task Domain Model
• Glossary
• Engineering Principles

• Env And Dev Modes
• Testing Playbook
• Web State Guide
• Types And Validation
• CLI And Maintenance Commands
• Deploy
• Coding Conventions

• Password Auth Flow
• Google Sync And SSE Flow
• Recurrence Handling
• Offline Storage And Migrations

Product requirements and specifications for each feature area:

• Auth
• Events
• Google Sync
• Recurring Events
• Shortcuts
• Tasks