hirify-doc

Imported from Hirify/hirify-doc (AGENTS.md). Install upstream with npx skills add Hirify/hirify-doc. Copyright stays with the author.

Documentation Hirify — instructions

À propos

• Site de documentation Mintlify pour Hirify, plateforme d'entretiens de recrutement assistés par IA.
• Les pages sont des fichiers MDX avec frontmatter YAML. La configuration vit dans docs.json.
• Public visé : des recruteurs. L'application existe en français et en anglais. La documentation aussi : fr/ est la langue par défaut, en/ sa version anglaise, régie par la section English version en fin de fichier.

Règles absolues

Ces trois règles ont une raison d'être : les 23 pages générées le 27 août 2026 les violaient toutes, et ont dû être retirées.

1. Marque blanche stricte. Ne jamais nommer un fournisseur tiers — captation, transcription, modèle d'IA, téléphonie, hébergement, chat de support, plongements. On nomme la fonction : « la transcription », « l'analyse par IA », « le chat de support ». La liste nominative des sous-traitants est fournie avec le contrat de sous-traitance, jamais publiée ici.
2. Aucune affirmation invérifiable. Pas de tarif, de nom d'offre, de quota, de délai, de statistique ou de mécanisme produit qui ne soit pas vérifié dans le code de l'application. En cas de doute, décrire au lieu d'affirmer, ou omettre.
3. Aucune affirmation de conformité non sourcée. Hirify est sous-traitant ; la conformité RGPD est celle du client responsable de traitement. Ne jamais écrire « GDPR compliant », « ISO 27001 certified » ou « données jamais transférées hors de l'UE » sans source interne à l'appui.

Vocabulaire

Repris de l'interface, à ne pas traduire ni paraphraser : entretien, compte rendu, template, vivier, intervenant, analyse, signaux, assistant de réunion (le bouton s'appelle « Ajouter le bot »), Sourcing, Assistant, Pilotage, Fiabilité.

Ce que Hirify ne fait jamais : envoyer un message à un candidat, chercher des profils hors du vivier, décider à la place du recruteur.

Écritures vers le logiciel de recrutement — la distinction est à faire, toujours. Ne jamais écrire « Hirify n'écrit rien sans votre validation » : c'est faux.

• Le compte rendu et l'évaluation ne partent pas sans un geste du recruteur, sauf la publication automatique ci-dessous. L'envoi passe par le partage de l'analyse, depuis le panneau ATS de l'entretien, avec un aperçu et une confirmation.
• Un réglage envoie le compte rendu lui-même : Publier le compte rendu automatiquement envoie le compte rendu sur la fiche du candidat dès qu'il est prêt, sans relecture (auto_publish_analysis_job.ts), avec tout logiciel dont la connexion peut écrire le compte rendu. Avec la carte Hirify de Teamtailor sans clé Admin, il met seulement la carte à jour. Il n'ajoute jamais d'avis noté. Il est désactivé par défaut et activé par un administrateur ou un admin facturation.
• Deux automatismes écrivent d'eux-mêmes, si un administrateur ou un admin facturation les a activés : les tags de synthèse posés sur la fiche du candidat, et le remplissage des champs personnalisés restés vides — réversible depuis le panneau ATS, avec une notification. Les deux sont désactivés par défaut ; l'envoi automatique de l'assistant de réunion, lui, est actif par défaut.

Style

Ce qui trahit l'écriture automatique

Trois défauts relevés en relecture, à ne pas réintroduire.

Le point-virgule est proscrit. Aucun, nulle part. S'il sépare les éléments d'une énumération, passer en liste à puces. Sinon, couper en deux phrases.

Les virgules superflues. Pas de virgule avant « et » ou « ou » quand les deux membres partagent le sujet : « il lit vos postes et les remonte », pas « il lit vos postes, et les remonte ». Pas de virgule devant une subordonnée courte : « il capte l'entretien quel que soit le canal ». La virgule reste nécessaire devant « et » quand les propositions ont des sujets différents, et dans une énumération de trois éléments ou plus.

Les options s'énumèrent en puces, jamais en prose enchaînée. Nom en gras, deux-points, explication :

Vous avez le choix entre plusieurs fonctionnalités :

- **Coller un lien de réunion** : ajoutez simplement le lien de votre réunion pour lancer l'assistant.
- **Planifier par email** : invitez l'assistant de réunion directement depuis votre agenda.

Plus largement : pas de triplets rythmés (« court, clair et vérifiable »), pas d'incise entre virgules qui n'apporte rien, pas de « en effet » ni « par ailleurs » décoratifs.

Le reste

• Vouvoiement, voix active, phrases courtes, une idée par phrase.
• Titres en minuscule de phrase.
• Gras pour les éléments d'interface : cliquez sur Ajouter le bot.
• Une page = une tâche. Elle ouvre sur ce à quoi elle sert, enchaîne sur la procédure en <Steps>, se termine par « Bon à savoir ».
• Pas de mise en scène de l'IA, pas de langage marketing, pas de calcul de retour sur investissement.

Périmètre

Documentation destinée à l'utilisateur final. Ne rien documenter du back-office d'administration Hirify (/admin/**), des pages de développement, de l'architecture interne ou des outils de démonstration.

English version

The English pages under en/ carry the same facts as the French pages under fr/, written for an English-speaking recruiter. They are an adaptation, not a translation: keep the meaning, every fact and every limit, and write the sentence an English technical writer would write. The absolute rules above apply unchanged, including the distinction between the interview notes and evaluation (shared by a user action) and the ATS automations written on their own once an administrator or a billing admin turns them on: summary tags, empty custom fields, and the interview notes themselves through automatic publishing.

French stays the default language. When a French page changes, update its English counterpart in the same pull request.

Page map

The English slugs are English. The language switcher cannot pair pages by path, so this table is the pairing.

Links inside en/ point to /en/..., never to /fr/....

Interface labels

A bold label in an English page is the exact string the English interface shows. The strings live in the application repository, in inertia/locales/en/*.json and resources/lang/en/*.json. To find one, search the French label in the fr file of the same name and read the value at the same key in the en file. When no English string exists, describe the element in plain words, without bold, rather than inventing a label.

Vocabulary

The plan names stay Starter, Hub and Volume. Prices stay in euros, excluding VAT, copied from the French page and never converted.

Style

• US spelling, as in the interface: organization, analyze, customize.
• Second person, active voice, present tense. Short sentences, one idea each. Contractions are fine.
• Sentence case for titles and headings.
• Bold for interface labels. Options are listed as bullets, bold name, colon, explanation: - **Upload audio**: transcribe an interview you recorded elsewhere.
• No em dash and no semicolon. Use a period or a comma.
• Serial comma in a list of three or more: "interviews, notes, and templates".
• Sidebar groups and tabs: Welcome, Getting started, Record an interview, Interview notes and analysis, Connect your tools, Calling, Use your talent pool, Your account, Trust. Tabs: Documentation, Help (group Troubleshooting), What's new.
• No marketing words (seamless, powerful, effortless, unlock, streamline, leverage) and no rhetorical triplets.
• The frontmatter description says what the page covers, in plain words: "What Hirify does, what it doesn't, and where to start". It never starts with "You will".
• A pending screenshot is an MDX comment, as in the French pages: {/* SCREENSHOT: ... */}. The French captures show the French interface and are not reused in English pages.