0.0.2-alpha.4
This commit is contained in:
26
docs/templates/001-NEW_SESSION_PROMPT.md
vendored
Normal file
26
docs/templates/001-NEW_SESSION_PROMPT.md
vendored
Normal 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
33
docs/templates/002-RELEASE_PLAN.md
vendored
Normal 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
29
docs/templates/003-OPERATOR_HANDOFF.md
vendored
Normal 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.
|
||||
37
docs/templates/004-RUST_LIBRARY_CRATE.md
vendored
Normal file
37
docs/templates/004-RUST_LIBRARY_CRATE.md
vendored
Normal 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.
|
||||
Reference in New Issue
Block a user