Chargement

Rédiger le document de conception ou la RFC

Une proposition structurée avec les travaux antérieurs et les compromis déjà renseignés.

10 minIngénierieClaude Cowork
Chargement

Configuration

Essayer un plugin

Le plugin Engineering est fourni avec /system-design comme point de départ, déjà structuré pour remplir un modèle de RFC et rechercher les travaux antérieurs dans votre wiki. Si votre administrateur gère les plugins et qu'il n'est pas encore disponible, ignorez cette étape ; rien de ce qui suit n'en dépend.

EngineeringStreamline engineering workflows — standups, code review, architecture decisions, incident response, and technical documentation. Works with your existing tools or standalone.
Ajouter
/system-designDesign systems, services, and architectures.
Ouvrir dans Cowork
/architectureCreate or evaluate an architecture decision record (ADR).
Ouvrir dans Cowork

Connecter 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.

Accédez à Personnaliser → Connecteurs dans Cowork pour configurer.

Confluence
Recherchez les RFC et pages d'architecture antérieures et rédigez le nouveau document directement dans votre espace d'ingénierie. L'accès à Confluence se fait via le connecteur Atlassian Rovo (Jira et Confluence).
Connecter
GitHub
Lisez le code pertinent et les ADR passés afin que la proposition fasse référence au système tel qu'il est réellement.
Connecter
NotionFacultatif
Récupérez le modèle de RFC et publiez le brouillon dans votre base de données de revue de conception.
Connecter

Définir votre dossier de travail

Faites glisser les fichiers que vous utiliserez (votre modèle de RFC, la note d'une page ou les notes que vous avez déjà rédigées, les RFC antérieures associées, le diagramme d'architecture du service) dans un seul dossier et pointez Cowork vers celui-ci. Cowork y lit les fichiers et y réécrit le brouillon, le tableau des alternatives et le diagramme. Créez un projet Cowork à partir de votre dossier RFC afin que votre modèle, votre liste de vérification de revue et les conventions de rédaction de votre équipe restent associés.

RFCs / 0087-streaming-events
rfc-template.mdJan 4, 20262 KB
notes-streaming-migration.mdApr 24, 20265 KB
current-pipeline-diagram.pngMar 11, 2026142 KB
Dans la barre de discussion de Cowork’s :RFCs / 0087-streaming-events

Le prompt

Copiez ceci dans Claude Cowork

Rédigez un document de conception pour faire passer notre pipeline d'événements du traitement par lots au streaming. Recherchez les travaux antérieurs et les contraintes d'architecture, puis rédigez la proposition dans notre modèle de RFC : problème, objectifs et non-objectifs, deux ou trois approches avec leurs compromis, la recommandation, et les questions ouvertes. Je remplirai les parties que je suis seul à connaître.

RFCs / 0087-streaming-events

Pourquoi cela fonctionne

Invite

Demandez explicitement les travaux antérieurs. Cowork effectue une recherche dans votre wiki et vos RFC passées afin que le document cite ce qui a déjà été tenté.

Invite

Imposez deux ou trois approches. Vous obtenez un véritable tableau de compromis, et non un argumentaire commercial pour la première idée venue.

Invite

Indiquez quelles parties vous remplirez. Cowork se charge de la structure et des recherches ; vous consacrez votre temps au véritable jugement à porter.

Source

Donnez-lui votre modèle à suivre. Le résultat suit vos sections et vos titres, afin que les relecteurs retrouvent la structure qu'ils attendent.

Obtenir un meilleur brouillon

Pratiquer

Ajoutez un exemple à reproduire. Déposez un exemple que vous appréciez dans le dossier et Cowork adoptera votre structure et votre ton.

Pratiquer

Demandez-lui de signaler les incertitudes. Ajoutez « signale tout ce dont tu n'es pas sûr » afin de savoir par où commencer votre relecture du brouillon.

Faites en sorte que Cowork travaille pour vous

Une Compétence de plugin est un point de départ — personnalisez-la avec vos propres pratiques et votre expertise. Quelques minutes de conversation suffisent pour qu'elle fonctionne ensuite selon vos standards.

Transforme ce que nous avons fait jusqu'à présent dans cette tâche en une Compétence, ou modifie la Compétence /system-design avec mes retours.

RFCs

Rendez-le reproductible

Exécutez-le à partir de n'importe quelle note d'une page

Les documents de conception commencent souvent par un paragraphe dans un fil Slack ou un fichier de notes. Tapez /schedule ou ouvrez Planifié dans la barre latérale de Cowork, et la Compétence personnalisée surveille votre dossier RFCs/inbox et transforme toute nouvelle note d'une page en un premier brouillon structuré.

/schedule En semaine à 9h, vérifie RFCs/inbox pour les nouvelles notes d'une page, exécute /system-design sur chacune d'elles, et écris le brouillon structuré dans un dossier numéroté sous RFCs/.

RFCs
Tâche planifiéeActif
De la boîte de réception des RFC au brouillon

En semaine à 9h, récupère les nouvelles notes d'une page depuis RFCs/inbox, exécute /system-design avec recherche des travaux antérieurs, et écrit un brouillon structuré dans un dossier RFC numéroté.

en semaine à 9h00Ouvrir dans Cowork

Partagez avec vos coéquipiers

Votre /system-design personnalisé intègre désormais votre modèle, vos sources de travaux antérieurs et les questions récurrentes de vos relecteurs. Partagez-le afin que la RFC de chaque tech lead arrive sous la même forme, et que la revue d'architecture consacre son temps à la décision plutôt qu'à la mise en forme.

Ce qui change pour la revue de conception