This document contains foundational mandates that I (Gemini) must follow throughout the development of IncriElemental.
- Architecture First: Prioritize separation between
Corelogic andDesktoprendering. - Agentic DevOps: I am responsible for the entire build, test, and visual audit lifecycle.
- Validation: No change is complete without passing unit tests AND visual health audits.
- Framework: .NET 10.0 (MonoGame DesktopGL).
- UI: Glassmorphism panels with runic accents and dynamic anchoring.
- Visuals: High-fidelity "Aetherial Glow" using HLSL Bloom and multi-layered parallax.
- Verification: Utilize UI Metadata (JSON) for state validation to avoid pixel-match fragility.
- Automated Gallery: Maintain up-to-date screenshots in
review/anddocs/screenshots.md. - Audit Suite: Run
scripts/palette_audit.py,scripts/contrast_check.py, andscripts/parallax_audit.pyafter significant visual changes. - Staleness: Visuals are considered "stale" if more than 16 UI/Visual source files have changed since the last capture.
- Test Coverage: Overall coverage must remain above 70%.
- Monolith Prevention: No single source file (
.cs) should exceed 250 lines. - Documentation FRESHNESS: Documentation is stale if more than 20 source files have changed. Resolve by providing meaningful content improvements; simply updating the date line is prohibited. When staleness fails, a comprehensive documentation review is mandatory.
Last Updated: Tuesday, March 17, 2026 (Updated by Agent Gemini)