Hyrax AI cartographie les dépôts dans un contexte Markdown persistant et mobilise six agents spécialisés pour produire des pull requests vérifiées et testées.
Fonction du produit et positionnement officiel
Hyrax AI fonctionne comme un architecte de base de code automatisé conçu pour les équipes d'ingénierie qui développent aux côtés d'outils d'IA. Installé sous la forme d'une GitHub App, le système analyse les structures de dépôts, les dépendances, les frontières et les conventions en vigueur, consignant le contexte actif directement dans les fichiers du dépôt comme HYRAX.md et le dossier .hyrax/discovery. Cette cartographie partagée sert de socle de référence tant pour les ingénieurs humains que pour les assistants de programmation externes.
Plutôt que d'appliquer des modifications globales et non validées à l'ensemble d'une base de code, Hyrax mobilise six agents spécialisés couvrant la sécurité, l'exactitude, la maintenabilité, les performances, l'architecture et les opérations. Les améliorations approuvées passent par une vérification dans une arborescence de travail isolée à l'aide des tests natifs, des vérifications de types et des étapes de build du dépôt. Hyrax s'arrête avant d'ouvrir une pull request en cas d'échec d'un seul contrôle et ne fusionne jamais les modifications de son propre chef.
Cas d’usage étayés par les sources officielles
Les équipes d'ingénierie connectent Hyrax via GitHub afin de générer et d'entretenir automatiquement des cartes d'architecture partagées, des catalogues de modèles et la documentation des variables d'environnement au sein du dépôt.
Les équipes lancent des audits portant sur la sécurité, la maintenabilité et les opérations pour repérer les failles de stockage de jetons, les modèles obsolètes et les problèmes de configuration, transformant les constats prioritaires en pull requests vérifiées.
Les développeurs exploitent l'intégration MCP d'Hyrax pour injecter en temps réel le contexte du dépôt et les conventions établies dans des outils de programmation assistés par IA tels que Cursor, Claude Code et Copilot.
Le parcours documenté, lorsqu’il est disponible
Connectez le dépôt à l'aide de la GitHub App Hyrax pour déclencher l'analyse initiale et générer HYRAX.md ainsi que les fichiers d'exploration.
Inspectez les problèmes, suggestions et avis produits sur les six dimensions d'ingénierie, puis sélectionnez les tâches approuvées à traiter.
Hyrax applique les modifications dans un worktree isolé, effectuant la validation avec les tests locaux, les linters, les builds et une nouvelle analyse du problème.
Un ingénieur humain examine la pull request GitHub obtenue ainsi que son diff avant d'approuver et de fusionner le code dans le dépôt.
Chaque pull request fusionnée déclenche l'actualisation de la cartographie du dépôt, synchronisant les changements récents dans HYRAX.md et les fichiers d'exploration.
Hyrax structure la gouvernance des dépôts autour d'artefacts persistants et de portes de vérification automatisées strictes. Une fois connectée à un dépôt, la plateforme génère le fichier HYRAX.md et des documents complémentaires dans .hyrax/discovery qui détaillent les frontières de modules, les flux de données, les occurrences de modèles et les variables d'environnement requises. Les notes d'ingénierie personnalisées placées entre les délimiteurs prévus à cet effet sont conservées lors des synchronisations ultérieures.
Avant qu'un correctif ou qu'une amélioration proposée n'apparaisse sous forme de pull request GitHub, la proposition doit franchir un pipeline de vérification automatisé. En opérant au sein d'une arborescence de travail isolée, le système établit la référence du dépôt, applique la modification en respectant les conventions locales et exécute les commandes de test, de vérification de type et de build définies dans la configuration du projet. Le système exige également de réussir les contrôles de linting, de respecter un plafond de taille de diff, de se soumettre à l'examen d'un agent indépendant et de terminer une nouvelle analyse confirmant la résolution du problème. Si un seul contrôle échoue, la tâche est abandonnée sans créer de pull request.
Vérifications à effectuer avec vos contenus et votre flux de travail
Sources vérifiées et date de la vérification
Réponses fondées sur la fiche produit dont les sources ont été vérifiées
Non. Hyrax ne fusionne jamais les pull requests de sa propre initiative ; chaque pull request générée nécessite la revue et l'approbation d'un ingénieur.
Six agents spécialisés évaluent les dépôts selon la sécurité, l'exactitude, la maintenabilité, les performances, l'architecture et les opérations.
Si une vérification requise échoue lors de la porte de vérification, le travail s'interrompt immédiatement et Hyrax n'ouvrira aucune pull request.
Toute l'inférence de l'IA s'exécute au sein du compte AWS Bedrock d'Hyrax, et le code des clients n'est en aucun cas utilisé pour entraîner des modèles d'IA.
Hyrax met à disposition un serveur MCP qui transmet en direct le contexte de la base de code à des outils tels que Cursor, Copilot et Claude Code.
