# {{PROJECT_NAME}} - Python

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

## O Que (Stack & Estrutura)

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

### Estrutura do projeto
```
{{PROJECT_NAME}}/
├── domain/           # Logica de negocio pura (sem dependencias)
│   ├── entities/     # Entidades com identidade
│   ├── value_objects/# Objetos imutaveis
│   └── repositories/ # Interfaces (Protocols)
├── application/      # Use cases
│   ├── commands/     # Operacoes de escrita
│   └── queries/      # Operacoes de leitura
└── infrastructure/   # Adaptadores
    ├── persistence/  # Repositorios
    └── api/          # Controllers
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Clean/Hexagonal
- **Domain**: Logica de negocio, sem dependencias externas
- **Application**: Use cases, orquestracao
- **Infrastructure**: Adaptadores (DB, API, etc.)
- Dependencias: Infrastructure -> Application -> Domain

Ver `rules/02-architecture.md` para padroes.

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| Docker | TODAS as comandos via Makefile |
| Type Hints | Obrigatorios em funcoes publicas |
| Docstrings | Google style obrigatorio |
| Analise | OBRIGATORIA antes de qualquer codigo |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
make dev              # Inicia ambiente de desenvolvimento
make shell            # Shell no container
make install          # Instalar dependencias
```

### Pipeline de qualidade
```bash
make lint             # Ruff
make format           # Black + isort
make type-check       # Mypy
make security-check   # Bandit
make quality          # Todos os checks
make test-cov         # Testes com cobertura (80% minimo)
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Teste -> Implementacao -> Refatoracao
3. **Qualidade** - `make quality`
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Arquivo |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Arquitetura | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testes | `rules/07-testing.md` |
| Seguranca | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades do projeto

<!-- Adicionar configuracao especifica do projeto aqui -->

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