2.4 KiB
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.
- Komunikacja między modułami wyłącznie przez hooki. Jedyny wyjątek:
core/orders → core/products. Wyjątek jest jednostronny i nieprzechodni. - Nie dodawaj bezpośredniego RPC/HTTP do innego modułu, importów jego kodu lub danych, innych zależności
dependsOnani stałych obcych celów w UI. Wrapper, proxy lub dynamiczna nazwa nie stanowią obejścia tej reguły. - Nie wpisuj na sztywno konkretnego dostawcy ani klienta API. Zakazane jest np. zaufanie tylko do
core/packingw orders. Sprawdzaj uwierzytelniony kontekst i uprawnienia. Własne identyfikatory, lokalne funkcje i SDK platformy są dozwolone. - Używaj istniejącego
src/hook-contract.jsi jawnych kontraktów domenowych. Brak kontraktu rozwiąż przez jego dodanie lub rozszerzenie, bez awaryjnego powrotu do RPC. Każda paczka ma działać samodzielnie. - 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.
- Listy konfiguracji pobieraj hookiem w bieżącej instancji, np. jako
options.valuesz{ id, label }. Nie zakładaj, żeoptions.moduleadresuje właściwe konto. Zachowuj zapisane ID i pokazuj błąd niedostępnej listy. - 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ę. - Nie modyfikuj
ordershub-backendaniordershub-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ą.