Arrêtez de vous répéter : pourquoi le Steering global est la couche de contexte IA qui vous manquait

Par
SA

Saurabh Dahal

Developer Advocacy

Vous avez dit à votre assistant IA 47 fois que vous préférez les composants React fonctionnels. 23 fois que vous utilisez Prettier avec des points-virgules. Et au moins 15 fois que vos fichiers de test vont dans des répertoires __tests__ , et non à côté du code source.

Ça vous semble familier?

Voici le vrai coût : ce n'est pas seulement agaçant—ça détruit votre productivité. Chaque fois que vous configurez un nouveau projet, vous passez 10 à 15 minutes à réexpliquer des préférences que vous avez déjà articulées des dizaines de fois. Pour un développeur qui travaille sur 20 projets par année, ça représente plus de 5 heures de pure répétition. Pour une équipe de 50 personnes? Ça représente 250 heures par année passées à copier-coller les mêmes normes d'un espace de travail à l'autre.

Et ça s'aggrave encore : quand le contexte n'est pas constant, votre code ne l'est pas non plus. Un projet reçoit vos normes de sécurité. Un autre les manque parce que vous avez oublié de coller ce fichier. Votre couverture de tests varie énormément. Votre style de code dérive. L'incohérence s'accumule en dette technique.

Si vous utilisez l'IA pour la programmation (et honnêtement, qui ne le fait pas en 2025?), vous avez frappé ce mur : chaque nouveau projet repart de zéro. L'IA ne se souvient pas de vos préférences, des conventions de votre équipe, ni des normes de votre entreprise. Vous êtes coincé à copier-coller les mêmes instructions dans chaque espace de travail, ou pire—à les retaper manuellement chaque fois.

C'est le problème que le Steering global de Kiro résout.

Pensez au Steering global de Kiro comme à votre .bashrc personnel pour le contexte IA—une configuration qui vous suit partout, prête quand vous en avez besoin, sans répétition. Écrivez vos préférences une fois, et elles deviennent le fondement de chaque projet que vous touchez. Pas de copie. Pas d'oubli. Pas d'incohérence.

L'impact? Les développeurs économisent des heures chaque mois. Les équipes atteignent la cohérence automatiquement. Les organisations appliquent des normes à grande échelle. Et surtout : votre assistant IA vous comprend enfin dès le premier jour, chaque fois.

Qu'est-ce que le Steering, au fond?

Avant de plonger dans le Steering global, faisons le point sur ce que le Steering fait réellement.

Le Steering est un contexte IA persistant. C'est un ensemble de fichiers markdown qui informent les agents IA de vos préférences, normes et décisions avant qu'ils commencent à travailler. Plutôt que d'expliquer les mêmes choses dans chaque conversation, vous l'écrivez une fois dans un fichier de Steering, et l'IA le lit automatiquement au moment de traiter vos demandes.

État actuel : le Steering d'espace de travail

En ce moment, Kiro utilise un Steering propre à l'espace de travail, stocké à :

Loading code example...

Cette approche fonctionne bien lorsque vous devez spécifier des préférences projet par projet. Mais voici le problème...

Mais voici le problème : la plupart de ce que vous dites à l'IA n'est pas propre à un projet.

Vos préférences de style de code sont les mêmes dans tous vos projets. Votre philosophie de test devrait être cohérente partout. Vous avez besoin de normes de sécurité universelles. Pourquoi devriez-vous répéter tout ça dans chaque espace de travail?

Voici le Steering global : votre couche de configuration IA personnelle

Le Steering global se trouve dans votre répertoire personnel :

Loading code example...

Il est persistant. Il est universel. Il vous suit partout.

Tout fichier markdown que vous placez ici devient accessible à Kiro dans tous vos projets, sauf s'il est explicitement remplacé au niveau de l'espace de travail.

Qu'est-ce qui appartient au Steering global?

Pensez à ce qui est constant dans votre travail, peu importe le projet :

🎨 Style de programmation personnel

Loading code example...

🧪 Philosophie de test

Loading code example...

🔒 Exigences de sécurité

Loading code example...

📝 Normes de documentation

Loading code example...

🏗️ Principes d'architecture

Loading code example...

Ce modèle définit comment vous travaillez, pas ce que vous construisez.

Scénario réel : développeur individuel

Laissez-moi vous montrer comment ça fonctionne en pratique.

Rencontrez Jane Doe

Jane est une développeuse pigiste full-stack qui travaille sur des projets clients avec React et Node, des contributions open source et des projets personnels. Chaque projet a une logique d'affaires différente, mais ses normes restent les mêmes.

La configuration du Steering global de Jane

Le dossier ~/.kiro/steering/ de Jane :

Loading code example...

Fichiers clés :

Loading code example...
Loading code example...

Steering propre à l'espace de travail

Maintenant, Jane démarre un nouveau projet client : une plateforme de commerce électronique. Ses fichiers de Steering propres au projet se trouvent à <project>/.kiro/steering/ :

Loading code example...
Loading code example...
Loading code example...

Comment tout ça fonctionne ensemble

Jane demande à Kiro : « Crée un nouveau composant ProductCard » :

Kiro lit :

  1. Le Steering global (~/.kiro/steering/) - style.md → Composants fonctionnels, paramètres Prettier - accessibility.md → HTML sémantique, exigences de texte alternatif - testing.md → Emplacement des fichiers de test et couverture
  2. Le Steering d'espace de travail (<project>/.kiro/steering/) - tech.md → Utilisation de Next.js, TypeScript, Tailwind - product.md → Structure des données produit et fonctionnalités - structure.md → Les composants vont dans src/components/

Ceci se traduira par Kiro générant un composant React fonctionnel avec TypeScript utilisant les classes Tailwind CSS, un HTML sémantique approprié et des attributs d'accessibilité, le plaçant dans le bon répertoire avec un fichier de test correspondant, tout en respectant le style de programmation de Jane, tout automatiquement.

Tout ça sans que Jane répète ses préférences.

Scénario d'équipe : normes à l'échelle de l'organisation

Maintenant, passons à plus grande échelle. Qu'arrive-t-il quand vous avez une équipe de 50 développeurs?

Rencontrez AnyCompany

AnyCompany compte 8 équipes de développement gérant plus de 30 dépôts actifs à travers des piles technologiques mixtes (React, Vue, Python, Go) avec des exigences strictes en matière de sécurité et de conformité.

Le défi : chaque développeur doit suivre les normes de l'entreprise, mais ils travaillent sur des projets différents avec des technologies différentes.

La stratégie de Steering global d'AnyCompany

Approches de déploiement

Les organisations ont une flexibilité dans la façon de distribuer les fichiers de Steering global à leurs équipes. La contrainte principale est que Kiro ne lit les fichiers de Steering global qu'à partir du répertoire ~/.kiro/steering/, mais les fichiers eux-mêmes peuvent provenir de n'importe où, par copie ou par lien symbolique.

Pour les équipes utilisant le contrôle de version, AnyCompany maintient un dépôt partagé contenant leurs fichiers de Steering à l'échelle de l'entreprise pour les politiques de sécurité, les exigences de conformité SOC2 et RGPD, les normes de révision de code, les procédures de garde, les exigences d'accessibilité et les lignes directrices de marque UI/UX. Les développeurs clonent ce dépôt lors de leur intégration et copient les fichiers directement dans ~/.kiro/steering/ ou créent des liens symboliques qui reflètent automatiquement les mises à jour lorsque le dépôt central change. Un script de configuration simple automatise ce processus, garantissant que chaque développeur obtient la même base sans copie manuelle.

Loading code example...

Pour les entreprises disposant d'outils de gestion des appareils mobiles comme Jamf ou Intune, le déploiement peut être entièrement automatisé. Les scripts MDM peuvent peupler directement ~/.kiro/steering/ en téléchargeant des fichiers depuis des serveurs internes, en définissant les permissions appropriées et en s'assurant que les fichiers requis restent présents. Autrement, le MDM peut déployer les fichiers vers un emplacement central comme /opt/company/kiro-steering/ et créer des liens symboliques vers ~/.kiro/steering/, ce qui offre des mises à jour centralisées tout en gardant les fichiers dans un emplacement géré. Cette approche offre une configuration zéro manuelle pour les développeurs, une gestion centralisée des politiques, des mises à jour automatiques lorsque les politiques changent, et une piste d'audit pour la conformité.

Loading code example...

Exemple d'équipe réelle : équipe front-end

L'équipe front-end d'AnyCompany ajoute sa propre couche :

Dépôt de Steering partagé par l'équipe (Front-end)

Loading code example...

Développeur individuel : John Doe

John est un développeur front-end chez AnyCompany. La configuration complète du Steering de John :

Loading code example...

Lorsque John demande à Kiro de construire quelque chose, Kiro lit les fichiers en donnant priorité au Steering d'espace de travail sur le Steering global. Le Steering d'espace de travail est propre au projet et a préséance en cas de conflit. Le Steering global comprend les préférences personnelles de John, les conventions d'équipe et les normes de l'entreprise, et est utilisé lorsqu'aucun remplacement d'espace de travail n'existe. Ainsi, John obtient automatiquement la conformité de sécurité de l'entreprise, les normes de l'équipe front-end partagées entre les projets, des préférences de flux de travail personnelles qui lui sont propres, et le contexte spécifique au projet de l'espace de travail actuel. Toutes ces couches fonctionnent ensemble de façon harmonieuse.

Scénario : développeur polyglotte

Un autre scénario est celui où vous travaillez sur plusieurs piles technologiques : développement frontend avec React et TypeScript, services backend utilisant Python et FastAPI, applications mobiles construites avec React Native, et infrastructure gérée par Terraform. Un problème courant à travers ces écosystèmes est que chacun a des conventions différentes, ce qui rend facile de se retrouver avec des pratiques incohérentes dans votre code source.

La solution montrée ci-dessous démontre comment vous pouvez spécifier des normes à travers différents langages de programmation, avec une implémentation adaptée à chaque langage. Maintenant, vos normes de test sont cohérentes, mais l'implémentation varie de façon appropriée selon le langage.

Solution de Steering global :

Loading code example...
Loading code example...

Lignes directrices générales pour le Steering

Ce qu'il ne faut PAS mettre dans le Steering

Vous ne devriez jamais inclure de clés API ou de secrets, d'identifiants de base de données, d'URL ou de points de terminaison internes, de données clients ou de RPI, ou d'algorithmes propriétaires (si vous prévoyez partager vos fichiers de Steering). C'est parce que les fichiers de Steering global sont du texte brut markdown, souvent partagé ou synchronisé, et ils ne sont pas chiffrés par défaut.

Ce qui est sécuritaire à inclure

Il est sécuritaire d'inclure des pratiques de sécurité générales, des modèles et préférences de code, des approches de test, des normes de documentation, des principes de conception d'API publique, et des choix de framework et de bibliothèque dans vos fichiers de Steering.

Pour commencer : votre premier fichier de Steering global

Prêt à essayer le Steering global et à le voir en action? Voici un exemple simple que vous pouvez suivre pour le constater par vous-même.

Étape 1 : Créez votre premier fichier

Choisissez ce que vous répétez le plus souvent. Pour la plupart des développeurs, c'est le style de programmation :

Loading code example...

Étape 2 : Testez-le

Ouvrez un nouveau projet dans Kiro et demandez : « Crée un nouveau composant » Kiro devrait suivre vos préférences de style depuis ~/.kiro/steering/style.md sans que vous les mentionniez.

Étape 3 : Développez graduellement

Ajoutez d'autres fichiers à mesure que vous découvrez des modèles répétés et construisez-le de façon organique en remarquant la répétition.

Loading code example...

Pour conclure

Maintenant que vous avez une façon plus efficace de travailler avec Kiro pour qu'il comprenne votre style et vos préférences globales grâce à l'utilisation du Steering global, la seule question qui reste est : quels fichiers de Steering global allez-vous commencer à appliquer à vos projets Kiro pour vous faire économiser des heures de temps et d'instructions répétitives? Créez votre premier fichier de Steering global dès aujourd'hui. Découvrez ce que c'est que de ne plus jamais vous répéter.

Qu'allez-vous mettre dans votre Steering global? Partagez votre configuration avec le mot-clic #codewithkiro ou identifiez @kirodotdev sur X, LinkedIn, ou Instagram, et @kiro.dev sur Bluesky.