# Pokémon FireRed: Kanto Story Edition

Agent-executable **Product Buildprint** for a browser-based Pokémon FireRed recreation using PokeAPI v2 data and Phaser 3.

## What this is

- A phased engineering packet for coding agents — **not** a playable game by itself
- Greenfield product route (classifier result: whole game, not capability graft)
- Target: story-complete Kanto + Sevii post-game with Gen III battle mechanics

## What this is not

- Not a Capability Buildprint for grafting into an existing host app
- Not affiliated with Nintendo, Game Freak, or The Pokémon Company
- Not using ripped GBA ROM assets

## Quick start for applying agent

```bash
# 1. Read BUILDPRINT.md and follow read order
# 2. Copy decisions template
mkdir -p .buildprint
# 3. Scaffold from 01-project-setup.md
npm create vite@latest pokemon-fire-red-game -- --template vanilla-ts
# ... follow setup for Phaser 3 integration

# Data pipeline
npm run data:fetch
npm run data:validate

# Dev
npm run dev
```

## Read order

1. `BUILDPRINT.md`
2. `references/asset-policy.md`
3. `references/world-art-sources.md`
4. `alignment-slice/ALIGNMENT.md`
5. `references/battle-verification.md`
6. `references/starter-town-verification.md`
7. `references/world-verification.md`
8. `references/data-sources-and-techniques-basis.md`
9. `00-questions.md`
10. `01-project-setup.md`
11. `02-ui-identity.md`
12. `blueprint.yaml`
13. `03-phases/phase-index.yaml` → active phase

## Story contract (mandatory)

Before phase 06, read and implement against:

- `data/story/story-graph.yaml` — 25+ main story quests with flags, items, trainers
- `data/story/map-manifest.yaml` — 88 Kanto + 18 Sevii maps (100% required)
- `data/story/rival-progression.yaml` — 8 rival battles
- `data/story/sevii-quest-chain.yaml` — full postgame arc

**No 50% map shortcut.** Claims require `npm run maps:validate` and `npm run story:validate`.

## Phase summary

| Phase | Focus |
|---|---|
| 01 | PokeAPI cache + manual data |
| 02 | Phaser scenes + game state |
| 03 | **Battle core implementation + deterministic functional/visual certification** |
| 04 | **Pallet Town semantic map + critical visual certification** |
| 05 | Pallet → Route 1 → Viridian encounter integration; blocks phase 06+ |
| 06 | Script VM + Oak/starter story |
| 07 | Party, PC, evolution |
| 08 | Items, bag, shops, HMs |
| 09 | Trainers + rival AI |
| 10 | Kanto maps + 8 gyms |
| 11 | Elite Four + Champion |
| 12 | Sevii Islands post-game |
| 13 | Menus, save, audio, polish |
| 14 | Claim verification |
| 99 | Critical review |

## Data sources

- [PokeAPI v2](https://pokeapi.co/docs/v2) — species, moves, types, sprites (cached at build time)
- Manual JSON/YAML — encounters, trainers, items, and story scripts; maps are semantic YAML compiled deterministically to generated TMX for Tiled preview and runtime
- Local world bundle — `assets/world/` contains the confirmed CC0 player/NPC and landscape/world sheets plus originals, licenses, and a machine-readable manifest

## World Art Bundle

The source choice is already confirmed. Before overworld/map implementation, the applying agent copies `assets/world/runtime/` into `public/assets/` and records:

- selected source strategy: `safe_cc0_default` + `external_sprite_sheets`
- selected source URLs and licenses in `docs/assets-provenance.md`
- local original paths under `third_party_assets/world/`
- normalized runtime files under `public/assets/ow/` and `public/assets/tilesets/`
- `public/assets/world-source-manifest.json`

Confirmed bundle: `safe_cc0_default` + `external_sprite_sheets` using the committed Kenney RPG Urban Pack and OpenGameArt player/NPC sheet. Pokémon remain PokeAPI-only.

Playable alignment reference: `alignment-slice/` demonstrates keyboard/touch walking, camera behavior, named player frame extraction, and coherent tile usage. See `alignment-slice/ALIGNMENT.md` and `references/starter-town-verification.md` before implementing phase 04.

## Claim ladder

`data_pipeline` → `battle_core` → `starter_town_core` → `overworld_core` → `progression_core` → `kanto_complete` → `postgame_sevii` → `release_polish`

## Legal

Fan/educational use. Include disclaimer in game title screen and README. Cache PokeAPI data locally per their fair use policy.

**Asset rules:**

- **Pokémon:** always PokeAPI (mandatory)
- **Trainers / NPCs / tiles:** confirmed committed `safe_cc0_default` bundle. Changing it requires a new explicit decision.

## Authoring metadata

- Created by: Buildprint Creator workflow (capability-buildprint-author classifier → Product route)
- Classifier: **Route B — Greenfield Product**
- Evidence basis: PokeAPI docs, Phaser docs, reference repos (see `references/`)
- Benchmark: No benchmark evidence found