30 lines
2.0 KiB
Markdown
30 lines
2.0 KiB
Markdown
<!-- file: RULES.md -->
|
|
<!-- version: 3 -->
|
|
|
|
# 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, responsabilités et frontières spécifiques à KSP ;
|
|
4. [`docs/rules/RULES_DEPENDENCIES.md`](docs/rules/RULES_DEPENDENCIES.md) — politique des dépendances externes, notamment Solana et protocoles ;
|
|
5. [`docs/rules/RULES_DOCUMENTATION.md`](docs/rules/RULES_DOCUMENTATION.md) — règles des documents Markdown et de leur cycle de vie ;
|
|
6. [`docs/rules/PROMPT_STRUCTURE.md`](docs/rules/PROMPT_STRUCTURE.md) — structure, cycle de vie et dimensionnement des prompts/sessions KSP ;
|
|
7. [`docs/rules/FILE_CONTRACTS.md`](docs/rules/FILE_CONTRACTS.md) — rôle et mode de modification des principales familles de fichiers ;
|
|
8. [`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, `docs/IDEAS.md` 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.
|