This commit is contained in:
2026-08-13 16:09:07 +02:00
parent 5f6c2ef45e
commit 199550bc82
25 changed files with 1233 additions and 1 deletions

27
RULES.md Normal file
View File

@@ -0,0 +1,27 @@
<!-- file: RULES.md -->
<!-- version: 1 -->
# Index normatif KSP
`RULES.md` est le point d'entrée obligatoire des règles de `khadhroony-solana-project`.
Les règles détaillées sont maintenues sous `docs/rules/` et sont cumulatives selon leur périmètre.
## Documents normatifs
1. [`docs/rules/RULES_GENERAL.md`](docs/rules/RULES_GENERAL.md) — règles universelles du dépôt et hiérarchie normative ;
2. [`docs/rules/RULES_RUST.md`](docs/rules/RULES_RUST.md) — règles applicables aux sources et crates Rust ;
3. [`docs/rules/RULES_KSP.md`](docs/rules/RULES_KSP.md) — conventions et frontières spécifiques à KSP ;
4. [`docs/rules/RULES_DOCUMENTATION.md`](docs/rules/RULES_DOCUMENTATION.md) — règles des documents Markdown et de leur cycle de vie ;
5. [`docs/rules/FILE_CONTRACTS.md`](docs/rules/FILE_CONTRACTS.md) — rôle et mode de modification des principales familles de fichiers ;
6. [`docs/rules/VERSION_WORKFLOW.md`](docs/rules/VERSION_WORKFLOW.md) — versions, prereleases, correctifs, deltas, sessions et livraisons.
## Hiérarchie
Une règle possède une portée explicite. Les règles plus spécifiques peuvent ajouter des contraintes aux règles plus générales, mais ne peuvent pas les affaiblir silencieusement.
Toute exception doit être explicite, locale, bornée, justifiée et documentée dans le delta qui l'introduit. Une exception durable devra être reportée dans un document normatif dédié avant clôture de la session concernée.
Une règle non encore décidée ne doit pas être inventée pour combler un vide : elle reste une question ouverte dans le delta ou le document de planification actif.
Une validation n'est déclarée réussie que si elle a réellement été exécutée.