3a8b2efd-8df2-4277-9336-5d97408d6574

data/README.md

@@ -0,0 +1,53 @@
+# 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.