Skip to content
BranchesTags

Repository files navigation

SDD_Pro

Framework FEAT-driven development multi-harness (Claude Code, Codex, Gemini CLI, Antigravity) — v7.0.3-dev (base v7.0.0 GA 2026-06-07). Baseline LTS v6.10.x conservée jusqu'au 2026-12-31. Cf. .sdd/docs/VERSIONING.md · CHANGELOG.

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

Documentation principale : .claude/CLAUDE.md

🚀 Quickstart — nouveau projet

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/stack/stack.md (43 clés Project Config, defaults sûrs)
  • Crée la structure workspace/.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

🆚 Pourquoi SDD_Pro vs BMAD / GSD / AgentOS / Superpowers ?

Critère SDD_Pro BMAD GSD AgentOS Superpowers
Multi-harness (Claude + Codex + Gemini…) ✅ natif ❌ ❌ ❌ ❌
Multi-agents spécialisés 25 ~6 ~5 4 8
Reviewers post-code (5 angles, adversarial par défaut) 5 ✅ 1 1 1 2
Anti-derive strict (ownership matrix + STOP bloquant) ✅ partiel ❌ partiel partiel
Catalogues machine-readable (.libs.json + CVE + LTS) ✅ ❌ ❌ ❌ ❌
Error classification cross-agent (189 préfixes [CLASS]) ✅ ❌ ❌ ❌ ❌
Telemetry SQLite + statusline IDE (coût, phase, tokens) ✅ ❌ partiel partiel ❌
Idempotence / resume (checkpoint mode) ✅ ❌ ❌ partiel ❌
Scripts déterministes 0-token LLM 55 scripts ❌ ❌ partiel partiel
Plugin marketplace (discovery IDE natif) ✅ plugin.json ❌ ❌ ❌ ❌

Créneau différenciant : SDD_Pro industrialise la qualité (5 reviewers dont adversarial par défaut, telemetry, anti-derive strict, gates déterministes) sur n'importe quel harness LLM. C'est l'équivalent Sonar + Snyk + ADR governance appliqué au pipeline multi-agent. Voir cookbook 10 min pour démarrer.

Démarrage rapide (après bootstrap)

  1. Éditer les secrets dans workspace/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/ui/{n}-{m}-{Name}.html.
  4. /sdd-full {n} — pipeline complet de A à Z.
  5. /sdd-status [{n}] — vérifier l'état.

Console web — cockpit de validation

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/db/console.db. Aucun fichier .json ni .jsonl de stats ne subsiste sur le FS — la DB est la source de vérité unique.

Lancer la console

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).

Deux pages principales

Page URL Fonction
Dashboard (défaut) / KPI cards (FEATs, Tests API, Sécurité, Quality), grille statuts par FEAT, audit qualité style SonarQube (Vulnerabilities / Code Smells / Coverage avec ratings A→E), 4 charts modernes (coverage bars, quality stack, API gate, security donut), sparklines, theme dark/light persisté.
Features (ex-SDD Jira) / puis onglet Features 3 vues : Vue PO (FEAT → US), Vue technique (FEAT → US → plans back/front), Vue UX (carrousel des mockups HTML par FEAT). Header avec bouton Rafraîchir qui re-scanne le FS (les nouveaux fichiers .md/.html apparaissent dynamiquement).

ℹ️ 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).

Highlights

  • 🎨 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.

API HTTP exposée

Endpoint Description
GET /api/tree Arbre FEATs → US → plans + état status.json mergé
GET /api/dashboard Vue agrégée toutes FEATs (5 KPIs + 1 ligne par FEAT)
GET /api/feat/:n Détail d'une FEAT (coverage, quality, security, api-tests)
GET /api/feat/:n/details Issues sonar (vulns + smells + coverage gaps)
GET /api/audit Aggrégat tokens / contexte par agent
GET /api/state Dernier run + 30 derniers events
GET /api/gates?feat=N Historique gates pour 1 FEAT
GET /api/file?path=… Lecture brute d'un fichier MD du workspace
POST /api/validate Enregistre la décision PO/Tech Lead sur une US/Task
POST /api/gate-decide Résout un gate afterUS/afterReadiness/...
GET /api/events Server-Sent Events (broadcast modifs FS + gates)
GET /ui/* Sert directement workspace/ui/ (mockups HTML avec leur CSS relatif design-system.css)

Documentation détaillée

Pour les utilisateurs SDD_Pro

Pour les contributeurs framework

  • .sdd/docs/CHANGELOG.md — historique versions (focus v7.0.0 GA)
  • .sdd/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)

📖 Documentation site (MkDocs Material)

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 : .sdd/docs/README.md — explorer la doc sans MkDocs (Markdown brut sur GitHub/IDE).

Stack technique

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/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) :

Statut Définition Compte réel
🟢 (validated / bench-validated / scaffold-validated) Stack avec entête Validation: 🟢 — composant d'un combo validé bout-en-bout, bench-validé runtime, ou scaffold-validé. Inclut les 2 combos validated end-to-end (C1, C2) 28 stacks (.sdd/docs/validated-combos.md)
🟡 experimental / POC-only Stack avec entête Validation: 🟡 — chargeable mais sans validation bout-en-bout (5 experimental : archi/ddd, archi/microservice, qa/mutation-testing, qa/playwright, fullstack/aspnet-mvc-razor ; 1 POC-only : fullstack/node-react ; 1 scaffold-validated pending : mobiles/kotlin-android) 7 stacks

Total actif : 35 stacks (28 🟢 + 7 🟡) 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 (7 dont aspnet-mvc-razor expérimental), Mobiles (3). SSoT = entête Validation: du .md. 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 (.sdd/docs/poc-roi-methodology.md).

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

Licence & auteur

Conçu et maintenu par SDD-Pro maintainer · 2026

About

Speification Deriven Devloppemnt

Resources

Readme
Apache-2.0 license
Activity

Stars

140 stars

Watchers

2 watching

Forks

20 forks
Report repository

Releases

Packages

Contributors

Languages