claude.md

#ai #claude

Claude generated this for me. I've made numerous edits over time, but you can get started by having claude create its own claude.md file. Remember though, the longer this gets the less context your agent has to work.

Project Overview

Reko Day - Two-sided marketplace connecting local food producers with buyers at recurring pickup events ("Rekos").

Monorepo structure:

iOS/ - Native iOS app (Swift/SwiftUI)
firebase/functions/ - Backend (Node.js cloud functions)
firebase/web/ - Marketing site (Jekyll)

Documentation

Task	Read First
Features, priorities, known issues	ROADMAP.md
Architecture decisions (ADRs)	DECISIONS.md
iOS patterns & architecture	ARCHITECTURE-IOS.md
Firebase & data models	ARCHITECTURE-FIREBASE.md

Commands

# iOS tests
cd iOS && ./run-tests.sh              # All tests
./run-tests.sh -t TestClassName       # Single class (TDD)
./run-tests.sh -f                     # Full output (debug)

# Firebase tests
cd firebase/functions && npm test     # Unit tests
npm run stryker                       # Mutation tests

Workflow

Address user as "Ryan"
Alert when attention needed: say -v Karen "message"
TDD: Tests must pass before and after changes
Ask clarifying questions before starting work
Update relevant docs (ROADMAP.md, ARCHITECTURE-*.md) when architecture changes

Agent Instructions

Before work begins, ask if there are additional instructions or instruction files
Break work into small pieces, work incrementally
Keep an eye out for workflow, code, and business improvements
Use ./run-tests.sh for iOS, npm test for Firebase

Domain Model

I removed this because it isn't going to matter. You can have claude do this for you and create a domain model here or in other files.

Rules Files (Auto-Applied)

Path-specific rules in .claude/rules/ apply automatically:

ios-swift.md - Swift/SwiftUI standards, MVVM, ViewModels
ios-testing.md - Swift Testing framework, TDD, fakes over mocks
firebase-functions.md - Firebase functions, testing workflow

These contain detailed coding standards - no need to duplicate here.