Brief commun — pierre angulaire du dossier de lancement KySpectra

#0. Comment utiliser ce document

Tout rédacteur — humain ou agent — lit ce brief INTÉGRALEMENT avant d'écrire une seule ligne du dossier. Il fait autorité sur : l'orthographe de la marque, les slogans, les valeurs, la palette, les personas, les statuts de fonctionnalités, les dates, le ton et les standards de fichiers. En cas de contradiction entre ce brief et un autre document du dossier, ce brief gagne et l'autre document doit être corrigé.

Les faits produits proviennent d'une lecture directe du code au 2026-08-17. Les rapports d'ancrage détaillés (portails, services, plans, statuts) sont conservés hors dépôt, dans l'espace de travail de la session.

---

#1. Identité de marque

#1.1 Orthographes canoniques

⚠️ Écart connu à corriger avant le jour J. L'interface livrée affiche encore common.appName = "SPECTRA" et il n'existe aucun fichier logo dans le dépôt (le logo est un hexagone dessiné en ligne dans frontend/client-portal/src/components/icons.tsx). Deux actions de pré-lancement en découlent : aligner appName sur KySpectra, et produire les fichiers de logo (voir 08-assets/).

#1.2 Domaines

✅ Écart tranché le 2026-08-17. Vérification faite dans le compte Cloudflare de l'éditeur : il contient 11 zones, et kyspectra.com n'en fait pas partie — pas plus que kkyspectra.com, pourtant référencée par les manifestes de production du dépôt. Le domaine de documentation retenu est donc kyspectradoc.kyrieva.com, sur la zone kyrieva.com qui est active et sert déjà tous les portails KySpectra. Le projet Cloudflare Pages s'appelle kyspectra-docs-prod, conformément à la convention maison des autres produits de l'éditeur (immobilia-docs-prod → document.kimmobilia.com, kalexnovia-docs-prod → document.kalexnovia.com, kaxentra-docs-prod → document.kaxentra.com).

⚠️ Reste à trancher : la référence à kkyspectra.com dans k8s/overlays/prod/patches/ingress-prod.yaml pointe vers une zone que le compte ne possède pas. C'est un vestige à corriger dans les manifestes, sans impact sur la documentation.

---

#2. Slogans officiels

Un seul slogan principal. Les autres sont des variantes de contexte, jamais des remplacements.

Interdits : tout slogan promettant une multiplication de productivité chiffrée, une suppression d'emploi, un « remplacement des développeurs », ou une conformité automatique.

---

#3. Manifeste et valeurs

#3.1 Manifeste (texte de référence, reproductible tel quel)

Écrire du code n'est plus le problème. Le savoir l'est devenu.

Nous produisons aujourd'hui plus de logiciel que nous n'en comprenons. Chaque génération assistée par IA ajoute des lignes que personne n'a demandées explicitement, que personne ne relie à une décision, et que personne n'ose supprimer. Nous appelons cela la dette d'intelligibilité. Elle ne figure à aucun budget ; elle se paie en incidents, en audits impossibles et en équipes paralysées devant leur propre système.

KySpectra fait un pari simple : la spécification n'est pas de la paperasse d'avant-projet, c'est la structure de données centrale du cycle de vie. Une exigence est un objet versionné et relié, pas un paragraphe oublié. Un agent IA est un collaborateur avec un périmètre, un plafond d'autonomie et un journal, pas une boîte noire. Un déploiement est une décision approuvée, pas un effet de bord.

Nous ne promettons pas d'aller dix fois plus vite. Nous promettons que ce que vous mettez en production restera explicable — dans six mois, devant un auditeur, et devant la personne qui prendra votre suite.

#3.2 Valeurs et preuve produit

Une valeur non prouvée par un comportement observable est un slogan. Chacune ci-dessous est vérifiable dans le code.

---

#4. Palette et typographie

Valeurs extraites du design system réel (frontend/packages/design-system/src/tokens.ts et client-portal/src/app/portal-theme.tsx). Ce sont les seules couleurs autorisées.

#4.1 Thème clair

#4.2 Thème sombre

Fond #0b1220 · surface #111a2b · texte #e8edf6 · atténué #1b2536 · bordure #24304a · anneau #3b8ef0 · primaire #1e6fd6 · provenance IA #9b85ff · séries #3b8ef0 #9b85ff #34d399 #f0b429 #22d3ee.

#4.3 Correspondance avec les statuts du dossier

#4.4 Typographie

Dans les SVG : font-family="Space Grotesk, ui-sans-serif, system-ui, sans-serif". Jamais de police chargée depuis un CDN (les SVG doivent être autonomes).

Échelle typographique 12 → 32 px · espacement de base 4 px · rayons 4 / 8 / 12 / 16 / 24 / 9999 px · élévations 0-4 · durées d'animation 80 / 120 / 200 / 320 / 480 ms.

---

#5. Surfaces produit — état réel

Règle d'or : ne jamais présenter une surface inexistante comme disponible.

---

#6. Inventaire fonctionnel synthétique

Vue d'ensemble ; le détail exhaustif vit dans 01-produit/.

#6.1 Chaîne de valeur en six maillons

#6.2 Plan de contrôle transversal

Registre central d'agents · capacités à trois niveaux (global / locataire / utilisateur) avec refus par défaut · rôles virtuels et plafond d'autonomie N0→N3 · séparation des devoirs · journal d'audit chaîné · rapports Loi 25 · budgets et quotas · drapeaux de fonctionnalité · configurations de modèles et d'adaptateurs · politiques de garde-fous et d'exécution · coffre de secrets par projet · isolation multi-locataire stricte.

#6.3 Volumétrie (2026-08-17)

255 commits · ~30 services backend déployables · 9 services d'agents autonomes · 2 383 fichiers Python · 497 fichiers TypeScript · plus de 3 700 tests automatisés (chiffre publiable) · 3 environnements en ligne.

Discipline de chiffre. Le comptage direct donne 5 472 fonctions de test, mais le tableau de santé interne ne certifie que ~3 700 tests sur 21 suites vertes. Publier « plus de 3 700 tests automatisés » et rien d'autre.

---

#7. Différenciateurs

Formulés comme des affirmations défendables, chacune adossée à un comportement réel.

Ce qu'on ne revendique pas : la meilleure complétion de code, le plus grand catalogue d'intégrations, la conformité automatique, ni un gain de productivité chiffré.

---

#8. Chiffres de marché — règle stricte

Aucun chiffre de marché n'est autorisé dans ce dossier tant qu'il n'a pas été vérifié à la source et daté. Un dossier de lancement qui invente des statistiques se détruit au premier journaliste qui vérifie.

#8.1 Procédure obligatoire

Tout chiffre publié doit apparaître sous la forme : <valeur> (<source>, <année>) [Source à revalider le <date>]

#8.2 Sources autorisées à consulter

#8.3 Chiffres autorisés dès aujourd'hui

Uniquement ceux qui décrivent notre propre produit, mesurés dans le dépôt :

• 255 commits, du 2026-07-23 au 2026-08-17
• ~30 services backend déployables, 9 services d'agents
• plus de 3 700 tests automatisés
• 3 environnements en ligne (développement, qualification, production)
• 16 destinations dans le plan de contrôle d'administration
• 11 vues canoniques dans l'espace de travail projet

Tout le reste est [Gabarit : chiffre à sourcer].

---

#9. Personas

Douze personas, tous du domaine de la livraison logicielle. Chacun a son business case dans 02-business-cases/.

---

#10. Hypothèses tarifaires — TOUTES ÉTIQUETÉES

⚠️ Rien de ce qui suit n'est une décision commerciale arrêtée. Ce sont des hypothèses de travail, marquées [Hypothèse], à valider par le propriétaire avant toute publication.

#10.1 Ce qui existe réellement en base

Trois jeux de données de démarrage incompatibles coexistent dans le dépôt (un troisième propose 49 / 149 / 499 $ sur un schéma périmé). Nettoyer le catalogue est un préalable bloquant au lancement.

#10.2 Grille proposée [Hypothèse]

Devise unique dans le code : CAD. Toute mention d'euro ou de dollar américain serait aujourd'hui une invention.

Essai : les profils configurés prévoient 14 jours sans carte, avec rappels à J-7, J-3, J-1, et rétrogradation vers le palier gratuit à l'expiration.

---

#11. Calendrier de lancement — dates absolues

Fuseau de référence : America/Toronto.

Fuseaux à couvrir le jour J : America/Toronto (référence) · Europe/Paris (+6 h) · Africa/Abidjan (+4 h) · America/Los_Angeles (−3 h).

---

#12. Ton éditorial

• Français d'abord, registre québécois neutre, sans anglicismes évitables. L'anglais est une langue de plein droit, pas une traduction au rabais.
• Voix : praticien expert s'adressant à un pair. Précis, chiffré, sans superlatif creux.
• Vouvoiement dans tous les documents publics. Tutoiement admis uniquement dans les scripts vidéo courts explicitement marqués.
• Phrases courtes. Une idée par paragraphe. Les tableaux valent mieux que les listes à puces, les listes à puces valent mieux que les paragraphes.
• Interdits : « révolutionnaire », « disruptif », « magique », « le meilleur », « 10x », « sans effort », toute promesse de résultat non mesurée, toute comparaison nominative dénigrante avec un concurrent.
• Vocabulaire imposé : « espace de travail » (pas workspace), « exigence » et « spécification », « agent », « plan de contrôle », « locataire », « plafond d'autonomie », « séparation des devoirs », « journal d'audit ».

---

#13. Standards de fichiers — contrat opposable

1. Markdown GFM strict. Un seul # H1, en première ligne.
2. En-tête obligatoire juste après le H1 :

   > **Document :** <chemin relatif> · **Version :** 1.0 · **Date :** 2026-08-17 · **Statut :** <Livré | Brouillon de travail>
   > **Public :** <interne | externe> · **Marque :** KySpectra (par Kyrieva)
   

3. Pied de page commun obligatoire en fin de fichier :

   ---
   
   <p align="center">
   <strong>KySpectra</strong> — Plateforme agentique SDD/SDLC · par Kyrieva<br>
   Documentation : <a href="https://kyspectradoc.kyrieva.com">kyspectradoc.kyrieva.com</a> ·
   Dossier de lancement : <code>Strategielancement/</code><br>
   <em>Document interne de pré-lancement — version 1.0 du 2026-08-17. Les données marquées
   « [Gabarit : … ] » doivent être renseignées ou revalidées avant diffusion externe.</em>
   </p>
   

4. Mermaid valide : blocs ```mermaid. Identifiants de nœuds **sans accent ni espace** ; libellés toujours entre guillemets dans des crochets (A["Libellé avec accents"]) ; flèches -->, -.->, ==> uniquement ; pas de parenthèses nues dans un libellé ; subgraph fermé par end.
5. SVG autonomes : viewBox obligatoire, aucune ressource externe, texte en <text> réel, fond explicite, couleurs de la palette, lisible en clair et en sombre.
6. Aucun placeholder (TODO, Lorem ipsum, XXX, <à compléter>). Seule forme admise pour une donnée du monde réel indisponible : [Gabarit : description précise de ce qu'il faut mettre].
7. Statuts honnêtes sur toute fonctionnalité citée : Livré, En cours, Planifié, Bloqué. Jamais de « Planifié » présenté comme disponible.
8. Étiquetage : [Hypothèse] pour toute donnée commerciale non arrêtée, [Source à revalider] pour tout chiffre de marché.
9. Tableaux : jamais de cellule vide — mettre —.
10. Nommage : NN-nom-en-kebab-case.md, sans accent dans le nom de fichier.
11. Longueurs minimales : voir le tableau §14.

---

#14. Longueurs minimales par famille de document

---

#15. Interdits absolus

1. Publier SPECTRA seul comme nom de produit.
2. Présenter une capacité Planifiée comme disponible (en particulier : applications mobiles, pilotes nuage natifs, provisionnement automatique de fournisseur d'identité, place de marché à audience ciblée).
3. Parler d'un « portail business » comme d'une application distincte.
4. Publier un chiffre de marché non sourcé et non daté.
5. Publier un prix autre que ceux du §10, sans l'étiquette [Hypothèse].
6. Citer un témoignage client : il n'en existe aucun à ce jour. Utiliser [Gabarit : témoignage à collecter auprès d'un pilote].
7. Reproduire un secret, une clé, un jeton ou une adresse de coffre.
8. Nommer un concurrent de façon dénigrante.

---

KySpectra — Plateforme agentique SDD/SDLC · par Kyrieva
Documentation : kyspectradoc.kyrieva.com · Dossier de lancement : Strategielancement/
Document interne de pré-lancement — version 1.0 du 2026-08-17. Les données marquées « [Gabarit : … ] » doivent être renseignées ou revalidées avant diffusion externe.