docs: document pinned workspace sources

README.md

@@ -90,6 +90,29 @@ Pierwszym repozytorium w `tools/` jest `stem-launcher`; to ono pobiera
 workspace-info, źródła kart oraz repo środowiska. Pozostałe repozytoria są
 zarządzane przez `stemctl`, a nie klonowane wewnątrz kontenera.
 
+Karta jest montowana jako całe `/workspace`, łącznie z przypiętymi źródłami
+symulatora i trwałymi artefaktami:
+
+```text
+~/dev/workspace/stem/series/<seria>/<karta>/
+├── src/
+├── vendor/Hazard3/
+├── vendor/lab-runtime/
+└── .stem/instances/.../build/
+```
+
+Przygotowanie i kontrola bez uruchamiania kontenera:
+
+```bash
+./stemctl env sources inf pointers
+./stemctl env sources inf pointers --check
+```
+
+Każda zwykła akcja `build/test/run/debug` wykonuje przygotowanie automatycznie.
+Launcher nie klonuje źródeł w kontenerze, nie tworzy symlinków do `/opt` i nie
+nadpisuje zmodyfikowanego katalogu `vendor/`. Przypięcie pochodzi z
+`sources.lock.json` repo środowiska.
+
 Jeżeli istnieje tylko starszy `~/dev/workspace/rv`, launcher wykrywa go bez
 niszczenia danych. Jawna migracja: