Hiring-Handbücher

Handbücher finden Sie unter Hiring → Handbücher. 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.

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.

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.

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