This file is intended to be continuously updated by future agents.
- Keep the simulator MVP-simple: only implement mechanics required for single-battle correctness (no shop/draft/round systems until trait+ability core is stable).
- Expand trait activation pipeline (
engine/traits.py) beyond initial Ace/Undead start-of-battle effects.
- Add troop combat stats in
data/troops.py(hp,dps,range,projectile_speed) for all troops with source/confidence notes. - Replace placeholder values in
data/trait_effects.pywith sourced trait numbers and timestamps. - Wire seasonal overrides: allow season JSON to patch troop pools/thresholds cleanly during sim setup.
- Expand
AbilityEnginefrom placeholder to per-troop ability handlers and cooldown rules. - Add deterministic simulation tests for projectile hit timing, movement blocking, and round timeout outcomes.
- Positioning AI module (
engine/positioning_ai.py). - Shop/draft system (
engine/shop.py,engine/draft.py). - Multi-round orchestration (
engine/match.pyorengine/rounds.py). - Data provenance framework (
official,wiki,measured,inferred) for every numeric stat. - Maintain
DECISIONS.mdwith explicit belief-vs-counterargument updates each handoff.
- Keep combat-loop modules separated; avoid hardcoding season-specific behavior in
engine/combat.pyorengine/full_simulation.py. - Update this file on every meaningful handoff.
- If a task cannot be validated by an executable test, do not add abstraction for it yet.