Communitygithub.com

samuelaure/engineering-protocols

Le registre complet du dépôt, la cohérence de la stack technique, le niveau de qualité qui rend un projet digne d'un portfolio, et la publication d'un projet sur le site personnel. À charger avant de démarrer un nouveau projet, de choisir une stack, de décider si quelque chose existe déjà, ou de présenter un travail publiquement.

Qu'est-ce que engineering-protocols ?

Cette compétence fournit un registre complet de l'ensemble du portfolio de développement de Samuel, comprenant plus de 40 dépôts GitHub, des projets locaux et non versionnés. Elle est conçue pour éviter deux modes de défaillance principaux : la duplication (construire quelque chose qui existe déjà ailleurs dans le portfolio) et la divergence (utiliser un nouveau framework pour le même type de produit). La compétence définit une barre de qualité claire pour les projets dignes d'un portfolio, avec des exigences telles qu'un README fonctionnel, une CI fonctionnelle, l'absence de secrets, l'absence d'artefacts d'agent AI, un état honnête et une documentation adaptée. Elle impose également la cohérence de la stack technique, recommandant TypeScript, React, Vite, Next.js, NestJS, Postgres, Prisma, Docker, Remotion et Tailwind comme pile par défaut. Actuellement, la partie présentation du portfolio n'est pas encore définie. La compétence s'applique à tout agent AI (Claude Code, Cursor, etc.) travaillant dans l'environnement de développement de Samuel. Elle est stockée sous forme de fichier Markdown et synchronisée avec `~/.claude/`.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samuelaure/engineering-protocols/tree/HEAD/skills/portfolio

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Portefeuille

40 dépôts sur GitHub, 25 clonés dans ~/code, plus du travail non versionné. Samuel travaille seul sur des domaines très différents, donc les deux modes de défaillance sont la duplication (construire quelque chose qui existe déjà ailleurs dans le portefeuille) et la divergence (un nouveau framework pour le même type de produit). Lisez ceci avant l'un ou l'autre.

⚠️ Question ouverte — la présentation n'est pas encore définie

Samuel n'a pas décidé comment les projets sont présentés dans la section portefeuille de samuelaure-web, ni comment ils devraient apparaître sur nau-web, ni si l'agence aura besoin de sa propre variante.

Tant que cela n'est pas décidé, cette compétence peut appliquer la moitié qualité (normes de dépôt, documentation) mais pas la moitié publication. Si le travail touche à la section portefeuille de samuelaure-web, ou si un projet atteint un état qui mérite d'être montré, posez la question à ce moment-là — c'est le moment de le concevoir, et cela doit être conçu une fois et appliqué de manière cohérente plutôt qu'improvisé par projet.

Actif (90 derniers jours)

DépôtStackDescription
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · RemotionPlateforme naŭ. 2055 commits. Le système principal
nau-mobileExpo SDK 50 · React Native · SQLiteApplication de capture Instagram. Dépôt autonome, local-first
groovyGrails → NestJS · DockerLaboratoire de migration d'API — pattern strangler sur une API Grails legacy
websites/nau-webAstro · ExpressSite marketing naŭ
websites/karenexplora-webVite · ExpressSite client
websites/violetacuesta-webVite · TS · DockerSite client, déployé sur le VPS
websites/samuelaure-webVite · TSSite personnel — héberge la section portefeuille
websites/andiuniverso-webVite · TSSite client
karenexplora-freescoutDockerDéploiement de helpdesk auto-hébergé
countdown-videoReact · RemotionGénération vidéo programmatique
nispirasKotlin · Android nativeApplication de superposition respiratoire. Livre son propre keystore — ne pas le régénérer
engineering_protocolsMarkdownCes protocoles. Source de vérité pour ~/.claude/

En sommeil

advent-of-code (TS) · obsidian · carrousel-automation (React/Remotion/Tailwind) · apify-actors (TS) · web-chatbot-widget (TS, Docker) · math-app (Vite) · topic-roulette (Next 16, Tailwind — pas de dépôt distant) · video-generator (NestJS) · whatsapp-number-checker (Express) · youtube-downloader (TS — pas de dépôt distant) · websites/polar-web (dernière modification 2025-12)

Obsolète

Dans ~/code/deprecated/ : echonau, komunikadoj, nau-ig, r2-asset-manager.

nau-ig est l'ancêtre de nau-mobile — l'application a été extraite, absorbée dans le monorepo, puis retirée. Ne pas confondre les trois.

Sur GitHub, non cloné

Dépôts de services pré-consolidation, maintenant dans le monorepo nau : 9nau, flownau, nauthenticity, whatsnau, zazu. Ne pas cloner ceux-ci pour travailler sur ces services — ils vivent dans nau/apps/. (Deux d'entre eux sont également des dépôts git imbriqués dans nau/tmp/, ce qui est du désordre.)

Autres non clonés : ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9, project_1, samuel-aure, adventofcodeOLD, nau-storage.

Non versionné — à risque

~/code/no-git/ contient neuf répertoires en dehors de git : build-mobile, chrome-extensions, flownau, gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script.

Une panne de disque et ils disparaissent, et kkj_db_backups semble être des sauvegardes de base de données sans sauvegarde propre. Un audit avec une recommandation par répertoire est approuvé et en attente.

Cohérence de la stack

Le portefeuille a convergé vers : TypeScript · React · Vite pour les sites · Next pour les applications · NestJS pour les services · Postgres + Prisma · Docker · Remotion pour la vidéo · Tailwind.

Lorsqu'un projet n'a pas d'exigence technique spécifique, choisissez dans cet ensemble. La cohérence se cumule en maîtrise et rend chaque projet moins coûteux à maintenir ; un nouveau framework par projet se cumule en maintenance dont personne n'a le temps.

Divergence connue à résoudre : six sites web, quatre approches — karenexplora-web, samuelaure-web, violetacuesta-web et andiuniverso-web sur Vite, nau-web sur Astro, polar-web inconnu. Ce sont le même type de produit. Avant d'en construire un septième, choisissez-en un et dites pourquoi ; converger les six existants vaut la peine d'être planifié.

La barre de qualité

Un dépôt est digne d'un portefeuille lorsque quelqu'un peut le trouver, le comprendre et l'exécuter sans rien demander à Samuel.

  • Un README qui mérite sa longueur. Ce que c'est, pourquoi ça existe, comment l'exécuter, et la ou les deux décisions qui étaient réellement intéressantes. Pas un tutoriel, pas un brouillon. Si un lecteur ne peut pas le faire fonctionner à partir du seul README, ce n'est pas terminé.
  • CI fonctionnelle là où cela a du sens. Un badge vert est une preuve ; un badge cassé est pire qu'aucun.
  • Pas de secrets, jamais — et pas non plus dans l'historique.
  • Pas d'artefacts d'agent. CLAUDE.md, .claude/, .agent/ sont globalement gitignorés et versionnés dans engineering_protocols/projects/<repo>/. Un dépôt qui fait la publicité de ses outils AI donne l'impression d'avoir été écrit par une IA à quiconque l'évalue. Les omettre laisse la question ouverte, et la réponse honnête — oui, avec des protocoles d'ingénierie derrière — passe mieux venant de Samuel que d'un fichier.
  • État honnête. Un README revendiquant un statut de production pour quelque chose de cassé coûte plus de crédibilité qu'un projet inachevé. nau-mobile a passé des mois à se déclarer obsolète tout en étant le dépôt actif ; c'est le mode de défaillance à éviter.
  • Documentation ni clairsemée ni excessive. Les docs qui décrivent ce que le code dit déjà sont de la dette de maintenance ; les docs qui capturent la décision non évidente, la contrainte ou le piège se remboursent d'elles-mêmes. Quand les docs et le code ne sont pas d'accord, les docs sont le bogue.

Maintenir ceci à jour

Lorsqu'un dépôt est ajouté, supprimé, renommé, change de stack ou passe entre actif et en sommeil, mettez à jour ce fichier et le tableau dans global/CLAUDE.md, dans le cadre de ce travail. Ensuite, synchronisez vers ~/.claude/. Un registre qui dérive est pire qu'aucun registre, car il est digne de confiance.

Skills associés