Battle-for-Tismo/DESIGN.md

Design docs — index

Standalone briefs for the open work, each written so a new session can pick up one area without re-reading the codebase. They duplicate the common project context on purpose.

Doc	Area
INTELLIGENCE.md	Intelligence tab, spy unit, sabotage, city/comms spying, counter-intelligence, spy satellites, the uranium-enrichment warning.
STACKS.md	Splitting unit stacks ergonomically; stacks pathfinding as one body with allied/at-war territory walkable.
AIR_MOVEMENT.md	Airplanes moving in straight lines instead of along hex tiles.
ECONOMY_BALANCE.md	Making luxury and high-tech world prices settle instead of plateauing.
POLITICS_PERFORMANCE.md	Speeding up the hourly politics/migration tick with version-keyed memoisation.
TRAINING_UI.md	Showing what a unit being trained is gathering when the player clicks it.
ICONS.md	Replacing the placeholder "dummy icon" SVGs with real art.
SIMPLIFICATIONS.md	The [~] roadmap items: deliberate simplifications worth revisiting.

ROADMAP.md remains the authoritative task list; these docs add the why and the design space around the open items.

Done but not yet ticked in ROADMAP.md (as of writing): the ranged-attack button for a stack (roadmap §5) and the resource-cost line in the budget table (roadmap §7) are implemented in the working tree.