Add master build prompt for next-generation football simulation

[wjrm500]

Summary

Adds REBUILD_PROMPT.md — an exhaustive, self-contained specification for rebuilding SoccerSimulation from scratch with far greater ambition, distilled from a deep analysis of the existing codebase's domain model, calibrated mathematics, and emergent-design philosophy.

This is a single documentation artifact; no application code is changed.

What it captures from the existing app

• The soul: realism is generated, never scripted. Latent potential that resolves with age (peakRating ← N(peakRating, 50/age²)), skills-as-a-shape matched to position archetypes by cosine similarity, the hand-calibrated goal-probability table, and the fatigue→form→injury→selection feedback loop.
• Every proven formula and constant is preserved as the v1 calibration anchor (Appendix A), behind named, tunable config.
• The seams where the original was clearly heading next: the tournament→league rename, the unused free_agent_players list, the universe-global player pool, and the multi-system model the UI only ever used one slice of.

What it adds (the ambition)

• Chronology — multi-season, youth intake, regeneration, retirement, records, dynasties, eras.
• Geography — multiple nations, confederations, real cities, reputation gradients, footballing cultures.
• Competition framework — pyramids with promotion/relegation, domestic cups, continental & international tournaments, all via one general abstraction.
• Economy — valuations, wages, contracts, budgets, a negotiation state machine, loans, scouting.
• Agency — managers with tactics/abilities, AI policies, board hire/fire, and an interactive "simulation train" with decisions as first-class engine inputs.
• Identity — avatars, traits, personality, and queryable career histories.

Engineering discipline baked in

• Pure deterministic engine core inside an impure shell; seeded/splittable RNG; no global singletons or pickled object graphs (a key fix over the original save model).
• A 10-level test strategy (unit, property, golden, statistical/calibration, a determinism gate, invariants, long-run soak, integration/e2e, performance, fuzz).
• An 11-milestone execution order (M0–M10), each a fully-working, green, deterministic slice; M2 is explicit parity with the original, done right.

https://claude.ai/code/session_01C4QURAyg7gH9FK32tmp6P1

---

Generated by Claude Code