Projet open source

Node-Hexa CLI

On a nommé, positionné et lancé notre propre outil — parce qu'il n'existait pas.

Node-Hexa est un CLI open source publié sur npm sous @dawudesign/node-hexa-cli. Il enforce automatiquement l'architecture hexagonale et le DDD dans les projets TypeScript — scoring de 0 à 100, estimation de dette technique en jours-ingénieur, quality gates CI. En prod dans des équipes réelles.

Client

Dawudesign — Open source

Discipline

Projet open source

Secteur

Developer tooling

Année

2025

Node-Hexa CLI
Node-Hexa CLI01 / 04

Contexte

Les équipes TypeScript adoptent l'architecture hexagonale et le DDD par conviction — puis la dégradent par pragmatisme. Personne ne vérifie. Les conventions glissent, la dette s'accumule silencieusement, les revues de code ne détectent pas les violations structurelles. Aucun outil open source n'adressait ce problème avec la précision nécessaire.

Insight stratégique

“La gouvernance d'architecture ne peut pas reposer sur la discipline individuelle. Elle doit être automatisée, mesurée et bloquante en CI — exactement comme les tests. Un outil qui n'est pas dans la pipeline n'existe pas. Le nom devait l'affirmer dès le premier regard : pas un linter, pas un analyseur — une gouvernance.”

Le défi

Construire un CLI capable de scorer la conformité hexagonale sur des projets réels, estimer la dette en jours-ingénieur, s'intégrer dans GitHub Actions et GitLab CI sans friction — et trouver un nom qui positionne l'outil comme une référence dans son écosystème.

Notre réponse

Node-Hexa — deux mots, zéro ambiguïté : l'écosystème (Node) et l'architecture (Hexa). Positionné comme « architecture governance CLI », pas comme un linter. 8 commandes disponibles : init, generate, audit, history, check, list, doctor, demo. Rapports SARIF, JSON, HTML, badge SVG. Quality gate --fail-under configurable. Support NestJS, Express, Fastify, Next.js.

Ce qu'on a construit

Naming produit — Node-Hexa
Positionnement — « architecture governance CLI »
8 commandes CLI complètes
Moteur de scoring 0-100
Estimation dette technique en jours-ingénieur
Formats de sortie — SARIF, JSON, HTML, SVG
Intégration GitHub Actions / GitLab CI
Documentation complète + README

Ce que ça a changé

106

Téléchargements / semaine

v0.7.6

7 itérations en 2 mois

8

Commandes disponibles

Adopté sans campagne marketing — uniquement par la clarté du positionnement et la qualité de la documentation. 7 itérations majeures en moins de 2 mois. Utilisé dans des projets NestJS en production. L'outil s'est trouvé une audience parce qu'il résout un vrai problème avec un vrai nom.

Services

Product namingProduct identityOpen source

Secteurs

Developer toolingTypeScript / NestJS

Voir le projet