millora script budget

AGENTS.md

@@ -0,0 +1,26 @@
+# AGENTS.md - Coding Agent Guidelines
+
+## Build/Test Commands
+- **Check ledger**: `./commands/check` (validates beancount syntax)
+- **Serve web UI**: `./commands/serve` (starts fava on port 8080)
+- **Python tests**: `pytest` (single test: `pytest path/to/test.py::test_name`)
+- **Install dependencies**: `uv sync` or `pip install -r requirements.txt`
+
+## Project Structure
+- **Main ledger**: `ledger/main.beancount` (entry point)
+- **Accounts**: `ledger/accounts.beancount`
+- **Transactions**: `ledger/transactions/YYYY/MM.beancount`
+- **Python plugins**: `ledger/plugins/`
+- **Commands**: `commands/` (bash scripts)
+
+## Code Style & Conventions
+- **Python**: Follow PEP 8, use type hints, snake_case naming
+- **Beancount**: Use consistent account naming (Assets:Bank:Checking)
+- **Imports**: Standard library first, third-party second, local imports last
+- **Error handling**: Use namedtuples for custom errors in plugins
+- **Documentation**: Clear docstrings for plugin functions
+
+## Key Dependencies
+- beancount 2.3.6 (double-entry accounting)
+- fava 1.26.2 (web interface)
+- pytest 7.4.3 (testing)