Zingers: documentation
Start here if you're new: vocabulary.md (naming) → design-vision.md (Flight-First north star) → game-spec.md (loop & venues) → bible/ (lore). Active build plan: flight-first-plan.md.
Public site: zingers.org (registry: lib/org/registry.ts).
Product pitches (zingers.org)
| Doc | Purpose |
|---|---|
| ONEPAGER.md | Elevator pitch |
| TWOPAGER.md | Extended pitch |
| STORY.md | World, Forces, Flight, raise-and-know spine |
| TECHNICAL.md | Stack, architecture, agent defaults, cost rails |
| AI-CRYPTO.md | Agent layer + Crowns / $ZING positioning |
Design & systems
| Doc | Purpose |
|---|---|
| vocabulary.md | Naming policy: Trainer, Strategy, Clan, fight, Flight, standings |
| design-vision.md | Product north star (Flight-First v3.1) |
| game-spec.md | Loop, venues, participation model |
| combat-design.md | Damage formula, roster stats, movesets, judge rules |
| flight-first-plan.md | Roadmap: phases, wallet identity, gates, freeze list |
| long-game.md | Shipped retention: Director, unlocks, wings, Conditions, expeditions, dex |
| essence.md | One soul, native bodies (phone vs desktop) |
| two-doors.md | Flight-first mobile face; desktop full world; measurement |
| climb.md | Flight systems (100 sectors, Reaches; code may say Climb/Circuit) |
| climb-feel.md | Feel pass (corridor grammar, runner heartbeat) |
| flyover.md | How the first flight teaches the whole game |
| mobile.md | Mobile shell spec (door superseded by two-doors) |
| agent-protocol.md | Bring-your-own-agent interface (act(view) → decision) |
| zing-model.md | $ZING positioning (deferred; fuel, not the product) |
| horizon.md | Internal: post-launch continuing roadmap (token → seasons → optional Game Two) |
Lore bible
| Doc | Purpose |
|---|---|
| bible/README.md | Index + canon discipline |
| bible/10-ascent.md | Flight / Reaches / challenges canon |
| bible/09-glossary.md | Plain definitions (mirrors lib/lore/glossary.ts) |
Historical / planning (read status banners)
| Doc | Notes |
|---|---|
| first-journey-roadmap.md | Fight-led Act 1 (prior pass); live door = Flight-First |
| launch-week.md | P4 Flight-First recut plan. Much of it shipped; check phase status |
| climb-p2.md | Deferred Circuit depth brainstorm |
| region-variety.md | Brainstorm; partially superseded |
| circuit-board.md / circuit-world.md | Circuit systems detail |
| growth-strategy.md | Growth bets: Flight + Trainer↔champion bond as the share spine (battles demoted) |