0.5.1-pre.002

ks-core/README.md

@@ -0,0 +1,37 @@
+<!-- file: ks-core/README.md -->
+<!-- version: 5 -->
+
+# ks-core
+
+`ks-core` fournit les primitives minimales partagées par l’ensemble de `khadhroony-bot3`.
+
+## Responsabilités
+
+- type d’erreur explicite commun au workspace ;
+- alias `Result<T>` ;
+- identité stable des modules ;
+- classification des grandes familles de traitement.
+
+La crate reste volontairement petite et ne dépend d’aucune couche fonctionnelle supérieure.
+
+## API publique
+
+- `Error` ;
+- `Result<T>` ;
+- `ModuleName` ;
+- `ModuleVersion` ;
+- `ModuleKind`.
+
+Voir [USAGE.md](USAGE.md) pour les exemples.
+
+## Relations
+
+`ks-core` est utilisée par toutes les crates qui ont besoin d’un contrat d’erreur ou d’une identité de module partagée. Elle ne contient ni configuration, ni transport, ni stockage, ni logique Solana.
+
+## Documentation
+
+- [USAGE.md](USAGE.md)
+- [TODO.md](TODO.md)
+- [CHANGELOG.md](CHANGELOG.md)
+- [Architecture générale](../docs/architecture/ARCHITECTURE.md)
+- [Carte des crates](../docs/architecture/CRATE_MAP.md)