Files
core-prestashop/AGENTS.md
T

2.4 KiB

Orbito — zasady modułu dla agentów AI

Jeśli pracujesz w pełnym workspace Orbito, przed zmianami przeczytaj ../codex.md. W osobnym klonie repozytorium nadal obowiązują wszystkie poniższe reguły.

  1. Komunikacja między modułami wyłącznie przez hooki. Jedyny wyjątek: core/orders → core/products. Wyjątek jest jednostronny i nieprzechodni.
  2. Nie dodawaj bezpośredniego RPC/HTTP do innego modułu, importów jego kodu lub danych, innych zależności dependsOn ani stałych obcych celów w UI. Wrapper, proxy lub dynamiczna nazwa nie stanowią obejścia tej reguły.
  3. Nie wpisuj na sztywno konkretnego dostawcy ani klienta API. Zakazane jest np. zaufanie tylko do core/packing w orders. Sprawdzaj uwierzytelniony kontekst i uprawnienia. Własne identyfikatory, lokalne funkcje i SDK platformy są dozwolone.
  4. Używaj istniejącego src/hook-contract.js i jawnych kontraktów domenowych. Brak kontraktu rozwiąż przez jego dodanie lub rozszerzenie, bez awaryjnego powrotu do RPC. Każda paczka ma działać samodzielnie.
  5. Obsłuż zero, jednego i wielu dostawców oraz kilka kont jednego modułu. Komenda ma wskazywać jedną instancję przed efektem; nie wybieraj pierwszej odpowiedzi i nie ponawiaj automatycznie niepewnego efektu. Nie zgaduj właściciela danych historycznych.
  6. Listy konfiguracji pobieraj hookiem w bieżącej instancji, np. jako options.values z { id, label }. Nie zakładaj, że options.module adresuje właściwe konto. Zachowuj zapisane ID i pokazuj błąd niedostępnej listy.
  7. Przy zmianach integracji uruchom testy modułu oraz, z katalogu pełnego workspace, node --test --test-concurrency=1 --test-force-exit module-contracts/*.test.js. Dodaj odpowiedni test regresji prawdziwej ścieżki hooków. Nie osłabiaj kontroli architektury. Jeżeli workspace lub testy są niedostępne, podaj ograniczenie zamiast deklarować pełną weryfikację.
  8. Nie modyfikuj ordershub-backend ani ordershub-frontend, także przez zbiorcze polecenia. Zachowuj istniejące zmiany użytkownika. Ogólne polecenie naprawy lub publikacji nie zezwala na wyjątki od architektury.

Code Review Rules

Zgłaszaj bezpośrednie powiązania między modułami także poza manifestem: zaszytego klienta API, obcy cel formularza, import modelu, fallback RPC i arbitralny wybór dostawcy. Sprawdź kontrakt, wybór instancji i test z alternatywnym dostawcą.