6d847d24de
- Section 3.5 "Team Configuration at Scale" in ultimate-guide.md: profiles YAML + shared modules + skeleton + assembler script; 59% context token reduction measured on 5-dev production team; includes CI drift detection, 5-step replication guide, trade-offs - New workflow: guide/workflows/team-ai-instructions.md (6 phases, scaling thresholds, troubleshooting table) - New templates: examples/team-config/ (profile-template.yaml, claude-skeleton.md, sync-script.ts) - reference.yaml: 9 new entries for team_ai_instructions_* - README: templates count 161 → 164, date Feb 19 → Feb 20 - CHANGELOG [Unreleased]: resource evaluations (AGENTS.md ETH Zürich 4/5, Sylvain Chabaud 3/5), spec-first Task Granularity section, methodologies ATDD expansion Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
6.6 KiB
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 :
guide/methodologies.mdligne ~365 : Ligne ajoutée dans le tableau SDD Toolsguide/workflows/spec-first.mdsection "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:
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)