From e354f23ad19684cd82936004c2922e93a8e19ce3 Mon Sep 17 00:00:00 2001 From: tr1x_em Date: Wed, 6 Aug 2025 13:43:47 +0530 Subject: [PATCH] Agents --- AGENTS.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..1a0e8b5 --- /dev/null +++ b/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 \ No newline at end of file