# {{PROJECT_NAME}} - Python

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

## Was (Stack & Struktur)

**Stack**: {{TECH_STACK}}
**Framework**: {{WEB_FRAMEWORK}}
**Python**: {{PYTHON_VERSION}}

### Projektstruktur
```
{{PROJECT_NAME}}/
├── domain/         # Geschaeftslogik (KEINE Abhaengigkeiten)
│   ├── entities/   # Business Entities
│   ├── value_objects/
│   └── repositories/  # Interfaces (Protocols)
├── application/    # Use Cases
│   ├── commands/
│   ├── queries/
│   └── services/
└── infrastructure/ # Technische Implementierungen
    ├── persistence/
    ├── api/
    └── services/
```

## Warum (Zweck & Organisation)

### Architektur: Clean/Hexagonal Architecture
- **Domain**: Reine Geschaeftslogik ohne externe Abhaengigkeiten
- **Application**: Use Cases koordinieren Domain-Logik
- **Infrastructure**: Adapter fuer externe Systeme

Siehe `rules/02-architecture.md` fuer Muster.

### Kritische Regeln
| Regel | Beschreibung |
|-------|--------------|
| Style | PEP 8 |
| Type Hints | Pflicht fuer alle oeffentlichen Funktionen |
| Docstrings | Google Style |
| Tests | 80% Coverage (Domain: 95%) |

## Wie (Befehle & Workflows)

### Entwicklungsbefehle
```bash
make setup    # Projekt einrichten
make install  # Abhaengigkeiten installieren
make dev      # Entwicklungsumgebung starten
make shell    # Container Shell
```

### Qualitaets-Pipeline
```bash
make lint           # ruff
make format         # black + isort
make type-check     # mypy
make security-check # bandit
make quality        # Alle Pruefungen
make test-cov       # Tests mit Coverage
```

### Entwicklungs-Workflow
1. **Analysieren** - `rules/01-workflow-analysis.md` lesen
2. **TDD** - Test schreiben, implementieren, refaktorisieren
3. **Qualitaet** - `make quality` ausfuehren
4. **Commit** - Conventional Commits Format

## Referenzen
| Kontext | Datei |
|---------|-------|
| Vor Aenderungen | `rules/01-workflow-analysis.md` |
| Architektur | `rules/02-architecture.md` |
| Code Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testing | `rules/07-testing.md` |
| Sicherheit | `rules/11-security.md` |
| Async | `rules/12-async.md` |

<!-- PROJECT-SPECIFIC-START -->
## Projektspezifika
<!-- Projektspezifische Konfiguration hier hinzufuegen -->
<!-- PROJECT-SPECIFIC-END -->
