Agents

AGENTS.md

@@ -0,0 +1,25 @@
+# AGENTS.md - Modus Desktop Environment
+
+## Project Overview
+- **Technology**: Python desktop environment using Fabric framework (GTK/PyGObject)
+- **Purpose**: Wayland desktop environment with launcher, panel, dock, notifications
+- **Entry Point**: `main.py` - starts all components
+
+## Build/Test Commands
+- **Run Application**: `python main.py`
+- **Test Icon Browser**: `python test.py` 
+- **Install Dependencies**: `pip install -r requirements.txt`
+- **No formal test suite exists** - test by running components directly
+
+## Code Style Guidelines
+- **Imports**: Standard library first, third-party second, local modules last with blank lines between groups
+- **Formatting**: Follow PEP 8, use 4 spaces for indentation
+- **Naming**: snake_case for functions/variables, PascalCase for classes, UPPER_CASE for constants
+- **Type Hints**: Use typing imports for List, Optional, Tuple annotations
+- **Error Handling**: Use try/except blocks, log errors with print statements or loguru logger
+- **Comments**: Minimal docstrings for classes, no inline comments unless complex logic
+- **Constants**: Define module-level constants at top (e.g., SEARCH_DEBOUNCE_MS = 50)
+- **Properties**: Use @Property decorator with type hints for Fabric service properties
+- **Signals**: Use @Signal decorator for event handling in services
+- **Widget Structure**: Inherit from appropriate Fabric widgets (Window, Box, Entry, etc.)
+- **GTK Integration**: Use gi.repository imports for GTK, GLib functionality