0.0.2-alpha.4

This commit is contained in:
2026-09-28 22:42:48 +02:00
parent b9508b0228
commit 3f8c795cc0
34 changed files with 2108 additions and 249 deletions

View File

@@ -0,0 +1,26 @@
<!-- file: docs/templates/001-NEW_SESSION_PROMPT.md -->
<!-- version: 1 -->
# Pattern local — prompt de nouvelle session
## Usage
Ce pattern prépare le court message opérateur remis après une stable Knowledge publiée. Le prompt détaillé reste un fichier versionné sous `prompts/`.
Une session normale Knowledge ne consulte pas PGR. Une mention PGR n'apparaît que lorsque la release cible contient explicitement une réévaluation/adoption PGR.
## Forme normale
Lorsque le rapport post-tag de la baseline est `PASS` :
```text
Partir de l'archive sasedev-knowledge-vX.Y.Z.zip téléchargée depuis le tag Gitea vX.Y.Z et du rapport post-tag sasedev-knowledge-X.Y.Z-publish.001-report.md. Lire et exécuter prompts/NNN-<NEXT_RELEASE>_START_PROMPT.md. Vérifier intégralement l'archive Knowledge, les règles locales, la gouvernance, l'architecture, la structure documentaire, les deltas/histories, les décisions différées et la cohérence globale avant de préparer <NEXT_RELEASE>-alpha.1.
```
`X.Y.Z` désigne la stable autoritaire de départ et `<NEXT_RELEASE>` la release suivante réellement décidée ; ces deux valeurs ne sont pas supposées identiques.
Les noms et versions sont remplacés uniquement par des valeurs établies. Si le rapport post-tag n'existe pas ou n'est pas `PASS`, il n'est pas présenté comme preuve.
## Réévaluation externe explicite
Si et seulement si le plan de la release contient une adoption externe, le prompt peut demander de fournir en plus l'archive/rapport exacts du référentiel concerné. Cette exception doit être visible dans le scope du prompt ; elle ne devient jamais le comportement par défaut des sessions suivantes.

33
docs/templates/002-RELEASE_PLAN.md vendored Normal file
View File

@@ -0,0 +1,33 @@
<!-- file: docs/templates/002-RELEASE_PLAN.md -->
<!-- version: 1 -->
# Pattern local — plan de release
## Contrat minimal
Un plan multi-tranches Knowledge utilise normalement :
```text
## Statut et sources
## Mission
## État acquis et questions ouvertes
## Scope
## Hors scope
## Stratégie de validation
## Trajectoire prévisionnelle
### alpha.N — ...
### beta.N — ...
### rc.N — ...
### rel.N — ...
## Déclencheurs de REPLAN
## Clôture et transition
## Revue d'horizon
```
Le nombre de tranches n'est pas fixé. Les phases annoncées restent sous `## Trajectoire prévisionnelle` avec un heading `###`.
## Règles
Le plan pilote le travail restant ; il n'est pas un journal de commandes. Les preuves détaillées vivent dans `history/` et les règles durables vivent chez leur owner local.
Un REPLAN met à jour la trajectoire et les responsabilités devenues fausses. Aucune version postérieure n'est réservée uniquement pour remplir la roadmap.

29
docs/templates/003-OPERATOR_HANDOFF.md vendored Normal file
View File

@@ -0,0 +1,29 @@
<!-- file: docs/templates/003-OPERATOR_HANDOFF.md -->
<!-- version: 1 -->
# Pattern local — handoff opérateur
## Après un history de prerelease
Lorsque `origin/master` est établi :
```bash
git add -A
git diff --cached --check
git status --short
git commit -m "<VERSION_DE_LA_TRANCHE>"
git push origin master
git status --short
```
Si le delta suivant est livré dans la même réponse, son application vient seulement après ce bloc.
## Après un FAIL suivi d'un fix
Le history `FAIL` est appliqué et committé avec l'identité de la tranche en échec avant d'appliquer `.fix.N`. Il n'est jamais remplacé ou fusionné avec le futur history `PASS`.
## Première fermeture stable
La première tranche `rel.N[/fix.M]` qui obtient le `PASS` stable est committée avec le message produit `X.Y.Z`, puis le tag `vX.Y.Z` est créé/poussé selon la politique locale et vérifié avant le rapport post-tag.
Les commandes exactes de tag/publication sont fournies avec les valeurs réellement établies au moment de la clôture.

View File

@@ -0,0 +1,37 @@
<!-- file: docs/templates/004-RUST_LIBRARY_CRATE.md -->
<!-- version: 1 -->
# Pattern local — crate bibliothèque Rust
## But
Ce pattern illustre la structure minimale attendue d'une crate bibliothèque Knowledge. Il ne crée pas une crate par anticipation et ne remplace pas [`../rules/510-RUST_CARGO.md`](../rules/510-RUST_CARGO.md).
## Façade
`src/lib.rs` reste une façade :
```rust
//! Documentation de crate.
mod responsibility;
/// Contrat public exposé par la crate.
pub use self::responsibility::PublicItem;
```
Les définitions résident dans le module propriétaire :
```rust
// file: crates/<crate>/src/responsibility.rs
// version: 1
/// Contrat public possédé par cette responsabilité.
pub struct PublicItem;
```
Pour plusieurs responsabilités distinctes, créer plusieurs modules nommés selon leur rôle réel. Ne pas créer un fichier `api.rs`, `common.rs` ou `utils.rs` uniquement pour déplacer du code sans clarifier l'ownership.
## Tests
Les tests unitaires vivent sous `unit_tests/` et sont rattachés au module source correspondant. Les tests d'intégration vivent sous `tests/` et consomment l'API publique.