specrails-core

Specrails Core est un framework CLI et de workflow d’agents en Node.js pour le développement logiciel piloté par des spécifications. Il installe des rôles de base — architecte, développeur et réviseur — dans un projet et expose des commandes natives aux fournisseurs pour Claude Code, Codex CLI, Gemini CLI et Kimi Code. Le flux prévu est : Spécification → Architecture → Implémentation → Révision → Livraison ; l’architecte produit une proposition OpenSpec, un design et des tâches, le développeur implémente le travail convenu, et le réviseur vérifie les résultats par rapport à la spécification et aux commandes de vérification du projet. Installation à partir d’un projet : npx specrails-core@latest init --provider claude (choisir claude, codex, gemini ou kimi). Non interactif : npx specrails-core@latest init --yes --provider claude. Les fournisseurs utilisent des commandes natives telles que /specrails:implement, $implement, et /skill:specrails-implement. L’intégration Kimi cible Kimi Code 0.27.0+ et utilise .kimi-code/specrails/run-skill.mjs pour l’activation en mode headless. Core 5 installe les rôles et les workflows directement sans invoquer un modèle pour une phase d’enrichissement. Les surfaces installées incluent les répertoires des fournisseurs (.claude, .codex, .gemini, .kimi-code), les spécifications openspec/ et les artefacts de changement, .specrails/config.yaml et install-config.yaml, .specrails/rules/ et agent-memory/, .specrails/runtime/ et pipeline/, un éventuel .specrails/local-tickets.json, et .specrails/profiles/. Les installations autonomes copient normalement les artefacts committables dans le dépôt et utilisent un magasin de framework partagé sous ~/.specrails/ ; les espaces de travail déplacés ou gérés par Desktop peuvent garder les liens du framework et les artefacts du projet en dehors du checkout. Les fichiers gérés peuvent être régénérés par des mises à jour ; les extensions utilisateur doivent utiliser les chemins documentés tels que .specrails/profiles/** et les rôles custom-*. Les mises à jour sont séparées du rafraîchissement de l’exécutable : npx specrails-core@latest update --dry-run, update, doctor. Les sélections de fournisseurs existantes sont préservées par l’implémentation actuelle de mise à jour ; la source actuelle rejette qu’un CLI plus ancien écrase un framework installé plus récent. La migration depuis Core 4 supprime la commande enrich, les niveaux d’installation rapide/complète et les agents spécialistes non-core intégrés ; les agents personnalisés doivent être déplacés dans des rôles custom-* protégés et les références de profil mises à jour. Un runtime d’agent programmable en opt-in est inclus : un workflow LangGraph partagé avec des fournisseurs par rôle, une récupération durable et des modèles locaux compatibles OpenAI, exposé via une API TypeScript et un CLI. La livraison automatique autonome peut créer des branches, des commits, des pushs et des pull requests lorsqu’elle est activée ; les pull requests GitHub nécessitent un CLI gh authentifié. Les hôtes tels que Specrails Desktop peuvent définir SPECRAILS_GIT_AUTO=false et posséder les worktrees et la livraison. Les contextes multi-dépôts doivent identifier explicitement les dépôts sélectionnés et le propriétaire de l’OpenSpec/backlog. La configuration, les spécifications et l’état d’exécution sont des fichiers locaux, mais les CLI des fournisseurs envoient le contexte fourni aux services de modèle configurés, et l’installation de package, les intégrations GitHub/Jira et MCP peuvent utiliser le réseau. L’utilisation du modèle est facturée par le fournisseur. Le projet est sous licence MIT et nécessite Node.js 20.19.0+ avec Git et au moins un CLI d’IA authentifié ; le développement à partir de la source utilise les commandes npm ci, npm test, npm run build, typecheck et coverage.