switch to gemini

.copilot/documentation-guidelines.md

@@ -0,0 +1,35 @@
+# Documentation and Lore Management Guidelines
+
+This document outlines the rules and procedures for updating, expanding, or modifying the lore for the Echo Legion. Adhering to these guidelines ensures that the project remains consistent, organized, and traceable to its original concepts.
+
+## Core Principles
+
+1.  **Preserve Original Intent**: All changes must respect the core concepts laid out in `.copilot/original-import.md`. No new lore should contradict established facts without a strong, documented reason.
+2.  **Maintain Traceability**: Every significant piece of information must be traceable back to its source.
+3.  **Ensure Consistency**: The entire body of lore must remain internally consistent. A change in one document may require updates in others.
+
+## The Workflow for Changes
+
+1.  **Consult the Quick Reference**: Before making any change, consult `.copilot/original-import-quick-reference.md` to understand the original context and where the concept is referenced.
+2.  **Edit or Add Content**: Make the necessary changes to the relevant markdown file(s) in the `lore/`, `military/`, `society/`, or `technology/` directories.
+3.  **Add/Update Traceability Comments**: Insert or update a hidden HTML comment (`<!-- ... -->`) near the modified text, referencing the relevant line number(s) from `original-import.md`.
+    -   **Example**: `<!-- Original import: Lines 45-49 describe the armor's origins -->`
+4.  **Update the Quick Reference (If Necessary)**: If a major new concept is introduced or an existing one is significantly altered, update the `.copilot/original-import-quick-reference.md` to reflect this.
+5.  **Update the Development Log**: Briefly note the change in `.copilot/development-log.md` to maintain a running history of the project's evolution.
+
+## File Structure Overview
+
+-   **`README.md`**: Master index. Should only contain high-level summaries and links.
+-   **`lore/`**: Contains the history and narrative of the faction.
+-   **`military/`**: Contains all information related to the faction's armed forces.
+-   **`society/`**: Contains details on culture, philosophy, and characters.
+-   **`technology/`**: Contains specifics on equipment, STCs, and manufacturing.
+-   **`.copilot/`**: Contains all meta-files for project management.
+    -   `original-import.md`: The read-only source material. **DO NOT EDIT.**
+    -   `original-import-quick-reference.md`: The primary tool for validation.
+    -   `development-log.md`: A log of all major changes and decisions.
+    -   `faction-reference.md`: A quick cheat-sheet for names, terms, and core ideas.
+    -   `documentation-guidelines.md`: This file.
+
+---
+*This system was established to ensure long-term project health and clarity. Follow it rigorously.*

.copilot/original-import-quick-reference.md

@@ -198,6 +198,8 @@ This document provides a detailed mapping of where each major topic, detail, and
 - Warp abilities accurately described: ✓
 - Imperial relationship complexity preserved: ✓
 - Technology philosophy consistent: ✓
+- **Hidden comments added to all major files**: ✓
+- **Source line references integrated**: ✓
 
 ## Cross-Reference Usage
 
@@ -207,7 +209,20 @@ When editing any new documentation:
 3. Add hidden comments pointing to specific line numbers when needed
 4. Validate that no original details are contradicted or lost
 
+## Files with Complete Source References
+
+✓ `README.md` - Master overview with key concept references
+✓ `lore/01-origins-and-history.md` - Origins, evolution, vow references  
+✓ `lore/02-first-contact-imperial-relations.md` - First contact scenario references
+✓ `society/philosophy-and-culture.md` - Philosophy and social structure references
+✓ `society/notable-characters.md` - Character profiles (existing content maintained)
+✓ `military/combat-doctrine.md` - Tactical doctrine and armor role references
+✓ `military/exo-armor-specifications.md` - Technical specs with design philosophy references
+✓ `technology/stc-systems-and-manufacturing.md` - STC importance and protection references
+✓ `technology/weapons-and-equipment.md` - Weapon systems with original concept references
+
 ---
 
 *Last Updated: Current conversation*
 *Original Import File: `.copilot/original-import.md` (1050 lines)*
+*Status: Complete validation system with full traceability*