Framework FEAT-driven development pour Claude Code — branche next : v7.0.0 GA tagué 2026-06-07 (cf. .claude/docs/VERSIONING.md). Branche main : v6.10.4-LTS (freeze actif jusqu'au 2026-06-18).

🌍 English README — quickstart + console essentials (les docs FR restent canoniques).

Documentation principale : .claude/CLAUDE.md

Option recommandée : utiliser ce repo comme GitHub Template. Cliquer sur "Use this template" → "Create a new repository" → cloner localement → lancer le bootstrap interactif :

# macOS / Linux
python3 bootstrap.py

# Windows (PowerShell)
.\bootstrap.ps1

# Non-interactive (CI / scripted) — uses validated combo C1
python bootstrap.py --combo c1 --skip-install

Le bootstrap :

• Demande le nom du projet + 3-4 questions (stack, DB, auth)
• Génère workspace/input/stack/stack.md (43 clés Project Config, defaults sûrs)
• Crée la structure workspace/output/.sys/ complète
• Installe les dépendances Python (pip install -e .claude/python[dev])
• Propose l'install des deps console (npm install dans workspace/console/)
• Lance un smoke check final

Combos disponibles :

• C1 🟢 : .NET Minimal API + React + shadcn + Azure AD + xUnit (recommended)
• C2 🟢 : Kotlin Spring Boot + React + shadcn + Azure AD + JUnit
• C3 🟢 : Node Express + React + shadcn + auth-local (bench-validated 2026-06-05)
• C4 🟢 : Python FastAPI + React + shadcn + auth-local (bench-validated 2026-06-05)
• C5 🟢 : .NET Minimal API + Vue + Vuetify + Azure AD (bench-validated 2026-06-05)
• --combo custom : composition manuelle (4 backends × 4 frontends × 3 UI)

CI mode (no prompts) :

SDD_APP_NAME=MyApp SDD_COMBO=c1 python bootstrap.py --auto-init

Créneau différenciant : SDD_Pro industrialise la qualité (5 reviewers, telemetry, anti-derive strict). C'est l'équivalent Sonar + Snyk + ADR governance appliqué au pipeline LLM. Voir cookbook 10 min pour démarrer.

1. Éditer les secrets dans workspace/input/stack/stack.md (DB password, Azure AD client ID, etc.) — fichier gitignored.
2. Dans Claude Code : /feat-generate <Nom> — répondre aux 3-6 questions.
3. (Optionnel) déposer mockups HTML sous workspace/input/ui/{n}-{m}-{Name}.html.
4. /sdd-full {n} — pipeline complet de A à Z.
5. /sdd-status [{n}] — vérifier l'état.

Depuis v6.10, une console web React + Fastify centralise toute la télémétrie du projet (QA, sécurité, coverage, runs, gates) en lisant la base SQLite workspace/output/db/console.db. Aucun fichier .json ni .jsonl de stats ne subsiste sur le FS — la DB est la source de vérité unique.

cd workspace/console
npm install        # première fois uniquement (Fastify + SDK Anthropic)
npm start          # démarre sur http://127.0.0.1:4000

Pré-requis : Node.js ≥ 20 et Python ≥ 3.8 sur le PATH (utilisé pour requêter console.db via les helpers sdd_lib).

ℹ️ Doc framework retirée de la console 2026-06-06 — la console reste DÉDIÉE aux stats des projets matérialisés. La documentation SDD_Pro elle-même vit dans le site MkDocs Material (voir section 📖 Documentation site ci-dessous).

• 🎨 Theme light / dark avec toggle en topbar, persisté en localStorage, suit prefers-color-scheme au premier load. Logos adaptatifs (versions claire / sombre).
• 📊 Charts SVG natifs (donut, bar stacks, sparklines, gradient progress bars) — palette indigo/cyan/amber/red/emerald/violet, theme-aware. KPI cards avec valeurs en gradient clip-text.
• 🛡 Section Audit qualité (style SonarQube) : 1 ligne par FEAT avec ratings A→E (Vulnerabilities, Code Smells, Coverage). Cartes affichées uniquement si les données existent en DB (pas de placeholder).
• 🔍 Drill-down expandable : un clic sur une ligne FEAT déplie 3 tables (vulnerabilities critique/serious, code smells, coverage gaps) avec file:line, OWASP/CWE, règles, severities colorées.
• 🖼 Vue UX carrousel : mockups HTML servis via route statique /ui/* (CSS relatif design-system.css chargé naturellement, pas de duplication). Thumbs cliquables + flèches ‹ › + iframe sandboxé.
• ⏳ Loading spinner : SVG natif animé (rotation gradient + 3 dots pulse, theme-aware).
• 🛡 Gates manuels : les phases afterUS / afterReadiness / afterPlan / afterCode posées par /sdd-full --manual-gates sont résolues depuis la console (POST /api/gate-decide), atomic write protégé par lock cross-language Python ↔ Node.
• 🤖 Reformulation IA (LOT 4, opt-in) : bouton « Reformuler avec IA » sur les FEAT/US/Plans, utilise l'Anthropic SDK pour produire une version PO-friendly.
• 📡 Live updates : SSE (/api/events) pousse les changements FS et les modifs status.json côté client — l'arbre se met à jour sans rechargement. Bouton Rafraîchir force un re-scan du filesystem.

• .claude/CLAUDE.md — entry-point slim (~150 lignes, références vers le détail)
• .claude/docs/quickstart.md — démarrage pas à pas
• .claude/docs/architecture.md — vision, modèles, agents, stacks
• .claude/docs/workflow.md — 4 phases du pipeline (FEAT → US → Code)
• .claude/docs/conventions.md — anti-derive, idempotence, plans

• .claude/docs/CHANGELOG.md — historique versions (focus v7.0.0 GA)
• .claude/docs/MIGRATION.md — guides de mise à niveau (v6.10 → v7.0.0)
• .claude/loader.yml — manifest reads/writes par agent
• .claude/rules/ — 8 règles opérationnelles consolidées v7.0.0 (build-and-loop, library-and-stack, ownership, quality, error-classification + output-protocol, dev-shared-preflight, error-classification-legacy)

La documentation complète du framework vit dans un site statique MkDocs Material (Python). Lancer en local :

# Installer les deps docs (1ère fois uniquement)
pip install -r requirements-docs.txt

# Serveur live-reload local
mkdocs serve
# → http://localhost:8000

# Build statique (produit site/, HTML pur)
mkdocs build

Le site comprend :

• 🚀 Getting Started (tutoriel 30 min) + Cookbook (recettes 10 min)
• 🤖 Agents reference (12 cartes : role / model / IO / verdicts)
• 💻 Commands reference (20 cartes : args / flags / decision tree)
• ⚙️ Configuration reference (43 clés Project Config + policies non-bypass)
• 🏗 Architecture (composants + workflow + 4 diagrammes mermaid)
• 🛟 Troubleshooting + FAQ (22 erreurs [CLASS] + 8 FAQ)
• 🤝 Contributing + Working Agreement + Versioning + ADRs

💡 Azure DevOps private project : pas de publication GitHub Pages. Le dossier site/ produit par mkdocs build peut être déployé manuellement (Azure Static Web Apps, file share, intranet). Cf. mkdocs.yml config.

Hub navigation : .claude/docs/README.md — explorer la doc sans MkDocs (Markdown brut sur GitHub/IDE).

Framework écrit en Python (stdlib pure pour le moteur, pytest pour les tests — suite > 1000 tests couvrant sdd_lib/, sdd_scripts/, sdd_hooks/, sdd_admin/). Console web : Node.js 22.5+ (Fastify 5 + React 18 via CDN, pas de build step). SQLite (WAL mode) pour la télémétrie centralisée (workspace/output/db/console.db).

Compte vérifiable localement :

python -m pytest .claude/python/tests/ -q          # collecte pytest complète (~570)
python -m unittest discover -s .claude/python/tests -p "test_*.py"   # subset compatible stdlib (~530)

Aucun runtime applicatif imposé sur le code généré — SDD_Pro produit du code dans le stack du projet cible.

Catalogue stacks (v7.0.0 GA) — terminologie stricte (source de vérité = entête Validation: du fichier .md) :

Total actif : 34 stacks répartis : Backend (4), Frontend (4), UI DS (3), QA (9 dont 2 opt-in mutation-testing + playwright), Auth (2), Archi (3 patterns mvc/ddd/microservice), Fullstack (6 expérimentaux), Mobiles (3 expérimentaux). Détail : .claude/CLAUDE.md §6.

ℹ️ v7.0.0 GA audit P0-doc 2026-06-05 : la ligne "⏸️ draft (quarantaine)" et le dossier _drafts/ ont été retirés (rollback governance-stacks-quarantine-rollback du 2026-05-24 ; cf. CHANGELOG). Aucun stack n'est en quarantaine — les stacks expérimentaux restent chargeables avec l'avertissement runtime.

⚠️ Hors les 2 combos validés C1/C2, la composition multi-stacks n'a pas été validée par un PoC complet ; le pipeline peut échouer en runtime de manière non triviale. Pour activer une 3ᵉ combo, exécuter d'abord le PoC ROI méthodologie (.claude/docs/poc-roi-methodology.md).

Voir .claude/python/README.md pour les scripts utilitaires.

Conçu et maintenu par Zekiri Abdelali · 2026