AGENTS.md

# Agent Guidelines (AGENTS.md)

Welcome! This file outlines developer guidelines, operational constraints, and guidelines for AI pair programmers working on this repository.

## Operational Standards

- **Code Styling**: Python code must format cleanly via Ruff. Run `ruff check` and `ruff format` before pushing.
- **Typing Guidelines**: Maintain correct mypy typing annotations. Type signatures must be explicitly defined where possible.
- **Database Safety**: Ensure database schemas are updated dynamically using self-healing auto-migrations in `Store.init_db()`.
- **GitLab CI/CD**: Ensure the 8 quality-gate pipeline stages remain green and functional.
- **Security Checklists**: Do not commit credentials or secrets. Ensure Bandit scans return zero warnings.