# Project Cleanup Plan

## Proposed Final Structure

```
gs_modflow/
├── README.md                    # Main documentation
├── requirements.txt             # Python dependencies
├── goldsim_interface.py         # Main GoldSim entry point
├── responsive_interface.py      # Core MODFLOW interface
├── gspy_modflow.json           # GSPy configuration
├── mf2005.exe                  # MODFLOW executable
├── examples/                   # Example scripts
│   ├── simple_demo.py          # Basic demonstration
│   └── tutorial_setup.py       # Tutorial 2 style setup
├── development/                # Development files (optional)
│   ├── monthly_prototype.py
│   ├── demo_monthly_coupling.py
│   └── monthly_visualizer.py
└── docs/                       # Additional documentation
    ├── blog_post.html
    └── setup_guide.md
```

## Cleanup Steps

### Step 1: Create Clean Core
1. Keep only essential working files
2. Move examples to examples/ folder
3. Move development files to development/ folder
4. Move documentation to docs/ folder

### Step 2: Clean Temporary Files
1. Delete all MODFLOW output files (*.hds, *.list, etc.)
2. Delete state files (*.pkl)
3. Delete log files
4. Delete __pycache__

### Step 3: Test Functionality
1. Test goldsim_interface.py still works
2. Test responsive_interface.py still works
3. Verify examples run correctly

### Step 4: Update Documentation
1. Update README.md with new structure
2. Add setup instructions
3. Document example usage

## Files to Keep (Core)
- goldsim_interface.py
- responsive_interface.py  
- README.md
- requirements.txt
- gspy_modflow.json
- mf2005.exe

## Files to Archive (Development)
- monthly_prototype.py
- demo_monthly_coupling.py
- monthly_visualizer.py
- tutorial_setup.py
- simple_demo.py
- All *.md files except README

## Files to Delete (Temporary)
- All MODFLOW output files
- All *.pkl files
- gspy_modflow_log.txt
- __pycache__/
- .venv/ (if not needed)