# {{PROJECT_NAME}} - Flutter

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

## What (Stack & Structure)

**Stack**: Flutter 3.x, Dart 3.x, {{STATE_MANAGEMENT_PATTERN}}

### Project Structure
```
lib/
├── core/              # Shared utilities
│   ├── error/         # Failures, exceptions
│   ├── network/       # API client, interceptors
│   └── utils/         # Extensions, helpers
├── features/          # Feature modules
│   └── {feature}/
│       ├── data/      # Repositories impl, models, datasources
│       ├── domain/    # Entities, usecases, repository interfaces
│       └── presentation/  # Widgets, BLoC/providers, pages
└── injection.dart     # Dependency injection
```

## Why (Purpose & Organization)

### Architecture: Clean Architecture + Feature-First
- **Domain** layer: Pure Dart, no Flutter dependencies
- **Data** layer: API calls, local storage, DTOs
- **Presentation** layer: Widgets, state management

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

### Critical Rules
| Rule | Reason |
|------|--------|
| Feature isolation | Independent, testable modules |
| {{STATE_MANAGEMENT_PATTERN}} | Predictable state management |
| Repository pattern | Data source abstraction |
| 80%+ coverage | Quality assurance |

## How (Commands & Workflows)

### Flutter Commands
```bash
flutter pub get           # Install dependencies
flutter run               # Run app
flutter test              # Run tests
flutter analyze           # Static analysis
flutter build apk/ios     # Build release
```

### Quality Pipeline
```bash
flutter analyze           # Dart analysis
flutter test --coverage   # Tests + coverage
dart format .             # Code formatting
```

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

## References

| Topic | Rule File |
|-------|-----------|
| Analysis | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| Dart Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| State Management | `rules/06-state-management.md` |
| Testing | `rules/07-testing.md` |
| Performance | `rules/08-performance.md` |

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

{{TECH_STACK}}

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

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