Files
khadhroony-solana-project/RULES.md
2026-08-13 16:09:07 +02:00

1.7 KiB

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 — règles universelles du dépôt et hiérarchie normative ;
  2. docs/rules/RULES_RUST.md — règles applicables aux sources et crates Rust ;
  3. docs/rules/RULES_KSP.md — conventions et frontières spécifiques à KSP ;
  4. docs/rules/RULES_DOCUMENTATION.md — règles des documents Markdown et de leur cycle de vie ;
  5. docs/rules/FILE_CONTRACTS.md — rôle et mode de modification des principales familles de fichiers ;
  6. 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.