# Bienvenue dans NEX NEX est la **méthodologie + l'outillage** qui orchestre les projets Kiliogene de manière cohérente. Si tu lis cette page, c'est qu'on t'a confié l'accès à l'écosystème — bienvenue. Cette page t'oriente vers la bonne procédure selon ton cas. Compte 5 minutes pour lire ce README, puis enchaîne sur la procédure qui te concerne. --- ## Tu es ici parce que… ### 🧑‍💻 Tu rejoins l'équipe en tant que dev Que tu sois salarié Kiliogene, freelance ou prestataire, c'est **la** procédure à suivre pour pouvoir bosser sur n'importe quel projet de l'écosystème. 📖 **[Lis la procédure collaborateur](./collaborateur.md)** — ~30 minutes la première fois, puis tu es opérationnel. Ce qu'elle couvre : - Installer Claude Code sur ta machine - Rejoindre le réseau privé Kiliogene (Tailscale) - Recevoir tes accès via Passbolt - Valider que ta session marche bien ### 🛠️ Tu dois intégrer un projet (le tien ou un autre) à la boucle NEX Que le code existe déjà ou que tu démarres de zéro, on a une procédure qui gère les deux cas. 📖 **[Lis la procédure projet](./projet.md)** — ~10 minutes pour un projet existant, ~30 minutes pour un projet neuf. Ce qu'elle couvre : - Choisir un slug et faire provisionner les accès - Configurer le projet pour qu'il "parle" à NEX - Mettre en place le contrat Delivery (INT/REC/PROD) si nécessaire - Premier déploiement ### 📚 Tu cherches où vit telle ressource Tu as une question précise du type *« où est rangé X ? », « comment installer la skill Y ? », « quel script fait Z ? »*. 📖 **[Consulte l'inventaire](./inventory.md)** — référence exhaustive, à consulter au besoin (pas à lire d'un trait). Ce qu'elle couvre : - Localisation des skills, agents, hooks, scripts dans le repo - Liste des outils MCP et de la doctrine - Variables d'environnement - Comment contribuer un nouvel artefact --- ## Comment NEX marche, en une page NEX repose sur trois composants : ### 1. Une **doctrine** partagée Toutes les conventions Kiliogene (stack, méthodo, conventions de code, infra, sécurité) vivent dans **un seul repo** : [`kiliogene/nex`](https://github.com/kiliogene/nex). C'est la source de vérité unique. Si quelque chose n'y est pas documenté, c'est qu'il n'existe pas encore en tant que convention. Tu n'as **pas besoin** de tout connaître par cœur. Quand tu as un doute, ta session Claude Code consulte la doctrine automatiquement. ### 2. Un **outillage** pour appliquer la doctrine Des skills Claude Code (`/nex-onboard-me`, `/nex-onboard-project`, `/handoff`), des scripts d'onboarding, un serveur central qui sert la doctrine à toutes les sessions, des hooks qui injectent le bon contexte au bon moment. Tu n'as quasiment rien à configurer — la procédure collaborateur s'occupe de tout. ### 3. Une **autonomie technique** assumée C'est la règle qui surprend le plus. Dans NEX, **les questions techniques ne remontent pas au CEO**. Ta session Claude Code (et toi par extension) tranche stack, code, schéma, refactor, infra, tooling. Le CEO n'intervient que sur les questions qui ne se résolvent pas dans le code : périmètre fonctionnel, règle métier, conformité, priorisation, validation finale avant production. Cette règle est codifiée dans la doctrine et appliquée par tous les agents NEX. Elle te fait gagner du temps et permet au CEO de superviser plus de projets en parallèle. --- ## Pré-requis avant de commencer | Besoin | Status | |---|---| | **Compte GitHub** ajouté à l'organisation `kiliogene` | Le CEO te l'ajoute | | **Accès Passbolt** avec un partage actif sur les credentials NEX | Le CEO te l'envoie | | **Abonnement Claude Code** | Fourni par Kiliogene : **Max** pour les devs, **Pro** pour les autres salariés (ajustable à la hausse sur demande au CEO). Aucune API Anthropic facturée ([NEX-ADR-0013](../../decisions/0013-claude-subscription-not-api.md)). | | **Machine macOS ou Linux** récente | Windows : utilise WSL2 | Coût marginal pour Kiliogene par collaborateur sur l'infrastructure NEX : **0 €** (tailnet privé, MCP auto-hébergé, doctrine versionnée). L'abonnement Claude Code Max est pris en charge séparément par Kiliogene au titre de l'outillage standard du poste. --- ## Si tu es bloqué 1. **Cherche dans la doctrine** — ta session Claude Code peut interroger automatiquement la doctrine via le serveur NEX (méthode `search_decisions`). 95 % des questions ont déjà une réponse documentée. 2. **Consulte l'inventaire** ([`inventory.md`](./inventory.md)) — pour les questions du type "où ça vit ?" / "comment l'utiliser ?". 3. **Ping le canal Slack `#nex`** — pour ce qui n'est pas couvert par la doctrine. 4. **Ouvre une issue sur le repo** — si tu identifies un trou (procédure manquante, doc obsolète, friction) : [github.com/kiliogene/nex/issues](https://github.com/kiliogene/nex/issues) avec le label `project-signal`. Tu n'es **pas** censé compenser silencieusement — les frictions remontent, les outils s'améliorent. 5. **Demande au CEO** — en dernier recours, et seulement pour les questions fonctionnelles ou métier (pas techniques). La doctrine est claire sur ce point pour ne pas saturer son temps. --- ## Ressources clés | Quoi | Où | |---|---| | **Procédure collaborateur** (la doc que tu dois lire en premier après ce README) | [`./collaborateur.md`](./collaborateur.md) | | **Procédure projet** | [`./projet.md`](./projet.md) | | **Inventaire des outils** | [`./inventory.md`](./inventory.md) | | **Doctrine complète** | [github.com/kiliogene/nex](https://github.com/kiliogene/nex) | | **Doctrine publique** (sans login) | [nex.kiliogene.com/doctrine/methodology.md](https://nex.kiliogene.com/doctrine/methodology.md) | | **Manuel cross-projets** | [`USAGE.md`](../../USAGE.md) | | **Canal Slack** | `#nex` (interne) | --- **Prochaine étape** : tu sais maintenant pourquoi tu es là. Choisis l'une des trois procédures ci-dessus selon ton cas et lance-toi. Bienvenue dans la boucle. 🚀