@legba-core — dossier de projet

Déposer l’ensemble de ces fichiers dans le projet Claude legba-core. Chaque fichier fait moins de 500 lignes, par construction.

Fichier	Rôle
`00-README-PROJET.md`	Ce document : point d’entrée et règles du projet
`01-TESTING.md`	Stratégie de tests : 5 niveaux, seuils, portes de qualité
`02-MCP-DOCS.md`	Convention de documentation lisible par un LLM via MCP
`03-BACKLOG-LEGBA.md`	Backlog `@legba-core` avec scénarios et tests d’acceptation
`04-BACKLOG-TOOLBOX.md`	Backlog KC Toolbox (en pause) avec la même rigueur
`05-RAPPORT-GABARIT.md`	Gabarit du rapport d’avancement aux 3 heures

Règles non négociables

Aucun fichier source de plus de 500 lignes. La limite est vérifiée en CI et fait échouer la construction.
Un seul billet en cours à la fois. Le suivant ne démarre pas tant que le précédent n’est pas VALIDÉ.
Un billet est VALIDÉ seulement si tous ses tests d’acceptation passent, à tous les niveaux applicables décrits dans 01-TESTING.md.
Chaque module publie sa documentation MCP selon 02-MCP-DOCS.md, dans le même commit que le code.
Jamais de logique propre au KC Toolbox dans ce framework.
Aucun credential n’est écrit dans le dépôt, les tests ou la documentation.

Cycle de vie d’un billet

À FAIRE
   ↓  (scénarios relus et acceptés par l'utilisateur)
PRÊT
   ↓  (implémentation + tests écrits)
EN COURS
   ↓  (tous les tests d'acceptation passent en CI)
EN REVUE
   ↓  (documentation MCP à jour, limite de 500 lignes respectée)
VALIDÉ

Un billet qui échoue à une porte retourne à EN COURS. Il n’est jamais contourné.

Convention de nommage

Billets : LGB-<numéro>
Branches : feature/LGB-<numéro>-<intitulé-court>
Commits : LGB-<numéro>: <description à l'impératif>

Licence

@legba-core est publié sous AGPL v3 (fichier LICENSE à la racine). Toute entité qui fait tourner une version modifiée comme service réseau doit publier ses modifications sous la même licence. Une entreprise qui veut intégrer Legba sans publier ses modifications, ou l’héberger en SaaS propriétaire, doit obtenir une licence commerciale séparée — à définir avec Konb-IT (double licence, non encore mise en place).

Espace de noms npm

@legba était déjà pris par un tiers (alliants-chris, paquets @legba/js et @legba/node, sans rapport avec ce projet). Le scope retenu est @legba-core — organisation npm créée, wclervilus en owner, réservation validée par une publication d’essai 0.0.0 suivie d’une dépublication forcée. Tous les noms de paquets du backlog utilisent ce scope (@legba-core/core, @legba-core/realtime, @legba-core/ui, etc.).

Décisions ouvertes, bloquantes

Aucune.

Règles du projet