feat: Add initial game content including missions, narrative sequences, and NPC personality specifications.

README.md

@@ -43,18 +43,24 @@ A tactical turn-based roguelike strategy game built with Three.js, featuring pro
 ## Project Structure
 
 ```
+specs/                     # Detailed feature specifications and design docs
 src/
 ├── assets/
 │   ├── data/
 │   │   ├── classes/          # Character class definitions (JSON)
+│   │   ├── effects/          # Status effects and abilities
 │   │   ├── missions/         # Mission configurations
-│   │   └── narrative/         # Dialogue sequences
+│   │   ├── narrative/        # Dialogue sequences
+│   │   ├── skill_trees/      # Class skill tree templates
+│   │   └── skills/           # Individual skill definitions
 │   └── images/               # Character portraits and assets
 ├── core/
 │   ├── GameLoop.js           # Main game loop and Three.js setup
 │   ├── GameStateManager.js   # Application state management
 │   ├── InputManager.js       # Input handling (keyboard/gamepad)
 │   └── Persistence.js        # Save/load system
+├── factories/
+│   └── SkillTreeFactory.js   # Skill tree generation logic
 ├── generation/
 │   ├── BaseGenerator.js      # Base class for world generators
 │   ├── CaveGenerator.js      # Cave biome generator
@@ -64,9 +70,14 @@ src/
 │   ├── VoxelGrid.js          # 3D voxel grid data structure
 │   └── VoxelManager.js       # Voxel rendering and mesh management
 ├── managers/
+│   ├── InventoryManager.js   # Equipment and inventory
+│   ├── ItemRegistry.js       # Item definitions
+│   ├── MarketManager.js      # Shop and trading logic
 │   ├── MissionManager.js     # Mission progression and objectives
 │   ├── NarrativeManager.js   # Dialogue and story sequences
+│   ├── ResearchManager.js    # Tech tree and upgrades
 │   ├── RosterManager.js      # Character roster management
+│   ├── SkillRegistry.js      # Skill definitions map
 │   └── UnitManager.js        # Unit lifecycle and combat state
 ├── ui/
 │   ├── deployment-hud.js     # Pre-battle deployment interface
@@ -77,6 +88,9 @@ src/
 │   ├── Unit.js               # Base unit class
 │   ├── Explorer.js           # Player-controlled units
 │   └── Enemy.js              # Enemy AI units
+├── utils/
+│   ├── SeededRandom.js       # Deterministic RNG
+│   └── SimplexNoise.js       # Noise generation
 └── index.js                  # Application entry point
 ```
 
@@ -157,6 +171,15 @@ npm run test:watch
 - **Narrative**: Intro and outro sequences that advance the story
 - **Campaign Progression**: Unlock new missions as you complete objectives
 
+## Documentation
+
+For detailed specifications of game systems, please see the `specs/` directory:
+- [Character Sheet](specs/Character_Sheet.spec.md)
+- [Combat System](specs/CombatState.spec.md)
+- [Skill Trees](specs/Skill_Tree.spec.md)
+- [Inventory](specs/Inventory.spec.md)
+- [Procedural Missions](specs/Procedural_Missions.spec.md)
+
 ## Development Status
 
 This is an active development project. Current features include:
@@ -168,14 +191,16 @@ This is an active development project. Current features include:
 - ✅ Mission system foundation
 - ✅ Basic world generation
 - ✅ Save/load system
+- ✅ Turn-based combat system
+- ✅ AI behavior
+- ✅ Skill tree implementation
+- ✅ Equipment system
 
-Planned features:
+Planned features / In Progress:
 
-- 🔄 Turn-based combat system
-- 🔄 AI behavior
-- 🔄 Skill tree implementation
-- 🔄 Equipment system
-- 🔄 Additional biomes and missions
+- 🔄 Additional biomes (Crystal Spires)
+- 🔄 Advanced AI behavior (Pack tactics, Retreat)
+- 🔄 Endgame campaign content
 
 ## License