Glossaire
Un guide de référence pour les termes que vous rencontrerez dans SpecForge — écrit pour être compris par tous, pas seulement les développeurs.
Spec
Une spec (abréviation de spécification) est un plan court pour une fonctionnalité ou un changement que vous souhaitez développer. Considérez-la comme un contrat entre vous et votre IA : elle décrit quoi construire, comment ça doit fonctionner, et à quoi ressemble un travail terminé.
Exemple : Une spec pour "connexion Google" listerait : configurer les identifiants OAuth, ajouter un bouton de connexion, stocker la session utilisateur, rediriger après la connexion. Votre IA lit cela et suit les étapes une par une.
Liste de vérification (Done Checklist)
Chaque spec a une liste de vérification — une liste de conditions qui doivent toutes être vraies avant que la fonctionnalité soit considérée comme terminée. Elle supprime l'ambiguïté : au lieu de "ça marche à peu près", vous savez exactement quelles cases sont cochées et lesquelles ne le sont pas.
Dérive (Drift)
La dérive se produit quand le code que vous avez développé ne correspond plus à la spec sur laquelle vous vous étiez mis d'accord. C'est normal — les exigences changent, des raccourcis sont pris, les idées évoluent. SpecForge détecte la dérive et vous indique exactement ce qui s'est éloigné du plan initial.
Pourquoi c'est important : Sans détection de dérive, vous pourriez croire qu'une fonctionnalité est terminée alors que des parties essentielles manquent ou ont changé.
Serveur MCP
Un serveur MCP est un plugin qui étend votre outil IA (comme Claude, Cursor ou Windsurf) avec de nouvelles capacités. SpecForge fonctionne comme un serveur MCP directement sur votre machine — votre IA peut appeler ses outils pour créer des specs, valider du code, détecter des dérives, et bien plus encore.
Analogie : Pensez-y comme une extension de navigateur, mais pour votre assistant de développement IA.
DDSpec (Développement Dirigé par les Specs)
Le DDSpec est une approche de développement où chaque fonctionnalité commence par une spec claire avant qu'une seule ligne de code soit écrite. La spec devient la source de vérité unique — votre IA la suit, et vous validez par rapport à elle une fois le travail terminé.
Contraste avec : le développement ad hoc, où vous décrivez ce que vous voulez dans le chat et espérez que l'IA le comprendra correctement.
Projet
Dans SpecForge, un projet est un dossier sur votre ordinateur que vous avez initialisé avec SpecForge. Chaque projet obtient un identifiant unique et stocke toutes ses specs, décisions et métriques localement — aucun cloud requis.
Stream
SpecForge organise ses 59 outils en 8 streams (de A à H). Chaque stream regroupe des outils qui font des choses similaires : planification, analyse, conception, livraison, etc. Vous n'avez pas besoin de connaître les 59 — juste le stream pertinent pour ce que vous faites.
Validation
La validation consiste pour SpecForge à lire votre code et à le vérifier par rapport à la liste de vérification d'une spec. Elle vous indique quels éléments sont complets, lesquels manquent, et ce qui a changé par rapport au plan initial.
Quand l'utiliser : Après que vous (ou votre IA) pensez qu'une fonctionnalité est terminée.
Critères d'acceptation
Les critères d'acceptation sont les conditions précises qui doivent être vraies pour qu'une spec soit considérée comme terminée. Ce sont les éléments de la liste de vérification. Chaque critère est concret et testable — non pas "la connexion doit fonctionner", mais "l'utilisateur est redirigé vers /tableau-de-bord après une connexion réussie."
Initialisation
Initialiser un projet signifie indiquer à SpecForge votre dossier de projet pour qu'il puisse analyser votre base de code, détecter votre langage et votre framework, et configurer le stockage local pour vos specs. Cela prend quelques secondes et ne doit être fait qu'une seule fois par projet.
Modèle (Pattern)
Un modèle est une solution récurrente que SpecForge a apprise de votre projet. Avec le temps, SpecForge peut reconnaître des approches courantes dans votre base de code et les suggérer lors de la création de nouvelles specs — pour que votre IA construise de manière cohérente.
Dette technique (Tech Debt)
La dette technique désigne le travail qui a été différé ou les raccourcis pris pendant le développement. Dans SpecForge, les éléments de dette technique sont suivis séparément dans le fichier de progression d'une spec — ils ne bloquent pas une spec d'être "terminée", mais ils sont enregistrés pour que rien ne soit oublié.
Un terme que vous souhaiteriez voir ajouté ? Laissez un commentaire ci-dessous ou contactez-nous sur npm.