Que fait ai-delivery-spec ?
Cadre de développement piloté par spécifications côté produit — PRD, prototype interactif, transfert DDD, gouvernance d'exécution IA, portes d'acceptation. Niveaux L0 à L3, modules de domaine remplaçables. Fonctionne avec Claude Code, Cursor, Codex, OpenClaw.
Aperçu
Ce référentiel implémente un cadre de développement piloté par les spécifications (Spec-Driven Development) permettant aux équipes produit et aux développeurs de :
- Rédiger des Documents de Spécification Produit (PRD) clairs et structurés
- Créer des prototypes interactifs alignés sur les spécifications
- Assurer un transfert efficace vers le DDD (Domain-Driven Design)
- Appliquer une gouvernance d'exécution IA pour vérifier la conformité
- Définir des portes d'acceptation formelles pour chaque niveau de maturité
Niveaux L0 - L3
| Niveau | Description | Utilisation typique |
|---|---|---|
| L0 | Spécification simple, pas de validation | Idéation rapide, wireframes |
| L1 | Spécification + tests de conformité automatiques | MVP, itérations courtes |
| L2 | Spécification + tests + intégration pipeline | Projets avec QA automatisé |
| L3 | Spécification + tests + pipeline + gouvernance IA | Production critique, conformité réglementaire |
Modules de domaine
Les modules de domaine sont conçus pour être remplaçables. Vous pouvez échanger :
- Moteur de spécification (
spec-engine/) - Interprète et valide les PRD - Générateur de prototypes (
prototype-gen/) - Crée des maquettes interactives - Adaptateur DDD (
ddd-adapter/) - Traduit les spécifications en artefacts DDD - Gouverneur IA (
ai-governor/) - Surveille l'exécution et vérifie la conformité
Démarrage rapide
# Cloner le dépôt
git clone https://github.com/franklinxkk/ai-delivery-spec.git
# Installer les dépendances
cd ai-delivery-spec
npm install
# Configurer les variables d'environnement nécessaires
cp .env.example .env
# Editer .env avec vos clés API (CLAUDE_API_KEY, OPENAI_API_KEY, etc.)
# Lancer le mode interactif pour un niveau L0
npm run spec:l0
Utilisation avec les assistants IA
Ce framework est compatible avec :
- Claude Code - Utiliser la commande
/specpour charger un PRD - Cursor - Profitez de l'intégration directe dans l'éditeur
- Codex - Via l'API REST pour des pipelines automatisés
- OpenClaw - Supporté par le plugin dédié
Structure du projet
ai-delivery-spec/
├── spec-engine/ # Moteur de spécification
├── prototype-gen/ # Générateur de prototypes
├── ddd-adapter/ # Adaptateur DDD
├── ai-governor/ # Gouverneur IA
├── examples/ # Exemples de PRD complets
├── tests/ # Tests unitaires et d'intégration
└── docs/ # Documentation utilisateur
Licence
MIT