Votre agent de code lit
la documentation que votre équipe a déjà écrite.
16 outils, retenus par portée
Chaque outil délègue à un cas d'usage que le produit avait déjà : il n'y a donc ni second chemin d'accès ni second jeu de règles. Une clé en lecture seule ne voit pas du tout les outils d'écriture — l'appel n'est pas simplement refusé.
readTout ce dont un agent a besoin pour trouver et comprendre ce que votre équipe a déjà écrit.- list_projects
- Les projets que cet identifiant peut lire, avec des décomptes et une URL qu'une personne peut ouvrir.
- list_repositories
- Les projets avec leurs repositories imbriqués, plus ce que l'identifiant est autorisé à atteindre — un projet qui ne vous a pas été accordé se distingue donc d'un projet inexistant.
- list_tree
- L'arborescence des dossiers d'un repository. La forme de l'arbre est la façon dont l'équipe organise ce qu'elle sait.
- list_documents
- La carte du corpus : chaque document lisible avec son titre, une ligne sur ce qu'il couvre, son URL de lecture et son état de relecture.
- search_docs
- Recherche plein texte dans chaque repository accessible en une seule requête, chaque résultat portant une URL, une uri de ressource et son statut.
- read_doc
- Le markdown brut d'un document tel qu'il est stocké. Aucune requête à GitHub ou GitLab, donc rien n'est décompté de la limite de débit du repository.
- read_changes
- Le diff entre la version qu'une personne a validée et le texte actuel — pour qu'un avertissement de décalage se traite au lieu de se deviner.
- list_notes
- Les retours ouverts laissés par une personne, avec le titre concerné et l'indication qu'ils visent ou non une version antérieure.
- list_artifacts
- Les artifacts écrits dans un projet : chemin, titre, version actuelle et date de dernière modification.
- read_artifact
- Le contenu actuel d'un artifact. L'écriture n'accepte pas de patch, donc réviser un artifact suppose de le lire d'abord.
- list_tickets
- marketing.data.mcp-tool.list_tickets
- read_handbook
- Lit le Handbook du projet : ce que fait le produit aujourd'hui, approuvé par une personne, sans rien qui ne soit pas construit.
bundleDes dossiers entiers, nettoyés et comptés, en un seul bloc de texte.- bundle_docs
- Plusieurs documents concaténés et nettoyés — front matter et badges retirés, liens réécrits — avec une estimation en tokens.
write_artifactsAccordée séparément, et limitée à l'espace de noms des artifacts. Une clé en lecture seule ne voit pas du tout ces outils.- write_artifact
- Dépose un document markdown dans l'espace de noms des artifacts d'un projet, versionné, avec une URL qu'une personne peut ouvrir. Il ne peut jamais atteindre un document du repository.
- reply_to_note
- Répond à une note par d'accord, en désaccord, demande une clarification ou traité. Un désaccord typé est un état de workflow que l'on peut compter.
- report_implementation
- Indique que le travail a commencé, ou qu'il existe. Une preuve est requise et enregistrée comme note. Cela consigne une affirmation, jamais un achèvement.
Quatre choses qu'aucun tool ne peut faire
Des absences, pas des réglages. Aucun drapeau n'active l'une d'elles, et c'est tout l'intérêt — une permission qu'un administrateur peut accorder est une permission que quelqu'un finit par accorder.
Aucun tool ne modifie un document du repository
Pas un seul. Un agent écrit dans l'espace de noms des artifacts ou nulle part ; rien sur cette surface ne peut atteindre un fichier géré par le worker de synchronisation, changer une branch ou repointer une racine de documentation.
Aucun agent ne peut fermer une note
Une réponse fait passer une note à « en attente de confirmation », au plus. Il n'existe aucun outil de résolution, quel que soit l'argument, et aucune réponse ne change un statut. Seule une personne clôt un retour.
Aucun agent ne peut supprimer un artifact
Il n'existe aucun outil de suppression. Le rôle d'un identifiant d'écriture est de produire, pas de se débarrasser d'apports humains — y compris de ses propres brouillons antérieurs, qui conservent leurs versions.
Aucune question en texte libre sur la surface
Un agent peut poser une question proposée par le résumé actuel, et rien d'autre. Sans ce garde-fou, une clé est un canal non validé, financé par l'organisation, vers un modèle tiers.
Un agent peut affirmer qu'un retour a été traité. Seule une personne peut le clore.
C'est la phrase pour laquelle une équipe adopte le produit, et c'est une fonction avec un test plutôt qu'une politique dans un document.
- Agent
search_docs« idempotency » dans 6 repositories · 3 résultats
- 01AgentLit ce que l'équipe a déjà écritsearch_docs sur chaque repository qu'il peut atteindre, puis read_doc pour ceux qui comptent. Rien de collé dans un prompt, rien de périmé.
- 02AgentDépose ce qu'il a produitwrite_artifact dépose une spécification, un plan de migration ou une revue dans le projet à côté de la documentation, versionnés, avec une URL qu'une personne peut ouvrir.
- 03PersonneObjecte, sur un titreUn relecteur laisse une note ancrée à la section qu'elle concerne. L'agent la voit via list_notes, avec la version sur laquelle elle a été écrite.
- 04AgentRépond — et peut être en désaccordd'accord, en désaccord, demande une clarification, ou traité. Un désaccord typé est une file qu'un responsable ouvre le lundi ; une transcription, personne ne la lit deux fois.
- 05PersonneLa ferme, ou nonDans tous les cas, la note attend un humain. C'est l'asymétrie pour laquelle toute cette couche existe, et elle est imposée par une seule fonction.
On peut dire à un identifiant quels documents existent
Fixez un état de relecture minimum sur une clé et tout ce qui est en dessous répond 404 à chaque porte — ni filtré, ni grisé.
Le seuil est porté par l'identifiant plutôt que par un argument d'outil, et c'est tout le principe : un filtre que l'agent transmet est un filtre qu'un prompt peut le convaincre de ne pas transmettre. Il s'applique aussi aux routes du lecteur, car un seuil qui s'arrête à une surface est un seuil avec une seconde porte d'entrée.
Deux conséquences ressemblent à des bugs et n'en sont pas. Un document que personne n'a trié n'a aucun statut, donc un seuil validé sur un corpus non trié n'admet rien — la console vous le dit avant que vous n'émettiez la clé. Et rejeté n'est pas un échelon bas de l'échelle : cela veut dire « ne construisez pas ceci », donc tout seuil au-dessus de brouillon l'exclut au lieu de le classer en dernier.
- Appartient à
- L'organisation, jamais la personne qui l'a émise.
- Atteint
- Exactement un projet. Il n'existe pas de clé à l'échelle de l'organisation.
- Portées
- read, bundle, write_artifacts — choisies à l'émission.
- Seuil de relecture
- Facultatif, et refusé sur une clé qui peut écrire.
- Stockée sous forme de
- Une empreinte. La valeur s'affiche une fois, puis plus jamais.
- Révocation
- Prend effet dès la requête suivante — rien ne met la vérification en cache.
Donnez à votre agent la documentation plutôt que le prompt.
Les outils de lecture sont inclus dans tous les plans, y compris Free. Limités en débit, jamais facturés à l'usage.
Commencer gratuitement