Cline rules

1# Project Structure
2 
3**CRITICAL:** Verify file tree structure matches the standard layout before starting any work.
4 
5## Standard Directory Layout
6 
7Replace `{package_name}` with the actual package name.
8 
9```
10project_root/
11│
12├── .github/
13│   └── workflows/
14│       └── ci.yml
15│
16├── src/
17│   └── {package_name}/
18│       ├── __init__.py
19│       ├── main.py
20│       ├── utils/
21│       └── logger/
22│           └── logger.py
23│
24├── data/
25├── tests/
26│   ├── conftest.py
27│   ├── unit/
28│   └── integration/
29│
30├── docs/
31├── logs/
32├── scripts/
33├── requirements.txt
34├── Makefile
35├── README.md
36├── LICENSE
37├── .gitignore
38├── CONTRIBUTING.md
39├── SECURITY.md
40├── uv.lock
41├── .env
42└── pyproject.toml
43```
44 
45## Directory Roles
46 
47| Path | Purpose |
48|------|---------|
49| `.github/workflows/` | CI/CD pipeline definitions |
50| `src/{package_name}/` | Application source code |
51| `src/{package_name}/main.py` | Entry point |
52| `src/{package_name}/utils/` | Helper functions |
53| `src/{package_name}/logger/` | Logging setup |
54| `data/` | Raw data files |
55| `tests/unit/` | Unit tests |
56| `tests/integration/` | Integration tests |
57| `tests/conftest.py` | Test fixtures |
58| `docs/` | Documentation |
59| `logs/` | Runtime logs |
60| `scripts/` | Automation scripts |
61| `requirements.txt` | Dependencies |
62| `uv.lock` | UV lock file |
63| `.env` | Environment variables |
64| `Makefile` | Build commands |
65 
66## Required Files
67 
68- `__init__.py` in all package directories
69- `conftest.py` for pytest fixtures
70- `README.md`, `LICENSE`, `CONTRIBUTING.md`, `SECURITY.md`
71- `.gitignore`, `.env`
72- `Makefile` with UV commands
73- `pyproject.toml`
74 
75## Verification
76 
77Before creating new features or refactoring:
781. Run `tree` command in project root
792. Compare against standard layout
803. Clean up old files/directories no longer needed
814. Check for duplicate files before creating new ones
82