NEXOS est un systeme de creation et d'audit de sites web professionnels pilote par IA. Il orchestre 56 agents specialises a travers 6 phases sequentielles avec quality gates SOIC (9 dimensions).
Objectif : qualite premium des la premiere generation (score SOIC >= 8.5/10).
# 1. Installer la commande CLI
bash install_nexos.sh
# 2. Lancer l'accueil NEXOS interactif
nexos
# 3. Verifier que le systeme est operationnel
nexos doctor
# 4. Creer un site complet depuis un brief
nexos create --brief clients/.template/brief-client.json
# 5. Auditer un site existant
nexos audit --client-dir clients/mon-client --url https://example.com
# 6. Corriger automatiquement un client
nexos fix clients/mon-client
nexos fix clients/mon-client --dry-run # apercu sans appliquernexos sans argument ouvre un accueil interactif :
- Menu principal (
create,audit,modify, etc.) - Selection du CLI hote (Claude Code, Codex, Gemini)
- Recommandation + forces/faiblesses de chaque CLI selon le type de travail
- Ecran de resume final avec confirmation ou retour arriere
Astuce : Entree accepte le choix recommande, b revient en arriere, q quitte.
| Outil | Version min | Critique | Installation |
|---|---|---|---|
| Python | 3.10+ | Oui | systeme |
| Node.js | 20.0+ | Oui | https://nodejs.org |
| npm | inclus | Oui | inclus avec Node |
| Codex CLI | latest | Oui | npm i -g @openai/codex |
| Lighthouse | latest | Non | npm i -g lighthouse |
| pa11y | latest | Non | npm i -g pa11y |
Verifiez avec nexos doctor pour un diagnostic complet.
NEXOS v4.0 = Multi-phase x Quality Gates x Tooling Reel x Auto-Fix
orchestrator.py (1663 lignes)
|
+--------------+--------------+
| | |
nexos/ agents/ templates/
(10 modules) (56 agents) (39 fichiers)
(5232 lignes) (5 stacks)
| |
+-------+-------+ +-- ph0-discovery (6)
| | | +-- ph1-strategy (6)
| tooling_mgr | +-- ph2-design (6)
| build_valid | +-- ph3-content (6)
| auto_fixer | +-- ph4-build (7)
| cli_commands | +-- ph5-qa (18)
| brief_wizard | +-- site-update (6)
| agent_registry | +-- knowledge
| pipeline_config|
| changelog |
| session_launcher|
+-------+-------+
|
soic/ (symlink)
Quality Gates 9D
| Commande | Description |
|---|---|
nexos create --brief <path> |
Creation complete ph0 -> ph5 |
nexos audit --client-dir <dir> --url <url> |
Audit site existant (ph5-qa) |
nexos modify --client-dir <dir> |
Modification ciblee |
nexos content --client-dir <dir> |
Redaction/traduction (ph3) |
nexos analyze --client-dir <dir> |
Discovery seule (ph0) |
nexos converge <dir> --target 8.5 |
Boucle convergence SOIC |
nexos doctor |
Diagnostic systeme |
nexos fix <dir> [--dry-run] |
Auto-correction D4/D8 |
nexos report <dir> |
Rapport agrege client |
| Option | Description |
|---|---|
--stack nextjs|nuxt|astro|fastapi |
Stack technique cible |
--profile web-nextjs|web-generic|api-fastapi|code-python |
Profil SOIC |
--colors primary=#HEX accent=#HEX ... |
Palette de couleurs imposee |
--section S-NNN |
Cibler une section specifique (mode modify) |
ph0-discovery -> ph1-strategy -> ph2-design -> ph3-content -> ph4-build -> ph5-qa
| | | | | |
mu>=7.0 mu>=8.0 mu>=8.0 mu>=8.0 BUILD PASS mu>=8.5
|
auto-fix si FAIL
(try-fix-retry)
Chaque transition est gardee par un quality gate SOIC (9 dimensions, score mu pondere). Le threshold de deploiement est mu >= 8.5 a la sortie de ph5-qa.
| Dim | Domaine | Poids |
|---|---|---|
| D1 | Architecture | x1.0 |
| D2 | Documentation | x0.8 |
| D3 | Tests | x0.9 |
| D4 | Securite | x1.2 |
| D5 | Performance | x1.0 |
| D6 | Accessibilite | x1.1 |
| D7 | SEO | x1.0 |
| D8 | Conformite legale (Loi 25) | x1.1 |
| D9 | Code Quality | x0.9 |
D4 et D8 sont bloquants : un site ne peut pas etre deploye avec D8 < 7.0.
Le module nexos/auto_fixer.py corrige automatiquement les problemes recurrents :
| Fix | Dimension | Description |
|---|---|---|
| Cookie consent | D8 Loi 25 | Copie template + injection dans layout.tsx |
| npm audit fix | D4 Securite | Corrige les vulnerabilites connues |
| Vercel headers | D4 Securite | Ajoute les 6 headers requis |
| next.config | D4 Securite | poweredByHeader: false |
| Politique confidentialite | D8 Loi 25 | Genere la page depuis template + brief |
| Mentions legales | D8 Loi 25 | Genere la page depuis template + brief |
| Stack | Templates | Statut |
|---|---|---|
nextjs/ |
6 fichiers (next.config, tailwind, vercel, etc.) | Production |
nuxt/ |
nuxt.config, tailwind, README | Production |
astro/ |
astro.config, tailwind, README | Production |
fastapi/ |
main.py, requirements.txt, README | Production |
generic/ |
brief-schema, brief-intake, etc. | Production |
Templates securises additionnels : cookie-consent, privacy-policy, legal-mentions, sitemap, robots, og-image, ad-unit.
clients/{slug}/
+-- brief-client.json # Brief client (donnees legales Loi 25)
+-- section-manifest.json # Registre des sections (S-NNN)
+-- ph0-discovery-report.md # Rapport phase 0
+-- ph1-strategy-report.md # Rapport phase 1
+-- ph2-design-report.md # Rapport phase 2
+-- ph3-content-report.md # Rapport phase 3
+-- ph4-build-log.md # Log de build
+-- ph5-qa-report.md # Rapport QA final
+-- soic-gates.json # Historique des quality gates
+-- nexos-changelog.json # Audit trail append-only
+-- tooling/ # Resultats scans (lighthouse, pa11y, etc.)
+-- site/ # Code source du site
| Projet | Secteur | Score SOIC | Tests | Lighthouse Perf |
|---|---|---|---|---|
| Collectif Nova | Agence creative, Montreal | 9.48 | 158 | 98 |
| Clinique Aura | Clinique multidisciplinaire, Sherbrooke | 9.47 | 131 | 96 |
| Table de Marguerite | Bistro gastronomique, Vieux-Quebec | 9.41 | 206 | 95 |
| Beaumont Avocats | Cabinet d'avocats, Quebec | 9.38 | 113 | 97 |
| Vertex PMO | Gestion de projet, Gatineau-Ottawa | 9.23 | 111 | 87 |
| Electro-Maitre | Electricien industriel, Monteregie | 8.72 | — | — |
Tous les sites sont bilingues (FR/EN), conformes Loi 25 du Quebec, avec headers de securite complets.
- Framework : Next.js 15+ (App Router)
- Langage : TypeScript 5 (strict mode)
- CSS : Tailwind CSS 3.4+ / 4
- Tests : Vitest + @testing-library/react
- i18n : next-intl (FR/EN minimum)
- Icons : Lucide React
- Animations : Framer Motion (avec prefers-reduced-motion)
- Deploiement : Vercel
- Conformite : Loi 25 du Quebec (obligatoire)
Scans automatises avant Phase 5 :
tools/preflight.sh <URL> <CLIENT_DIR>| Outil | Script | Description |
|---|---|---|
| Lighthouse | lighthouse-scan.sh |
Performance, a11y, SEO, best practices |
| pa11y | a11y-scan.sh |
WCAG 2.0 AA |
| Headers | headers-scan.sh |
Verification headers securite |
| SSL | ssl-scan.sh |
Certificat et configuration TLS |
| Dependencies | deps-scan.sh |
npm audit vulnerabilites |
13 fichiers de tests couvrant tous les modules nexos/ :
cd nexos_v.3.0
python -m pytest tests/ -vNEXOS supporte 3 CLI hotes. Les regles metier (securite, Loi 25, SOIC, phases) sont identiques.
| CLI | Fichier | Role |
|---|---|---|
| Claude Code | CLAUDE.md |
Hote interactif (structuration, redaction, arbitrages) |
| Codex CLI | AGENTS.md |
Moteur d'execution (generation de code) |
| Gemini CLI | GEMINI.md |
Hote alternatif |
| Document | Description |
|---|---|
| CLAUDE.md | Specification architecturale complete |
| CHANGELOG.md | Historique des versions |
| CONTRIBUTING.md | Guide de contribution |
| INTEGRATION.md | Design tokens et patches agents |
| docs/api-reference.md | Reference API modules nexos/ |
| docs/architecture.md | Architecture detaillee |
| docs/deployment.md | Guide de deploiement |
| docs/troubleshooting.md | Erreurs frequentes et solutions |
| docs/CLI_GUIDE.md | Guide CLI complet |
Propriete de Mark Systems. Voir LICENSE.
NEXOS is an AI-driven system for creating and auditing professional websites. It orchestrates 56 specialized agents across 6 sequential phases with SOIC quality gates (9 dimensions).
Goal: premium quality from the first generation (SOIC score >= 8.5/10).
# 1. Install the CLI command
bash install_nexos.sh
# 2. Launch the interactive NEXOS welcome screen
nexos
# 3. Verify the system is operational
nexos doctor
# 4. Create a complete site from a brief
nexos create --brief clients/.template/brief-client.json
# 5. Audit an existing site
nexos audit --client-dir clients/my-client --url https://example.com
# 6. Auto-fix a client project
nexos fix clients/my-client
nexos fix clients/my-client --dry-run # preview without applying- 56 specialized agents across 6 phases (discovery, strategy, design, content, build, QA)
- SOIC quality gates between each phase (9 weighted dimensions, mu threshold)
- Real CLI tooling (Lighthouse, pa11y, curl, npm audit) before LLM agents
- Auto-fix for security (D4) and legal compliance (D8) issues
- Multi-stack support: Next.js, Nuxt, Astro, FastAPI
- Quebec Law 25 compliance built-in (cookie consent, privacy policy, legal notices)
- Multi-CLI orchestration: Claude Code, Codex CLI, Gemini CLI
- Bilingual by default: FR/EN with next-intl
ph0-discovery -> ph1-strategy -> ph2-design -> ph3-content -> ph4-build -> ph5-qa
| | | | | |
mu>=7.0 mu>=8.0 mu>=8.0 mu>=8.0 BUILD PASS mu>=8.5
Each transition is guarded by a SOIC quality gate (9 dimensions, weighted mu score). The deployment threshold is mu >= 8.5 at ph5-qa exit.
| Command | Description |
|---|---|
nexos create --brief <path> |
Full creation ph0 -> ph5 |
nexos audit --client-dir <dir> --url <url> |
Audit existing site (ph5-qa) |
nexos modify --client-dir <dir> |
Targeted modification |
nexos content --client-dir <dir> |
Content/translation only (ph3) |
nexos analyze --client-dir <dir> |
Discovery only (ph0) |
nexos converge <dir> --target 8.5 |
SOIC convergence loop |
nexos doctor |
System diagnostics |
nexos fix <dir> [--dry-run] |
Auto-fix D4/D8 standalone |
nexos report <dir> |
Aggregated client report |
| Project | Sector | SOIC Score | Tests | Lighthouse Perf |
|---|---|---|---|---|
| Collectif Nova | Creative agency, Montreal | 9.48 | 158 | 98 |
| Clinique Aura | Multidisciplinary clinic, Sherbrooke | 9.47 | 131 | 96 |
| Table de Marguerite | Gastronomic bistro, Old Quebec | 9.41 | 206 | 95 |
| Beaumont Avocats | Law firm, Quebec City | 9.38 | 113 | 97 |
| Vertex PMO | Project management, Gatineau-Ottawa | 9.23 | 111 | 87 |
| Electro-Maitre | Industrial electrician, Monteregie | 8.72 | — | — |
All sites are bilingual (FR/EN), Quebec Law 25 compliant, with full security headers.
- Framework: Next.js 15+ (App Router)
- Language: TypeScript 5 (strict mode)
- CSS: Tailwind CSS 3.4+ / 4
- Testing: Vitest + @testing-library/react
- i18n: next-intl (FR/EN minimum)
- Icons: Lucide React
- Animations: Framer Motion (with prefers-reduced-motion)
- Deployment: Vercel
- Compliance: Quebec Law 25 (mandatory)
orchestrator.py— Central engine (1663 lines)nexos/— 10 augmentation modules (5232 lines total)agents/— 56 specialized agents in 6 phases + site-updatetemplates/— 39 files across 5 stacks (nextjs, nuxt, astro, fastapi, generic)soic/— Quality gate engine (9 dimensions, profiles, convergence)tools/— 9 CLI scanning scripts (Lighthouse, pa11y, headers, SSL, deps)tests/— 13 test files
Property of Mark Systems. See LICENSE.