# {{PROJECT_NAME}} - Laravel

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

## What (Stack & Structure)

**Stack**: Laravel {{LARAVEL_VERSION}}, PHP {{PHP_VERSION}}, {{DATABASE_TYPE}}

### Project Structure
```
app/
├── Domain/           # Core business logic
│   ├── Models/       # Eloquent models
│   └── Services/     # Domain services
├── Application/      # Use cases, Actions, DTOs
├── Infrastructure/   # External services, Repositories
└── Http/             # Controllers, Requests, Resources
```

## Why (Purpose & Organization)

### Architecture: {{ARCHITECTURE_PATTERN}}
- **Controllers**: Thin, delegate to Actions
- **Validation**: Always via Form Requests
- **Responses**: Always via API Resources
- **Business Logic**: In Domain layer or Actions

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

### Critical Rules
| Rule | Reason |
|------|--------|
| PHP 8.3+ strict types | Type safety |
| Laravel Pint (PSR-12) | Code consistency |
| PHPStan level 8 | Static analysis |
| 80%+ coverage | Quality assurance |

## How (Commands & Workflows)

### Development Commands
```bash
php artisan serve     # Start server
php artisan test      # Run tests
./vendor/bin/pint     # Format code
./vendor/bin/phpstan analyse  # Static analysis
```

### Database Commands
```bash
php artisan migrate              # Run migrations
php artisan migrate:fresh --seed # Fresh with seeds
php artisan make:migration       # Create migration
```

### Quality Pipeline
```bash
./vendor/bin/pint && ./vendor/bin/phpstan analyse && php artisan test
```

### Development Workflow
1. **Analyze** - Read code, understand domain (`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` |
| PHP Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testing | `rules/07-testing.md` |
| Security | `rules/11-security.md` |

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

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

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