From 40cfa61f4c0e6f026a60a82d0097a37e02f96f7f Mon Sep 17 00:00:00 2001
From: mpabi <mpabi@mpabi.pl>
Date: Fri, 1 May 2026 22:37:34 +0200
Subject: [PATCH] Add container workflow to README

---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/README.md b/README.md
index cb213f2..75c0f0d 100644
--- a/README.md
+++ b/README.md
@@ -399,6 +399,68 @@ Dla użytkownika `u1` i zadania `task4_stack_strlen` branch będzie miał nazwę
 u1T4a
 ```
 
+## Kolejny krok: kontenery i debugowanie
+
+Kontenery są potrzebne dopiero po pobraniu karty pracy, kiedy chcesz uruchomić
+albo debugować konkretne zadanie. `rvctl` korzysta z narzędzia
+`rv32i-hazard3-student-env`, które trafia do workspace pod:
+
+```text
+~/dev/workspace/rv/tools/rv32i-hazard3-student-env
+```
+
+Najpierw sprawdź dostępne profile i pobierz albo odśwież repo środowiska:
+
+```bash
+./rvctl env list
+./rvctl env sync
+```
+
+Po synchronizacji workspace ma dodatkowe narzędzie pod `tools`:
+
+```text
+~/dev/workspace/rv
+├── meta
+│   └── workspace-info
+├── tools
+│   ├── rv-launcher
+│   └── rv32i-hazard3-student-env
+├── tokens
+│   └── tokens.json
+└── series
+    └── inf
+        └── lab-rv32i-strlen-bss-data-stack
+```
+
+Środowisko ma dwa profile:
+
+- `rv32i` - Hazard3/RISC-V, `gdb-multiarch`, `nvim` i `tmux`,
+- `host` - natywne uruchamianie i debugowanie C przez `clang` albo `gcc`,
+  `gdb`, `nvim` i `tmux`.
+
+Zbuduj potrzebne obrazy:
+
+```bash
+./rvctl env build rv32i
+./rvctl env build host
+```
+
+Dla pobranej karty `inf bss` możesz uruchomić debugowanie w obu profilach:
+
+```bash
+./rvctl debug rv32i 4
+./rvctl debug host 4
+```
+
+Profil `host` ma też szybkie uruchomienie bez sesji debuggera:
+
+```bash
+./rvctl run host 4
+```
+
+Szczegóły komend, warianty `--dry-run`, `--instance`, `--editor` i ograniczenia
+profili są w `doc/containers.md`.
+
 ## Dokumentacja
 
 - `doc/rvctl.md` - techniczna dokumentacja CLI: wszystkie komendy, argumenty