claude-code-ultimate-guide/docs/resource-evaluations/sylvain-chabaud-spec-to-code-factory.md

Resource Evaluation: Spec-to-Code Factory

Resource: https://github.com/SylvainChabaud/spec-to-code-factory LinkedIn: https://www.linkedin.com/posts/sylvain-chabaud-831415aa_ia-claudecode-ai-activity-7430257228928163840-jOxD Author: Sylvain Chabaud (Ingénieur & formateur — WEB, Système embarqué) Published: 2026-01 (repo ~4 weeks old at evaluation time) Evaluation Date: 2026-02-19 Evaluator: Claude Code Ultimate Guide Team Score: 3/5 (Pertinent — Mention ciblée)

---

Summary

Pipeline multi-agents open-source entièrement construit sur Claude Code, qui transforme un requirements.md en projet livrable via 4 phases séquentielles et 6 gates de validation outillées.

Points clés :

• Méthodologie BREAK → MODEL → ACT → DEBRIEF avec 6 gates (Gate 0-5)
• Deux invariants absolus vérifiés automatiquement : "No Spec, No Code" et "No Task, No Commit"
• Chaîne de traçabilité complète : COMMIT → TASK → US → EPIC → BRIEF
• Budget token transparent par phase : ~900K total (BREAK 70K, MODEL 100K, PLAN 120K, BUILD 500K+, DEBRIEF 80K)
• Repo clonable : implémentation référence concrète (pas juste une documentation)

Limites notables :

• Jeune (22 commits, 8 stars) — pas encore validé en production à large échelle
• JavaScript uniquement (Clean Architecture React)
• Overhead massif (~900K tokens/projet) — adapté aux projets greenfield importants

---

Scoring Breakdown

1. Relevance to Claude Code (5/5)

✅ Entièrement construit sur Claude Code : Skills orchestrant les phases, hooks validant les invariants, agents spécialisés par rôle ✅ Patterns directs : Utilise skills + hooks + agents exactement comme le guide les documente ✅ Implémentation référence : Repo clonable illustrant les concepts du guide en situation réelle

2. Technical Accuracy (4/5)

✅ Phases vérifiées : BREAK→MODEL→ACT→DEBRIEF confirmées dans le README ✅ Gates vérifiées : Gate 0-5 via scripts Node.js (requirements, structure, secrets/PII, planning, code quality, release) ✅ Invariants réels : Enforcement via tools/validate-commit-msg.js — pas juste des suggestions ⚠️ Maturité limitée : 4 semaines, architecture encore en évolution

3. Novelty/Uniqueness (3/5)

✅ Enforcement outillé : Scripts Node.js qui bloquent si gates non passées — pattern non documenté dans le guide ✅ Budget token par phase : Estimation concrète ~900K avec breakdown — unique dans l'écosystème ✅ Traceability chain : TASK→US→EPIC→BRIEF pas explicitement couverte dans le guide ⚠️ Redondance ~80% : spec-first.md (830 lignes), methodologies.md (Spec Kit/OpenSpec), agent-teams.md couvrent déjà l'essentiel

4. Practicality (3/5)

✅ Clé en main : Repo clonable, structure prête ⚠️ Coût élevé : ~900K tokens × $0.003 = ~$2.70/projet + maintenance hooks ⚠️ JavaScript uniquement : Clean Architecture React — pas polyglot ⚠️ Complexité setup : Git hooks + scripts Node.js à configurer

5. Source Credibility (3/5)

✅ Présenté en public : Talk à l'IA CAFE CLUB (Paris), validé par communauté ⚠️ Adoption limitée : 8 stars, 2 forks, 2 contributeurs (auteur + Claude) ⚠️ Pas encore versionné : 0 releases officielles

---

Comparative Analysis

Aspect	Spec-to-Code Factory	Notre Guide
Spec-first workflow	✅ BREAK phase	✅ spec-first.md (830 lignes)
SDD greenfield	✅ Implémentation complète	✅ Spec Kit (methodologies.md:366)
Multi-agent orchestration	✅ 6 agents spécialisés	✅ agent-teams.md
Enforcement via hooks	✅ Scripts Node.js bloquants	⚠️ Patterns seulement
Traceability chain	✅ TASK→US→EPIC→BRIEF	❌ Manquant
Token budget par phase	✅ Breakdown transparent	❌ Manquant
Implémentation référence	✅ Repo clonable	❌ Templates seulement
Brownfield support	✅ V2+ mode	✅ OpenSpec (methodologies.md:375)

---

Challenge (technical-writer agent)

Verdict du challenge : Score initial 4/5 → ramené à 3/5 justifié

Principaux arguments du challenge :

• Redondance à ~80% avec guide existant sous-estimée initialement
• "900K tokens" est un overhead non négligeable, pas un argument de vente
• Repo trop jeune (4 semaines) pour recommandation forte
• Enforcement via Git hooks side-car = gouvernance externe, pas native Claude Code

Risques de non-intégration : Faibles. La ressource est utile pour les devs cherchant une implémentation clé-en-main, mais le guide couvre les concepts fondamentaux.

---

Fact-Check

Affirmation	Vérifiée	Source
BREAK → MODEL → ACT → DEBRIEF (4 phases)	✅	GitHub README (WebFetch)
6 gates de validation (Gate 0-5)	✅	GitHub README
"No Spec, No Code" + "No Task, No Commit"	✅	GitHub README + LinkedIn post
~900K tokens total estimé	✅	LinkedIn post (screenshot + tableau)
8 stars / 22 commits	✅	GitHub (vérifié 2026-02-19)
JavaScript 100%	✅	GitHub (WebFetch)
Enforcement via Node.js scripts	✅	tools/validate-commit-msg.js mentionné dans README

Corrections apportées : Aucune. "6 gates" (LinkedIn) correspond aux Gates 0-5 du README — cohérent numériquement.

---

Decision

• Score final : 3/5 (Pertinent — Mention ciblée)
• Action : Mention dans guide/methodologies.md (tableau SDD Tools) + guide/workflows/spec-first.md (See Also)
• Confiance : Haute

Intégration réalisée :

1. guide/methodologies.md ligne ~365 : Ligne ajoutée dans le tableau SDD Tools
2. guide/workflows/spec-first.md section "See Also" : Lien + description ajoutés

Révision recommandée : Mai 2026 — vérifier adoption (stars, forks, issues), éventuellement upgrader à 4/5 si projet mature.

---

Sources

Primary:

• GitHub — spec-to-code-factory
• LinkedIn post

Internal verification:

• guide/workflows/spec-first.md (830 lignes — spec-first existant)
• guide/methodologies.md (SDD Tools section, ligne ~356)
• guide/workflows/agent-teams.md

Challenge Agent : technical-writer via Task tool (Explore subagent)

---

Evaluation Methodology: docs/resource-evaluations/README.md Guide Version: 3.27.8 Integration Status: ✅ Mention ciblée (2026-02-19)