# {{PROJECT_NAME}} - React Native

> Generated: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## What (Stack & Structure)

**Stack**: React Native {{REACT_NATIVE_VERSION}}, Expo {{EXPO_SDK_VERSION}}, TypeScript

### Project Structure
```
src/
├── app/              # Expo Router (file-based routing)
├── components/       # Reusable components
├── features/         # Feature modules (domain-driven)
├── hooks/            # Custom hooks
├── services/         # API, Storage
├── stores/           # Zustand stores
├── types/            # TypeScript types
└── theme/            # Colors, spacing
```

## Why (Purpose & Organization)

### Architecture: Feature-First + Clean Layers
- **Presentation**: app/, components/
- **Application**: hooks/, stores/
- **Domain**: types/, utils/
- **Data**: services/

See `rules/02-architecture.md` for complete patterns.

### State Management Decision Tree
```
Server data?  -> React Query
Global state? -> Zustand
Persistence?  -> MMKV
URL state?    -> Expo Router params
Local state?  -> useState
```

### Critical Rules
| Rule | Reason |
|------|--------|
| TypeScript strict | Type safety |
| 60 FPS target | Smooth UX |
| SecureStore for tokens | Security |
| 80%+ coverage | Quality assurance |

## How (Commands & Workflows)

### Development Commands
```bash
npx expo start        # Start dev server
npx expo start --ios  # Run iOS
npx expo start --android  # Run Android
npm test              # Run tests
npm run lint          # ESLint check
npm run type-check    # TypeScript check
```

### Build Commands
```bash
eas build --profile development --platform all
eas build --profile production --platform all
eas submit --platform ios
```

### Quality Pipeline
```bash
npm run lint && npm run type-check && npm test
```

### Development Workflow
1. **Analyze** - Read code, understand feature (`rules/01-workflow-analysis.md`)
2. **TDD** - Write test -> Implement -> Refactor
3. **Quality** - Run full quality check
4. **Commit** - Conventional Commits format

## References

| Topic | Rule File |
|-------|-----------|
| Analysis | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| TypeScript | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| State | `rules/13-state-management.md` |
| Navigation | `rules/14-navigation.md` |
| Testing | `rules/07-testing.md` |
| Performance | `rules/12-performance.md` |
| Security | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Project Specifics

{{PROJECT_DESCRIPTION}}

<!-- Add project-specific configuration below -->

<!-- PROJECT-SPECIFIC-END -->
