adsPRO/AGENTS.md

AGENTS.md

Sposób pracy

• Pisz do mnie po polsku, zwięźle i krótko, ale merytorycznie

Zasady pisania kodu

• Kod ma być czytelny „dla obcego”: jasne nazwy, mało magii
• Brak „skrótów na szybko” typu logika w widokach, copy-paste, losowe helpery bez spójności
• Każda funkcja/klasa ma mieć jedną odpowiedzialność, zwykle do 30–50 linii (jeśli dłuższe – dzielić)
• max 3 poziomy zagnieżdżeń (if/foreach), reszta do osobnych metod
• Nazewnictwo:
  • klasy: PascalCase
  • metody/zmienne: camelCase
  • stałe: UPPER_SNAKE_CASE
• Zero „skrótologii” w nazwach (np. $d, $tmp, $x1) poza pętlami 2–3 linijki
• medoo + prepared statements bez wyjątków (żadnego sklejania SQL stringiem)
• XSS: escape w widokach (np. helper e())
• CSRF dla formularzy, sensowna obsługa sesji
• Kod ma mieć komentarze tylko tam, gdzie wyjaśniają „dlaczego”, nie „co”

Wprowadzanie zmian

• Przeanalizuj wprowadzone zadanie
• Jeżeli masz jakieś wątpliwości pytaj
• Przedstaw plan
• Po akceptacji wdróź plan