Configuration
Essayer un plugin
Le plugin Engineering est fourni avec /documentation comme point de départ, déjà structuré pour se déployer à travers les sources connectées, citer ce qu'il trouve, et nommer un propriétaire lorsqu'il n'est pas sûr. Si votre administrateur gère les plugins et qu'il n'est pas encore disponible, ignorez cette étape ; rien ci-dessous n'en a besoin.
/documentationWrite and maintain technical documentation./architectureCreate or evaluate an architecture decision record (ADR).Connectez vos outils
Claude Cowork est plus puissant lorsqu'il fonctionne directement avec vos systèmes. Vous contrôlez les autorisations et l'accès. En savoir plus sur l'accès aux outils(s’ouvre dans un nouvel onglet).
Accédez à Personnaliser → Connecteurs dans Cowork pour configurer.
'%20d='M.87%2018.26c-.25.4-.52.87-.75%201.23a.75.75%200%200%200%20.25%201.02l4.96%203.05a.75.75%200%200%200%201.04-.25c.2-.33.45-.76.73-1.21%201.95-3.22%203.91-2.83%207.45-1.14l4.92%202.34a.75.75%200%200%200%201-.36l2.36-5.34a.75.75%200%200%200-.38-.98c-1.04-.49-3.1-1.46-4.96-2.36-6.68-3.24-12.36-3.03-16.62%204Z'/%3e%3cpath%20fill='url(%23cfB)'%20d='M23.13%205.74c.25-.4.52-.87.75-1.23a.75.75%200%200%200-.25-1.02L18.67.44a.75.75%200%200%200-1.04.25c-.2.33-.45.76-.73%201.21-1.95%203.22-3.91%202.83-7.45%201.14L4.53.7a.75.75%200%200%200-1%20.36L1.17%206.4a.75.75%200%200%200%20.38.98c1.04.49%203.1%201.46%204.96%202.36%206.68%203.24%2012.36%203.03%2016.62-4Z'/%3e%3c/svg%3e)
Définissez votre dossier de travail
Faites glisser les fichiers qui ancrent l'agent (votre export de catalogue de services, l'annuaire de l'équipe, le glossaire, le document d'intégration « où trouver les choses ») dans un seul dossier et pointez Cowork vers celui-ci. Ceux-ci deviennent la table de routage que l'agent consulte avant de chercher ailleurs. Créez un projet Cowork(s’ouvre dans un nouvel onglet) à partir de ce dossier afin que le catalogue et les règles de base restent attachés à mesure que l'agent évolue.
Le prompt
Copiez ceci dans Claude Cowork
Créez un agent interne « demandez n'importe quoi » pour les ingénieurs. Lorsque quelqu'un demande « comment obtenir une clé API de staging », « qui possède la table des commandes » ou « pourquoi les déploiements ont-ils ralenti le mois dernier », trouvez la réponse à travers nos systèmes, citez la source, et indiquez-leur à qui demander si vous n'êtes pas sûr. Obtenez d'abord une bonne réponse, puis transformez-la en compétence partagée.
Pourquoi cela fonctionne
Donnez un exemple pour chaque type de question. Un « comment faire », une recherche de propriétaire, un « pourquoi » métrique : cela couvre les types de questions que les ingénieurs posent réellement.
Citez la source, à chaque fois. Les ingénieurs font confiance au lien, pas à la prose ; les citations rendent la réponse vérifiable.
Nommez un propriétaire en cas d'incertitude. Demander « l'équipe ou le canal propriétaire » donne à Claude quelque chose sur quoi se rabattre lorsqu'il n'est pas confiant. Vous obtenez un point de contact à suivre plutôt qu'une supposition à vérifier.
Placez les documents de référence dans le dossier de travail. Le catalogue de services et l'annuaire de l'équipe indiquent à Cowork où chercher et vers qui se tourner.
Obtenez une meilleure ébauche
Ajoutez un exemple correspondant. Déposez un exemple que vous aimez dans le dossier et Cowork adaptera sa structure et son ton aux vôtres.
Demandez-lui de signaler l'incertitude. Ajoutez « signale tout ce dont tu n'es pas sûr » afin de savoir où regarder en premier lorsque vous examinez l'ébauche.
Faites travailler Cowork pour vous
Le /documentation du plugin est un point de départ générique. Une fois que l'étape 2 répond bien à vos trois questions, demandez à Cowork d'écrire votre version de la compétence. Ajoutez les espaces et dépôts à rechercher en premier, le seuil du « je ne suis pas sûr », le ton, et les systèmes qui sont interdits. Quelques minutes de conversation et la compétence parle votre stack à partir de là.
Transforme ce que nous avons fait dans cette tâche jusqu'à présent en une compétence, ou modifie la compétence /documentation avec mes retours.
Rendez-le reproductible
Partagez-le en tant qu'artefact
Une fois que l'agent répond bien à vos questions de test, publiez-le en tant qu'artefact afin que toute personne de l'organisation dispose d'un seul lien pour poser ses questions. L'artefact exécute la compétence partagée en arrière-plan ; l'équipe plateforme possède la compétence et continue de l'affiner.
Enregistrez chaque question à laquelle il n'a pas pu répondre
L'agent s'améliore lorsque vous savez où il est en défaut. Tapez /schedule ou ouvrez Planifié dans la barre latérale de Cowork, et une exécution hebdomadaire écrit les questions sans réponse dans votre dossier afin que l'équipe plateforme puisse combler les lacunes.
/schedule Chaque vendredi à 16h, liste les questions auxquelles /documentation n'a pas pu répondre avec confiance cette semaine, regroupe-les par sujet, et écris-les dans Platform/ask-company/gaps-<week>.md avec un propriétaire suggéré pour chacune.
Chaque semaine, liste les questions auxquelles l'agent n'a pas pu répondre, les regroupe par sujet, et rédige un rapport des lacunes avec des propriétaires suggérés.
Partagez avec vos coéquipiers
Votre /documentation personnalisée porte désormais vos sources, votre table de routage et vos règles de confiance. Partagez-la à l'échelle de l'espace de travail afin que chaque ingénieur interroge l'entreprise de la même manière, et que la réponse à « comment est-ce que je… » ne dépende plus de qui se trouve dans le canal.