wecker/AGENTS.md

System Context

This project runs on a Raspberry Pi 4 Model B (2018). Please take this into account for all code changes, dependencies (e.g., ARM architecture), and performance optimizations.

Audio Output Note

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).