Cline rules

1---
2paths:
3  - "src/**/*.py"
4  - "tests/**/*.py"
5  - "scripts/**/*.py"
6  - "pyproject.toml"
7  - "uv.lock"
8---
9 
10# Python Rules (uv / ruff / mypy / pytest)
11 
12## Environment
13- Use `uv` for running tools (avoid ad-hoc `pip` commands).
14- Prefer `uv run ...` so checks execute in the right venv and dependency set.
15 
16## Architecture Guardrails
17- Keep `src/domain` free of I/O, filesystem access, and infrastructure imports.
18- Put orchestration/side-effects in `src/application` or `src/infrastructure`.
19 
20## Validation Gates
21- Lint: `uv run ruff check .`
22- Types: `uv run mypy src --ignore-missing-imports`
23- Tests: `uv run pytest`
24 
25## Messy Document Inputs (DOCX/DFM)
26- Assume hostile/converted inputs: mixed encodings, broken numbering, odd whitespace, nested lists/tables.
27- Favor tolerant parsing with explicit fallbacks over strict assumptions.
28- Add a regression test when touching DOCX parsing/rendering logic (start with `tests/test_dfm.py` and `tests/integration/test_docx_save_flow.py`).
29