diff --git a/AGENTS.md b/AGENTS.md index 28f7b25..4f52c9c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,11 +7,15 @@ Please take this into account for all code changes, dependencies (e.g., ARM arch When configuring audio or running tasks on this device, **always use the 3.5mm headphone jack (Audio Jack)** as the explicit audio output unless requested otherwise. The system might have HDMI devices as lower-index cards, which can cause headless/cron background scripts to fail with ALSA errors. Ensure tools and scripts explicitly target the correct audio card (usually `hw:2,0` or via a user-wide `~/.asoundrc` config). ## Development Guidelines -- Follow the principles of TDD (Test-Driven Development), DRY (Don't Repeat Yourself), and MVP (Minimum Viable Product). +**STRICT ADHERENCE to the following guidelines is mandatory for every task. Failure to follow these principles undermines the integrity of the project.** + +- **TDD (Test-Driven Development):** Always write tests *before* implementing the actual logic. Follow the Red-Green-Refactor cycle. +- **DRY (Don't Repeat Yourself):** Minimize redundancy in code and logic. +- **MVP (Minimum Viable Product):** Implement only what is necessary to meet the requirement. - Use `uv` to manage dependencies for Python. - Use `uv ruff` to lint the code. -- Never commit untested code. -- Only commit when ruff is green. +- **Never commit untested code.** +- **Only commit when ruff is green.** ## Pre-commit Rules - Always lint the code (`uv ruff`).