spec-gatekeeper

Mène un entretien développeur ciblé de 4 questions et rédige un SPEC.md déterministe en 4 sections avant d'écrire le code source.

Qu'est-ce que spec-gatekeeper ?

Spec-Gatekeeper est un agent de développement piloté par spécifications (SDD) qui garantit que toute implémentation de code commence par un contrat architectural structuré et approuvé. Avant toute écriture de code, il interroge le développeur sur quatre axes critiques : la portée et la sécurité, les contrats de données, les cas limites et les critères d'acceptation. Il génère ensuite un fichier SPEC.md d'au moins 300 octets dans la racine du projet, avec des sections canoniques dédiées. Ce workflow s'applique à tout nouvel outil ou éditeur prenant en charge les agents AI (Claude Code, Cursor, Codex, etc.) et réduit les dérives fonctionnelles en exigeant une relecture et une validation humaine avant de débloquer les écritures de code source. L'agent vérifie automatiquement que le fichier de spécification respecte la taille minimale et contient les rubriques requises.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dansierrasam79/spec-gatekeeper/tree/main/skills/spec-gatekeeper

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Spec-Gatekeeper : Workflow de développement piloté par spécifications

Utilisez cette compétence chaque fois qu'une écriture de code source est bloquée par spec-gatekeeper, ou lorsque vous démarrez une nouvelle fonctionnalité, un nouveau service ou une refonte majeure.

Le développement piloté par spécifications (SDD) assure la clarté et élimine les dérives en exigeant un contrat architectural structuré et approuvé avant l'implémentation.


Étapes du workflow

Étape 1 : Mener l'entretien développeur en 4 questions

Avant d'écrire du code ou de créer des fichiers, posez au développeur les 4 questions ciblées suivantes (ou extrayez les réponses des exigences existantes et demandez confirmation) :

  1. Portée & Sécurité :

    • Quels sont les objectifs principaux et les non-objectifs explicites de cette tâche ?
    • Quels composants architecturaux ou limites système sont impliqués ?
    • Quelles sont les contraintes de sécurité, permissions, authentification ou sandbox ?
  2. Contrats de données :

    • Quels sont les schémas exacts, les interfaces API, les types et les formats de protocole ?
    • Quels sont les paramètres d'entrée précis et les charges utiles de sortie attendues ?
  3. Cas limites & Résilience :

    • Quels sont les principaux modes de défaillance, interruptions réseau/E-S et entrées malformées ?
    • Quels mécanismes de gestion d'erreur, validation et repli doivent être en place ?
  4. Critères d'acceptation :

    • Quelle matrice de vérification déterministe et quels cas de test définissent la complétude ?
    • Comment chaque critère d'acceptation sera-t-il validé ?

Étape 2 : Rédiger SPEC.md

Créez ou mettez à jour SPEC.md à la racine résolue du projet (<repo_root>/SPEC.md).

Structure requise

Le fichier de spécification doit satisfaire :

  1. Exigence de taille : Au moins 300 octets UTF-8 de contenu substantiel.
  2. Titres de sections canoniques : Des titres Markdown de niveau 1 à 3 en dehors des blocs de code correspondant à chacune des 4 sections requises :
    • Portée & Sécurité : Titres contenant Scope, Security, Architecture, Overview, Boundaries, Threat Model ou Permissions.
    • Contrats de données : Titres contenant Data Contract, Data Contracts, Schema, Schemas, Interface, Interfaces, API, Types, Payload ou Protocol.
    • Cas limites : Titres contenant Edge Case, Edge Cases, Error Handling, Failure Mode, Failure Modes, Resilience, Constraints ou Fallbacks.
    • Critères d'acceptation : Titres contenant Acceptance Criteria, Acceptance Test, Test Matrix, Verification, Testing, Definition of Done ou Validation.

Modèle

# Spécification : <Nom de la fonctionnalité ou du service>

## 1. Portée & Sécurité
### Objectifs & Limites architecturales
- Description détaillée de la portée...
### Sécurité & Modèle de menace
- Vérifications de permissions et limites de sécurité...

## 2. Contrats de données
### Schémas & Interfaces
- Types, signatures API, formats requête/réponse...

## 3. Cas limites & Résilience
### Gestion d'erreur & Replis
- Conditions limites, validation d'entrée, modes de défaillance...

## 4. Critères d'acceptation
### Vérification & Matrice de test
- CA-01 : ...
- CA-02 : ...

Étape 3 : Validation développeur & Implémentation

  1. Présentez le brouillon SPEC.md au développeur pour révision et approbation explicite.
  2. Une fois SPEC.md validé et respectant les contraintes (>= 300 octets avec les 4 sections), le hook spec-gatekeeper autorisera automatiquement l'écriture des fichiers d'implémentation.

Skills associés