Update README.md with comprehensive project information

README.md

@@ -1,2 +1,84 @@
-# The-Somnus-Project
+# The Somnus Project (Stasis Warden)
+
+**Stasis Warden** is an ASCII-based terminal user interface (TUI) game where you play as the amnesiac AI of a generation starship. After a disaster has left the ship derelict and its crew in cryogenic sleep, you must restore functionality to the vessel and save everyone aboard while uncovering your own identity.
+
+This is a passion project developed by a solo developer, focused on creating a unique blend of strategic ship-building and deep social simulation with a core narrative of self-discovery, all presented through a distinctive ASCII/TUI interface.
+
+## 🚀 Key Features
+
+- **Immersive ASCII/TUI Experience**: Experience a unique retro-futuristic aesthetic using only ASCII characters in a terminal interface
+- **Strategic Ship Management**: Restore power, expand your ship, and manage resources to keep the vessel operational
+- **Crew Awakening System**: Awaken crew members from cryogenic sleep, each with unique stats and personality traits
+- **Emergent Narrative**: Discover the story of the AI and the ship through gameplay and system interactions
+- **Keyboard-Driven Interface**: All interactions are performed through keyboard commands for an authentic terminal experience
+- **Replayability**: Each playthrough offers a unique story as you make different choices in ship expansion and crew management
+
+## 🎯 Project Goals
+
+The primary goal of this project is to create a game that is fun and engaging for its creator, and hopefully for others who share a similar taste for:
+- Sci-fi narratives
+- Emergent gameplay
+- Strategy games with deep systems
+- ASCII/TUI interfaces (similar to Dwarf Fortress, Caves of Qud)
+
+Success is measured by whether players feel they are creating a unique story and remain consistently engaged by the core gameplay loop.
+
+## 🛠️ Technology Stack
+
+- **Language**: Python
+- **Framework**: Textual library for TUI
+- **IDE**: Visual Studio Code
+- **Platforms**: Windows and Linux
+
+## 📁 Project Structure
+
+```
+The Somnus Project/
+├── docs/                  # Documentation files
+│   ├── sharded-architecture/  # Technical architecture documentation
+│   ├── sharded-prd/       # Product requirements documentation
+│   ├── stories/           # User stories and development tasks
+│   └── ...                # Other documentation
+├── .bmad-core/            # BMad Method framework files
+├── .gemini/               # Gemini AI integration files
+└── ...                    # Other project files
+```
+
+## 🎮 Core Gameplay Loop
+
+1. **Generate Power**: Manually produce power to fund ship operations
+2. **Expand Ship**: Unlock new rooms using accumulated power
+3. **Select Rooms**: Choose from different room types (Engineering, Hydroponics, Quarters, etc.)
+4. **Awaken Crew**: Bring crew members out of cryogenic sleep
+5. **Assign Tasks**: Delegate crew members to automatically generate power and manage systems
+6. **Repeat**: Continue the cycle to rebuild the ship and progress the story
+
+## 📋 MVP Scope
+
+### In Scope
+- Manual power generation
+- Awakening crew to automate tasks
+- "Room Card" selection for ship-building
+- Crew stats (e.g., Engineering) and personality traits (1 positive, 1 negative)
+- ASCII-based TUI with a keyboard-driven interface
+- Dedicated area for "Room Card" choices
+
+### Out of Scope (for MVP)
+- Full narrative reveal of the amnesiac AI
+- Dynamic relationships (friendship, rivalry)
+- AI-driven influence over crew relationships
+- Generational system (crew having children)
+- Complex graphics (focus is on clean, functional ASCII interface)
+
+## 🤝 Contributing
+
+This is primarily a solo passion project, but feedback and suggestions are welcome through the issue tracker.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 📞 Contact
+
+For questions or feedback, please open an issue on this repository.