# Data Directory (`data/`)

This directory contains all Pokemon game data files for Generation 1.

## Planned Structure

```
data/
├── pokemon/           # Pokemon species data
│   ├── species.json   # Base stats, types, learn sets
│   └── sprites/       # Pokemon sprite images (optional)
├── moves/             # Move definitions
│   ├── moves.json     # Move data (power, accuracy, PP, etc.)
│   └── effects.json   # Special move effects
├── types/             # Type system data
│   └── effectiveness.json  # Type matchup chart
├── items/             # Items and held items (if implemented)
│   └── items.json     # Item effects and properties
├── mechanics/         # Game mechanics data
│   ├── formulas.json  # Damage calculation formulas
│   └── constants.json # Game constants (crit ratios, etc.)
└── validation/        # Data validation schemas
    ├── pokemon.schema.json
    ├── moves.schema.json
    └── types.schema.json
```

## Data Format

All data files use JSON format for:
- **Human Readability**: Easy to edit and review
- **Validation**: JSON schema validation support
- **Tooling**: Python scripts can easily process JSON
- **Version Control**: Clear diffs for changes

## Generation 1 Scope

This directory focuses exclusively on Generation 1 data:
- 151 Pokemon species (Bulbasaur through Mew)
- Original 165 moves
- 15 types (no Dark/Steel/Fairy)
- Original battle mechanics and formulas

## Data Sources

Data should be sourced from authoritative references:
- Bulbapedia for move and Pokemon data
- Smogon for competitive mechanics
- Original game ROM analysis for accurate formulas

## Validation

Python tools in `tools/data/` will validate all data files against schemas to ensure consistency and correctness.