Manuels de recrutement

Les manuels se trouvent sous Recrutement → Manuels, à l’adresse /hiring/playbooks. Un manuel est un ensemble nommé de ressources : des documents Markdown rédigés dans Kit, et des liens vers du matériel hébergé ailleurs.

Rien de ce que contient un manuel n’est jamais montré aux candidats. C’est le manuel interne de votre équipe — le portail carrière, le portail candidat et les e-mails de candidature n’y puisent jamais.

Le manuel d’une équipe d’ingénierie peut contenir :

Ressource	Type
Vidéo de présentation de l’entreprise	Lien (YouTube — lecteur intégré)
Comment nous menons le premier entretien	Document
Liste de contrôle pour la revue de code — backend	Document
Banque de questions sur l’adéquation culturelle	Document
Logistique de la journée sur site (Google Doc)	Lien

Qui peut faire quoi

	Lecture	Créer, modifier, supprimer, réordonner
Membre du Recrutement	Oui	Non
Administrateur du Recrutement	Oui	Oui

Les niveaux sont définis par module : un administrateur du Recrutement qui n’est que membre en Prospection conserve ici tous les droits d’écriture. Voir Rôles d’équipe.

Documents et liens

Un document est du Markdown que vous rédigez dans Kit. L’éditeur propose un sélecteur Rédiger / Aperçu ; les titres, les tableaux, les listes de tâches, le texte barré et les URL brutes sont tous rendus. Le HTML brut est supprimé, pas échappé. Le contenu est plafonné à 100 000 caractères.

Un lien est une URL vers un contenu que vous conservez déjà ailleurs. Appuyez sur Charger l’aperçu : les liens YouTube, Vimeo et Loom obtiennent un lecteur intégré ; tout le reste est enregistré comme simple lien, ce qui est le cas courant pour la documentation et les wikis. Il n’y a pas de téléversement de fichiers — laissez le fichier là où il vit déjà et créez un lien vers lui.

Les administrateurs peuvent faire glisser les ressources pour les réordonner sur la page du manuel. Le réordonnancement est désactivé tant que le champ de filtre est utilisé, une liste filtrée n’étant qu’un sous-ensemble.

Suggestions lors de la configuration d’une étape

Lorsque vous ajoutez ou modifiez une ressource, cochez des types d’étapes sous Suggérer lors de la configuration d’une étape : Déposer une candidature, Exercice de code, Entretien, Offre, Revue de portfolio, Questionnaire, Vérification des références, Exercice à domicile, Évaluation de l’équipe, Présentation vidéo, Réponse vidéo.

Un collègue qui ouvre une étape de ce type voit alors un panneau Extrait de vos manuels listant les ressources associées. Chacune s’ouvre dans un nouvel onglet, pour ne rien perdre de ce qui n’est pas encore enregistré sur l’étape.

Le panneau dispose d’un bouton pour le masquer, et ce masquage est volontairement étroit :

• Par personne. Le masquer ne le masque jamais pour quelqu’un d’autre.
• Par type d’étape. Le masquer sur les étapes Entretien le laisse visible sur les étapes Exercice de code.
• Ramené par tout ajout ultérieur. Une ressource associée après qu’une personne a masqué le panneau le fait revenir pour elle. Le masquer une fois n’enterre pas ce que l’équipe écrira le mois prochain.

Historique des versions

Chaque enregistrement qui modifie le titre, le contenu ou le lien d’une ressource écrit un instantané. Le panneau d’historique s’affiche à côté de la ressource pour les personnes qui peuvent la modifier : les six versions les plus récentes, les plus anciennes étant repliées. Chaque entrée indique qui a enregistré et quels champs ont changé.

Voir ouvre une version antérieure. Restaurer la réapplique — et restaurer va toujours de l’avant : cela écrit une nouvelle version contenant l’ancien contenu, au lieu de rembobiner l’historique. Rien n’est effacé, et vous pouvez remonter le temps par restaurations successives.

Supprimer une ressource supprime son historique avec elle.

Retrouver une ressource

Où	Ce qui est comparé
Champ de filtre sur la page d’un manuel (apparaît au-delà de 8 ressources)	Une portion du titre, du contenu ou du lien
Cmd+K	Noms de manuels et titres de ressources
hiring_search_playbooks (agents)	Plein texte, classé, sur les titres, les contenus et les noms de manuels

La recherche fonctionne par mots-clés, pas par sens — « notation du compte rendu » trouve ces mots, pas une paraphrase.

Pour les agents IA

Quatre outils en lecture seule. Ils exigent un accès au Recrutement et la portée de lecture du Recrutement sur la connexion — rien de plus. Pour connecter un client, voir Agent IA et outils MCP.

Outil	Ce qu’il renvoie
hiring_list_playbooks	Tous les manuels avec leurs ressources : titre, type, id, slug et types d’étapes. Aucun contenu de document — c’est la carte.
hiring_get_playbook	Un manuel par id pbk_ ou slug, avec les contenus tronqués à 2 000 caractères et signalés comme tels.
hiring_read_resource	Une ressource par id rsc_ ou slug, en entier — le contenu complet, ou l’URL d’un lien.
hiring_search_playbooks	Les correspondances classées, avec un extrait mis en évidence et l’id rsc_ pour aller plus loin. Ces extraits restent partiels.

Cherchez ou listez d’abord, puis appelez hiring_read_resource pour tout ce qu’il vous faut en entier. hiring_get_playbook donne une vue d’ensemble d’un manuel ; sa troncature en fait donc un mauvais dernier appel avant qu’un agent réponde à une question précise.

Checklist

• Un manuel par type de recrutement, pas un par équipe
• Associez toute ressource procédurale aux types d’étapes qu’elle concerne
• Créez des liens vers le matériel déjà maintenu ailleurs ; ne rédigez des documents dans Kit que pour ce dont Kit est le lieu naturel
• Choisissez le bon type du premier coup — il ne pourra plus être changé
• Posez à votre assistant IA une question dont vous connaissez déjà la réponse, pour vérifier qu’il lit la bonne ressource