Handbücher finden Sie unter [**Hiring → Handbücher**](/hiring/playbooks). Ein Handbuch ist eine benannte Gruppe von **Ressourcen**: Markdown-Dokumente, die Sie in Kit schreiben, und Links auf Material, das anderswo liegt.

**Nichts aus einem Handbuch bekommen Kandidaten je zu sehen.** Es ist ausschließlich für Ihr Team bestimmt – Karriereportal, Kandidatenportal und Bewerbungs-E-Mails greifen nie darauf zu.

Das Handbuch eines Entwicklungsteams könnte enthalten:

| Ressource | Typ |
|---|---|
| Vorstellungsvideo des Unternehmens | Link (YouTube – spielt eingebettet) |
| So führen wir das Erstgespräch | Dokument |
| Checkliste für Code-Reviews – Backend | Dokument |
| Fragenkatalog zum Kulturfit | Dokument |
| Organisation des Vor-Ort-Tags (Google Doc) | Link |

## Wer was darf

| | Lesen | Erstellen, bearbeiten, löschen, neu anordnen |
|---|---|---|
| Hiring-**Mitglied** | Ja | Nein |
| Hiring-**Admin** | Ja | Ja |

Die Stufen gelten je Modul: Ein Hiring-Admin, der in Outreach nur Mitglied ist, hat hier trotzdem vollen Schreibzugriff. Siehe [Team-Rollen](/docs/team-roles).

## Dokumente und Links

Ein **Dokument** ist Markdown, das Sie in Kit schreiben. Der Editor hat einen Umschalter **Schreiben / Vorschau**; Überschriften, Tabellen, Aufgabenlisten, Durchgestrichenes und URLs ohne Linksyntax werden gerendert. Rohes HTML wird verworfen, nicht maskiert. Der Inhalt ist auf 100.000 Zeichen begrenzt.

Ein **Link** ist eine URL auf etwas, das Sie ohnehin anderswo pflegen. Klicken Sie auf **Vorschau abrufen**: Links zu YouTube, Vimeo und Loom erhalten einen eingebetteten Player, alles andere wird als einfacher Link gespeichert – der Normalfall bei Dokumenten und Wikis. Dateiuploads gibt es nicht: Legen Sie die Datei dort ab, wo sie ohnehin liegt, und verlinken Sie sie.

> [!WARNING]
> **Der Typ einer Ressource steht nach dem Speichern fest.** Aus einem Dokument kann später kein Link werden und umgekehrt: Beim Wechsel würden der Inhalt und jede seiner Versionen ins Leere laufen. Für einen anderen Typ legen Sie eine neue Ressource an und löschen die alte.

Auf der Handbuchseite können Administratoren Ressourcen per Ziehen neu anordnen. Solange der Filter aktiv ist, ist das Neuanordnen deaktiviert, denn eine gefilterte Liste zeigt nur einen Ausschnitt.

## Vorschläge bei der Phaseneinrichtung

Beim Hinzufügen oder Bearbeiten einer Ressource haken Sie unter **Bei der Phaseneinrichtung vorschlagen** Phasentypen an: Bewerbung einreichen, Programmieraufgabe, Vorstellungsgespräch, Angebot, Portfolio-Review, Fragebogen, Referenzprüfung, Take-Home-Aufgabe, Team-Bewertung, Video-Vorstellung, Video-Antwort.

Ein Teammitglied, das eine Phase dieses Typs öffnet, sieht dann den Bereich **Aus Ihrem Handbuch** mit den hinterlegten Ressourcen. Jede öffnet sich in einem neuen Tab, sodass nichts Ungespeichertes in der Phase verloren geht.

Der Bereich lässt sich ausblenden, und das Ausblenden wirkt bewusst eng:

- **Pro Person.** Ausblenden blendet ihn für niemanden sonst aus.
- **Pro Phasentyp.** Bei Phasen vom Typ Vorstellungsgespräch ausgeblendet, bleibt er bei Programmieraufgaben sichtbar.
- **Kehrt bei Neuzugängen zurück.** Eine Ressource, die *nach* dem Ausblenden hinterlegt wird, holt den Bereich für diese Person zurück. Einmal ausblenden begräbt also nicht, was das Team nächsten Monat schreibt.

## Versionsverlauf

Jedes Speichern, das Titel, Inhalt oder Link einer Ressource ändert, legt einen Stand ab. Wer die Ressource bearbeiten darf, sieht daneben den **Verlauf**: die sechs neuesten Versionen, ältere hinter einem Umschalter. Jeder Eintrag nennt, wer gespeichert hat und welche Felder sich geändert haben.

**Ansehen** öffnet eine frühere Version. **Wiederherstellen** übernimmt sie wieder – und zwar vorwärts: Es schreibt eine *neue* Version mit dem alten Inhalt, statt den Verlauf zurückzuspulen. Nichts wird gelöscht, und Sie können jederzeit wieder zurück.

Wird eine Ressource gelöscht, verschwindet ihr Verlauf mit ihr.

## Eine Ressource finden

| Wo | Worauf es passt |
|---|---|
| Filter auf einer Handbuchseite (erscheint ab mehr als 8 Ressourcen) | Teilstring aus Titel, Inhalt oder Link |
| Cmd+K | Namen von Handbüchern und Titel von Ressourcen |
| `hiring_search_playbooks` (Agenten) | Volltext, nach Relevanz sortiert, über Titel, Inhalte und Handbuchnamen |

Die Suche arbeitet mit Stichwörtern, nicht semantisch: „Auswertungsgespräch bewerten“ findet genau diese Wörter, keine Umschreibung davon.

## Für KI-Agenten

Vier Tools, die nur lesen. Sie brauchen Hiring-Zugriff und den Hiring-**Lese**-Scope der Verbindung – mehr nicht. Wie Sie einen Client verbinden, steht unter [KI-Agent und MCP-Tools](/docs/hiring-ai-agent-mcp).

| Tool | Liefert |
|---|---|
| `hiring_list_playbooks` | Jedes Handbuch mit seinen Ressourcen nach Titel, Typ, ID, Slug und Phasentypen. **Keine Dokumentinhalte** – das ist die Übersicht. |
| `hiring_get_playbook` | Ein Handbuch über `pbk_`-ID oder Slug, mit Inhalten **auf 2.000 Zeichen gekürzt** und einem Vermerk, wenn gekürzt wurde. |
| `hiring_read_resource` | Eine Ressource über `rsc_`-ID oder Slug, **vollständig** – der ganze Inhalt oder die URL eines Links. |
| `hiring_search_playbooks` | Treffer nach Relevanz mit hervorgehobenem Textausschnitt und der `rsc_`-ID zum Nachfassen. Die Ausschnitte sind Auszüge. |

Erst suchen oder auflisten, dann `hiring_read_resource` für alles, was vollständig gebraucht wird. `hiring_get_playbook` zeigt ein ganzes Handbuch auf einen Blick; wegen der Kürzung ist es der falsche letzte Aufruf, bevor ein Agent eine Detailfrage beantwortet.

## Kurz-Check

- [ ] Ein Handbuch je Art von Einstellung, nicht eines je Team
- [ ] Alles Verfahrensmäßige für die Phasentypen hinterlegen, für die es gilt
- [ ] Auf Material verlinken, das anderswo gepflegt wird; Dokumente nur für das in Kit schreiben, wofür Kit der richtige Ort ist
- [ ] Den Typ gleich beim ersten Mal richtig wählen – später lässt er sich nicht ändern
- [ ] Ihrem KI-Assistenten eine Frage stellen, deren Antwort Sie kennen – so prüfen Sie, ob er die richtige Ressource liest