Index des savoir-faire
Vous êtes ici : Référence — les faits : la liste des pratiques codifiées du dépôt. Ce que la plateforme sait faire de façon écrite et répétable, et quand chaque savoir-faire doit être ouvert. Lecture : consultation. Audience : devs, architectes. Date : 2026-08-11 | Version : 1.0 — page générée, créée par la refonte de l’architecture d’information
Comment s’en servir
Section intitulée « Comment s’en servir »Chaque savoir-faire déclare ce qui doit déclencher sa lecture : des mots-clés, des symptômes, des noms de fichiers. On ne les lit pas d’affilée — on ouvre celui dont les déclencheurs correspondent à la tâche du moment, avant d’écrire du code.
Les savoir-faire
Section intitulée « Les savoir-faire »52 documents, par ordre alphabétique.
| Savoir-faire | Sujet | À ouvrir quand |
|---|---|---|
| API_DESIGN | API Design & Express Patterns | route ou endpoint Express : validation Zod, format de réponse, erreurs, versioning, CORS, rate limiting. Sources : RESTful API Design (Fielding), Google API Design Guide, Express.js best pra… |
| APP_INVENTORY | APPINVENTORY : inventaire 100 % mesuré d'une app externe avant intégration au monorepo | PoC ou app externe à intégrer : l'inventaire complet et son gate adverse avant toute migration. |
| ARCHITECTURE_REFERENCE | ARCHITECTUREREFERENCE.skill.md -- Living docs par volet architectural | volet sans doc sous docs/architecture/reference/ (ou doc de plus de 30 jours), ou lot qui le touche. |
| AUTH_AZURE | Auth, Azure AD & Sécurité | auth MSAL/Entra : login, JWT, rôles (requireAuth, requireRole, GsRole), 401/403, App Registration. |
| BCM | BCM — Bounded Context Monoliths (skill) | nouveau backend api- ou nouvelle app, placer une table : quel bounded context, vues cross-BC (ADR-025). |
| BILAN_SIGNALEUR | Bilan hebdomadaire de l'activite signaleur | bilan, mou ou dispo des signaleurs ; heures de paie SOFI (PaiesJour) ; pauses des signaleurs. CE SKILL REPOND A : combien de signaleurs etaient disponibles, combien ont travaille, et combien… |
| CI_CD | CI/CD, Build & Déploiement | GitHub Actions et déploiement Azure : workflow, build, lockfile, turbo, smoke test, filtre paths. |
| CLEAN_CODE | Clean Code & Architecture | écrire ou revoir du code : nommage, structure, complexité, duplication, types TypeScript. Sources : Robert C. Martin (Clean Code), Google TypeScript Style Guide, SOLID principles, Airbnb Sty… |
| DATA_CATALOG | Data Catalog & Lineage | catalogue et lineage des données : lineage.ts, ADMDataCatalog, GET /api/catalog, qui alimente quoi. |
| DATA_LAYER_MULTI_TENANT | DATALAYERMULTITENANT (injection SESSIONCONTEXT / RLS application-side) | requête sur une table tenant-sensitive : queryWithContext, transactionWithContext, RLS. |
| DEBUG | Debug & Diagnostic | bug ou panne : 500/503/401/403, crash, timeout, écran blanc, CORS/CSP, MSAL, mssql, cold start. |
| DECOMMISSION_APP | DÉCOMMISSIONNER une app GS-Apps (fin de vie + DROP du BC privé) | retirer une app du monorepo (aucune commande /decommission n'existe : .claude/commands n'en porte pas), DROP de son schéma BC, avant une recréation C-native. |
| DELOITTE_ONEPAGER | DELOITTEONEPAGER | présentation d'affaires d'une page (style Deloitte/McKinsey) pour un conseil ou un comité. |
| DESIGN_SYSTEM | Design System & Composants UI | UI et design system : composants @gs/ui, tokens, Tailwind, couleurs, cards, tableaux, dark mode. Version DS active : lire GSDESIGNSYSTEMVERSION.version dans packages/ui/src/tokens.ts (2.3.34… |
| DIAGRAM_HERO_UPDATE | DIAGRAMHEROUPDATE (v2 — best practices Claude Design 2026) | créer ou mettre à jour un diagramme hero dans apps/docs/. |
| ECOSYSTEM_SYNC | Ecosystem Sync (Propagation 360°) | propager une règle, un ADR ou un skill modifié : quels autres fichiers changent, en fin de lot. CE SKILL RÉPOND À : quand on améliore X, qu'est-ce qui doit aussi changer ? OBJECTIF : zéro am… |
| END_OF_SESSION | End of Session (fin de session avec sync automatique) | fin de session annoncée par David (« bonne nuit ») ; le rituel vivant est /bonne-nuit. CE SKILL RÉPOND À : qu'est-ce qu'on doit synchroniser avant que David quitte la session ? OBJECTIF : zé… |
| ENVIRONMENTS | Environnements de commande GS-Apps | avant de donner une commande à David : PowerShell 5.1, Kudu, Azure, outils présents. David travaille TOUJOURS dans ces 2 environnements. Jamais bash natif. |
| ERROR_HANDLING | ERRORHANDLING | gestion d'erreurs : AppError et codes métier, errorHandler, retry, GsErrorBoundary, correlationId. |
| ETL_DATA | ETL, Base de données & SOFI | SQL, migrations, ETL SOFI : MERGE, transactions, db:init, @gs/etl, @gs/db, runners, types SOFI. |
| EXTERNAL_API_INTEGRATION | EXTERNALAPIINTEGRATION — Skill gouvernance intégrations vendor | intégration vers une API externe (Microsoft, GitHub, Geotab, Monday, Sage…) ou entre apps GS. |
| EXTERNAL_PROVIDER | Intégrer un fournisseur externe (mail, SMS, paiement, API vendor sortante) | fournisseur sortant : courriel ACS, SMS, paiements, webhook ou client HTTP vers un tiers. |
| FIX_ERRORS | Fix Errors (TypeScript, ESLint, Build) | build, TypeScript ou ESLint en échec : error TS, cannot find module, implicit any, CI rouge. Inspiré du skill fix-errors de Melvynx — adapté au stack GS-Apps. Méthodologie : Lire → Comprendr… |
| GIT_WORKFLOW | Workflow git (worktrees, fusion, purge) | |
| I18N | i18n & Traductions @gs/i18n | i18n FR+EN : t(), useTranslation, clés de traduction, i18n serveur (api-portail), sélecteur de langue. |
| INTEGRATE_POC | INTEGRATEPOC.skill.md — Recette d'integration d'un PoC dans l'infra GS | brancher un PoC sur l'infra GS (coffre, bicep, App Service, déploiement) après son inventaire. |
| LOGGING | Logging structuré & Observability GS-Apps | logs et observabilité : createGsLogger, correlationId, App Insights, incident prod, PII dans les logs. |
| MANAGED_IDENTITY_SQL | Managed Identity SQL (ADR-033) | |
| MCP_TOOLS | MCP Outils (création, audit, guardrails) | outils MCP (apps/mcp) : nouvel outil, withMcpTool, validateReadOnlySql, timeout, FF-MCP-01 à 04. Sources : apps/mcp/src/index.ts, ADR-029 (JWT Azure AD), ADR-076 (porte workforce GS Apps vs… |
| MID_SESSION_DECISION_CAPTURE | Mid-Session Decision Capture | |
| MIGRATE_FIREBASE | Porter le DOMAINE d'un PoC Firebase vers une app GS-Apps C-native | porter le domaine d'un PoC Firebase/Firestore (shophub, PoC hors monorepo) vers une app C-native. |
| MOCK_FIRST | Mock-first : la maquette se construit dans l'app, sur données fictives | nouvel écran ou refonte UX : maquette construite DANS l'app (@gs/ui, @gs/feedback, tokens) sur données fictives derrière USEMOCK, figée avant de brancher le réel. |
| MULTI_AGENT_COORDINATION | Coordination de plusieurs agents en parallèle | |
| MULTI_BRAND | Multi-Brand Architecture | app d'une autre marque que GS : couleurs brand-, override Tailwind, logo, palette (ADR-015). Sources : ADR-015, tailwind.config.shared.js, docs/architecture/MULTIBRAND.md |
| MULTI_COMPANY | MULTICOMPANY — Multi-company Universal Group (skill) | table ou route liée à une compagnie, onboarding d'une compagnie UG, branding : principes multi-company. |
| NEW_COMPONENT | Nouveau Composant @gs/ui | créer un composant partagé @gs/ui (tokens.ts, COMPONENTCATALOG). |
| PII_COMPLIANCE | PII / Loi 25 Compliance | données personnelles (Loi 25, PIPEDA) : colonne PII, Bronze→Silver, logs masqués, logPiiAccess. |
| POC_LIFECYCLE | Cycle de vie d'un PoC (naissance -> gel -> décommission) | nouvelle idée d'app ou PoC : prototyper ou scaffolder, charte, péremption, gel ou abandon. |
| PROMPT_CREATOR | Prompt Creator (Meta-Skill) | écrire un cadrage MASTER (docs/prompts/) et sa ligne de file, découper un lot, phrase d'agent. C'est le meta-skill : il génère les autres skills / prompts. |
| PROPOSAL_VALIDATION | PROPOSALVALIDATION -- Validation systematique avant toute proposition architecturale majeure | avant de proposer un ADR, un amendement ou un lot auth/infra/data : les quatre sections. |
| REACT_PATTERNS | React 19 & TanStack Query v5 Patterns | composant ou hook React : useQuery, useMutation, formulaires, états de chargement, React 19. Sources : React 19 docs, TanStack Query v5 docs, Kent C. Dodds (Epic React), Theo (t3.gg), Tanner… |
| SCAFFOLD_APP | SCAFFOLDER une app GS-Apps (naissance NATIVE Système C) | faire naître une app C-native (gabarits App.tsx et server) — aucune commande /scaffold n'existe (.claude/commands n'en porte pas). |
| SCAFFOLD_DEPLOY | SCAFFOLDDEPLOY (déploiement App Service + dépendances runtime) | workflow master.yml, module runtime partagé, external esbuild, 503 après déploiement. |
| SCAFFOLD_MIGRATE | Scaffold, Migrate & Nouvelle App | pièges de migration SQL (ADR-036, idempotence, destructrices), gabarits serveur. |
| SECURITY | Sécurité applicative GS-Apps | sécurité : secrets et rotation, OWASP, Helmet, CSP, CORS, rate limiting, SSRF, ADR-029/033/076. |
| SKILL-DATA-ARCHITECTURE | Data Architecture (decisions row-store vs columnstore, OLTP vs OLAP) | décision de stockage data : Bronze/Silver/Gold, tier Azure SQL, columnstore (ADR-039). |
| SKILL-DATA-PIPELINE | Data Pipeline Lifecycles | câbler ou modifier une source de données : cycle ETL J1-J5, sync incrémental, index, qualité. |
| SKILL_CREATOR | Skill Creator (Méta-Skill) | créer ou réviser un skill — structure, phrase de déclenchement, régénération de la table. Ce skill définit comment créer un nouveau .skill.md conforme au standard GS-Apps. |
| SQL_PATTERNS | SQL Patterns & Azure SQL | écrire ou optimiser une requête SQL : index, JOIN, pagination, transaction, N+1, MERGE, plan. Sources : Microsoft Azure SQL best practices, Brent Ozar (SQL Server), Use The Index Luke (Marku… |
| STANDARDIZE | Standardisation du Code Existant | mettre une app existante aux standards actuels : audit de qualité, refactoring du legacy. Ce skill est spécifique à GS-Apps — c'est la réponse à "comment appliquer les nouveaux standards (CL… |
| START_OF_SESSION | Start of Session (briefing matinal automatique) | première réponse d'une session ouverte par une salutation ; le rituel vivant est /bon-matin. CE SKILL RÉPOND À : où on en était et qu'est-ce qu'il faut faire aujourd'hui ? OBJECTIF : briefin… |
| TESTING | Tests (Vitest + Supertest) | écrire des tests : Vitest, Supertest, mock de @gs/db, couverture, dimension G d'audit. Sources : Vitest docs, Testing Library, GS-Apps patterns réels |
Pour aller plus loin
Section intitulée « Pour aller plus loin »- Index des décisions — ce qui fait règle, par opposition à ce qui décrit une pratique.
- Comment GS-Apps décide — comment décisions et savoir-faire s’articulent.
- Naissance d’une application — un parcours qui enchaîne plusieurs savoir-faire.