Collections/AGENTS.md

AGENT CODING STANDARDS

This project is a PHP MVC application using Composer, Twig, FastRoute, and SQLite in an LXC container.

🛠️ Development Commands

• Dependencies: composer install / update (updates after editing composer.json)
• Linting: N/A (adhere to PSR-12 manually)
• Testing: curl localhost (no framework; run manual scripts like php test.php for single tests)
• Build: N/A (direct PHP execution)
• Version Control: git status / add / commit / push

📐 Code Style & Conventions

1. Architecture: MVC pattern (Controllers in src/Controllers/, Models in src/Models/, Views in templates/)
2. Namespacing: PSR-4 with App\ base
3. Naming: Classes PascalCase, methods/variables camelCase
4. Templating: Twig only (.twig files)
5. I18n: Use App\Services\TranslationService (PHP) or {{ trans('ID') }} (Twig)
6. Error Handling: try/catch blocks; log with error_log()
7. Database: Use App\Database\Database::getInstance() (no direct PDO)
8. Imports: use statements at top or fully qualified names
9. Security: No secrets/keys exposure or logging
10. Types: Type hints on params/returns where possible
11. Formatting: PSR-12
12. Comments: Avoid unless requested
13. Libraries: Check composer.json before adding