Podręczniki znajdziesz w **Rekrutacja → Podręczniki**, pod adresem [/hiring/playbooks](/hiring/playbooks). Podręcznik to nazwana grupa **materiałów**: dokumentów w Markdown pisanych w Kit oraz linków do treści, które trzymasz gdzie indziej.

**Kandydat nigdy nie zobaczy niczego z podręcznika.** To rekrutacyjny podręcznik Twojego zespołu, tylko do użytku wewnętrznego: portal kariery, portal kandydata ani e-maile do kandydatów nigdy do niego nie sięgają.

Podręcznik zespołu inżynierskiego może zawierać:

| Materiał | Typ |
|---|---|
| Wideo o firmie | Link (YouTube, wbudowany odtwarzacz) |
| Jak prowadzimy rozmowę wstępną | Dokument |
| Checklista code review — backend | Dokument |
| Baza pytań o dopasowanie kulturowe | Dokument |
| Organizacja dnia rozmów w biurze (Google Doc) | Link |

## Kto co może

| | Odczyt | Tworzenie, edycja, usuwanie, zmiana kolejności |
|---|---|---|
| **Członek** modułu Rekrutacja | Tak | Nie |
| **Administrator** modułu Rekrutacja | Tak | Tak |

Poziomy działają osobno w każdym module, więc administrator Rekrutacji, który w Outreach jest tylko członkiem, ma tutaj pełne prawa zapisu. Zobacz [Role w zespole](/docs/team-roles).

## Dokumenty i linki

**Dokument** to Markdown, który piszesz w Kit. Edytor ma przełącznik **Napisz / Podgląd**; renderują się nagłówki, tabele, listy zadań, przekreślenia i same adresy URL. Surowy HTML jest wycinany, a nie pokazywany jako tekst. Treść może mieć najwyżej 100 000 znaków.

**Link** to adres do czegoś, co już masz gdzie indziej. Kliknij **Pobierz podgląd**: linki z YouTube, Vimeo i Loom dostaną wbudowany odtwarzacz, reszta zapisze się jako zwykły link, co przy dokumentacji i wiki jest normą. Nie ma wgrywania plików. Zostaw plik tam, gdzie leży, i podlinkuj go.

> [!WARNING]
> **Typ materiału ustalasz przy zapisie i później go nie zmienisz.** Dokument nie stanie się linkiem ani odwrotnie: taka zamiana osierociłaby treść i całą jej historię wersji. Żeby zmienić typ, utwórz nowy materiał i usuń stary.

Administratorzy mogą przeciągać materiały i ustawiać ich kolejność na stronie podręcznika. Przy włączonym filtrze zmiana kolejności jest wyłączona, bo odfiltrowana lista to tylko wycinek.

## Podpowiedzi przy konfiguracji etapu

Dodając albo edytując materiał, zaznacz typy etapów w sekcji **Podpowiadaj przy konfiguracji etapu**: Złóż aplikację, Zadanie programistyczne, Rozmowa kwalifikacyjna, Oferta, Przegląd portfolio, Kwestionariusz, Weryfikacja referencji, Zadanie domowe, Ocena zespołu, Prezentacja wideo, Odpowiedź wideo.

Osoba z zespołu, która otworzy etap tego typu, zobaczy panel **Z podręcznika zespołu** z listą oznaczonych materiałów. Każdy otwiera się w nowej karcie, więc niezapisane zmiany na etapie nie przepadają.

Panel ma przycisk ukrywania, a zasięg tego ukrycia jest celowo wąski:

- **Dla jednej osoby.** Ukrycie panelu nie ukrywa go nikomu innemu.
- **Dla jednego typu etapu.** Ukryty na rozmowach kwalifikacyjnych nadal pokazuje się na zadaniach programistycznych.
- **Wraca, gdy dojdzie coś nowego.** Materiał oznaczony *po* tym, jak ktoś ukrył panel, przywraca ten panel tej osobie. Jednorazowe wyciszenie nie zakopie tego, co zespół napisze za miesiąc.

## Historia wersji

Każdy zapis, który zmienia tytuł, treść albo link materiału, zostawia kopię. Panel historii wersji jest obok materiału i widzą go osoby, które mogą go edytować: sześć najnowszych wersji, starsze pod przełącznikiem. Każdy wpis mówi, kto zapisał i które pola się zmieniły.

**Zobacz** otwiera dawną wersję. **Przywróć** stosuje ją ponownie, ale przywracanie działa do przodu: powstaje *nowa* wersja ze starą treścią, historia nie jest cofana. Nic nie znika i przywracaniem możesz wrócić do dowolnego stanu.

Usunięcie materiału kasuje razem z nim historię wersji.

## Jak znaleźć materiał

| Gdzie | Co dopasowuje |
|---|---|
| Pole filtra na stronie podręcznika (pojawia się przy więcej niż 8 materiałach) | Fragment tytułu, treści albo adresu URL |
| Cmd+K | Nazwy podręczników i tytuły materiałów |
| `hiring_search_playbooks` (agenci) | Pełnotekstowo i z rankingiem, po tytułach, treściach i nazwach podręczników |

Wyszukiwanie działa na słowach kluczowych, nie semantycznie: „ocena po rozmowie” znajdzie dokładnie te słowa, a nie ich parafrazę.

## Dla agentów AI

Cztery narzędzia tylko do odczytu. Wymagają dostępu do Rekrutacji i uprawnienia **read** dla tego modułu w danym połączeniu, nic poza tym. Jak podłączyć klienta, opisuje [Agent AI i narzędzia MCP](/docs/hiring-ai-agent-mcp).

| Narzędzie | Co zwraca |
|---|---|
| `hiring_list_playbooks` | Wszystkie podręczniki wraz z materiałami: tytuł, typ, id, slug i typy etapów. **Bez treści dokumentów** — to jest mapa. |
| `hiring_get_playbook` | Jeden podręcznik po id `pbk_` albo slugu, z treściami **przyciętymi do 2000 znaków** i oznaczeniem, gdy treść jest przycięta. |
| `hiring_read_resource` | Jeden materiał po id `rsc_` albo slugu, **w całości**: pełna treść albo adres URL linku. |
| `hiring_search_playbooks` | Uszeregowane trafienia z podświetlonym fragmentem i identyfikatorem `rsc_` do dalszego odczytu. Fragmenty to tylko wycinki. |

Najpierw wyszukaj albo wylistuj, a `hiring_read_resource` zostaw na to, co musisz mieć w całości. `hiring_get_playbook` pokazuje cały podręcznik na raz, ale przez przycinanie treści nie nadaje się na ostatnie wywołanie przed szczegółową odpowiedzią agenta.

## Checklist

- [ ] Jeden podręcznik na jeden rodzaj rekrutacji, nie jeden na zespół
- [ ] Wszystko, co opisuje procedurę, oznacz typami etapów, których dotyczy
- [ ] Do treści utrzymywanych gdzie indziej dawaj linki; w Kit pisz tylko to, co naprawdę należy do Kit
- [ ] Typ ustaw dobrze za pierwszym podejściem, bo później się go nie zmieni
- [ ] Zadaj swojemu asystentowi AI pytanie, na które znasz odpowiedź, i sprawdź, czy czyta właściwy materiał