Shell

Repo factory : briques de gouvernance, contrats, schémas, et templates SaaS concrets pour produire plusieurs apps sans backend freestyle, sans dette de sécurité, et sans vendre de données non conformes.

Structure

Shell/
├── README.md ← tu es ici
├── README_FACTORY.md ← vue d'ensemble factory
├── RECONCILIATION.md ← qui dépend de qui
├── AGENT_RULES.md ← doctrine agents IA (root)
├── QUALITY_GATES.md ← checks PR obligatoires
├── RUN_SCHEMA.md ← contrat universel input/output
│
├── micro-saas-template-v2/ ← template SaaS Next.js + Supabase + Stripe
│ ├── (Shell + Engine + Worker)
│ ├── CLAUDE.md ← règles spécifiques de portage
│ └── INTEGRATION_NOTES.md ← place de v2 dans la factory
│
├── agent-quality-system/ ← skills, router, hooks, approval-policy
├── growth-data-layer/ ← consent, master_leads, sellable_status
├── ai-privacy-gateway/ ← Presidio avant LLM
├── backend-packs/ ← patterns backend prévalidés
├── security-packs/ ← scans + doctrine
├── legal/ ← cleanroom + data-selling + licences
│
├── repo-factory-shell/ ← (scaffold) CLI factory
├── reference-site-analyzer/ ← (scaffold) URL → cleanroom feature
├── feature-generation/ ← (scaffold) feature → blueprint
├── modules-registry/ ← (scaffold) modules versionnés
├── ops-packs/ ← (scaffold) monitoring/maintenance
├── ops-autopilot/ ← (scaffold) fallback/quotas/blocage
├── automation-packs/ ← (scaffold) n8n workflows
├── factory-control-center/ ← (scaffold) cockpit multi-sites
├── finance-ledger/ ← (scaffold) P&L par site
├── context-engine/ ← (scaffold) anti-token-burn
├── dev-orchestrator/ ← (scaffold) tâches IA bornées
│
├── docs/ ← doctrine architecture/security/design/ops
├── tools/ ← scanners + helpers shell
├── ops/services/ ← un YAML par site en production
└── reports/ ← outputs scans, audits, etc.

Par où commencer

Si tu veux déployer un nouveau SaaS rapidement

→ micro-saas-template-v2/README.md. Le template marche standalone, 5 min au niveau 0 (mock). Le reste de la factory est optionnel jusqu'à ce que tu aies plusieurs sites ou besoin de vendre de la data.

Si tu veux comprendre la factory entière

1. README_FACTORY.md — vue d'ensemble
2. RECONCILIATION.md — comment v2 et la factory s'emboîtent
3. AGENT_RULES.md — règles agents IA
4. legal/data-selling-policy.md — règle data critique
5. growth-data-layer/README.md — pipeline data conforme

Si tu veux contribuer / faire évoluer

1. QUALITY_GATES.md — checks bloquants par PR
2. agent-quality-system/policies/approval-policy.yml — auto vs ask_before
3. docs/factory/definition-of-done.md
4. docs/decisions/ — ADRs (chaque choix structurant a son ADR)

Statut

Brique	Statut
micro-saas-template-v2	✅ MVP complet, testé (typecheck + tests + build OK)
AGENT_RULES.md / QUALITY_GATES.md / RUN_SCHEMA.md	✅ Doctrine v1
growth-data-layer (schémas SQL + policies)	✅ MVP fait
legal (cleanroom + data-selling + license)	✅ MVP fait
agent-quality-system (rules + approval + skills core)	✅ MVP fait
security-packs (doctrine + tools/scanners)	✅ MVP exécutable
ai-privacy-gateway (Presidio + redaction/pseudonymize)	✅ MVP exécutable, Redis requis en prod
backend-packs (README + pack.yaml)	✅ MVP contrats/patterns
factory-control-center (DB schema + APIs admin)	✅ MVP exécutable
finance-ledger (schémas + policies)	✅ MVP fait
ops-autopilot (status schema + action policy)	✅ Schéma fait, code phase 4
ops-packs / automation-packs / context-engine / dev-orchestrator	🟡 MVP policies/outillage
repo-factory-shell / feature-generation / modules-registry	🟡 CLI MVP + contrats docs

Voir README_FACTORY.md pour le plan de construction par phases.

Documents auxiliaires

• V1_to_V2_summary.md — récap historique de la migration v1→v2 du template