Documentation Normik
Normik est une quality gate pour le code généré par IA : chaque pull request est contrôlée au regard du playbook de votre équipe, sur votre propre clé API. Cette documentation couvre l'ensemble du produit.
Les concepts
| Concept | Ce que c'est |
|---|---|
| Organisation | Votre tenant. Les membres, la facturation, la clé du provider IA et tout le contenu lui appartiennent. Les données sont strictement isolées par organisation. |
| Workspace | Un dossier à l'intérieur de l'organisation — typiquement un par client ou par produit. Les règles et les skills placés dans un workspace s'ajoutent à ceux définis au niveau de l'organisation. |
| Règle | Un standard, écrit en langage naturel, avec une sévérité (info / warning / error), des scopes en glob, des tags et un historique de versions. |
| Skill | Un mode d'emploi réutilisable (des instructions en markdown) que vos agents de code peuvent découvrir et charger à la demande via MCP. |
| Token de workspace | Un bearer token (nmk_…) qui restreint les jobs CI et les agents MCP à un workspace — les règles globales sont héritées automatiquement. |
| Analyse | Une exécution de la gate : le diff, les règles appliquées, les violations trouvées. Alimente le dashboard de conformité. |
Les deux points d'application
Le même playbook est appliqué à deux endroits, et les deux se renforcent l'un l'autre :
- À l'écriture — les agents de code (Claude Code ou tout client MCP) chargent vos règles pendant qu'ils travaillent, contrôlent eux-mêmes leur diff et corrigent les violations avant le commit.Voir MCP et agents.
- Au merge — un job CI contrôle le diff de la pull request et bloque le merge en cas de violation de sévérité error.Voir Gate CI.
Par où commencer
- Démarrage rapide — de l'inscription à une pull request sous contrôle, en cinq étapes.
- Playbook et règles — écrire des règles qu'un modèle peut réellement faire respecter.
- Sécurité et données — ce qu'il advient de votre code et de vos clés (réponse courte : le code n'est pas stocké, les clés sont chiffrées).