119 lines
3.6 KiB
Markdown
119 lines
3.6 KiB
Markdown
<!-- file: deltas/0.0.3/pre.001-fix.003.md -->
|
||
<!-- version: 1 -->
|
||
|
||
# Delta 0.0.3-pre.001-fix.003
|
||
|
||
## Base requise
|
||
|
||
`0.0.3-pre.001-fix.002`.
|
||
|
||
## Objectif
|
||
|
||
Finaliser le cadrage de `pre.001` concernant les prompts et le dimensionnement des futures phases :
|
||
|
||
- déplacer la convention des prompts sous la documentation normative ;
|
||
- conserver `prompts/` uniquement pour les prompts eux-mêmes ;
|
||
- ajouter l'état validé à préserver et les sources externes normatives ;
|
||
- définir un budget de complexité pour les prereleases intermédiaires ;
|
||
- imposer le découpage d'une session/version lorsque le prompt prévu devient trop lourd ;
|
||
- renuméroter le brouillon `0.1.x` après déplacement de la convention.
|
||
|
||
## Version Cargo
|
||
|
||
Aucune modification de `Cargo.toml`.
|
||
|
||
Ce correctif est exclusivement documentaire. `workspace.package.version` reste :
|
||
|
||
```text
|
||
0.0.3-pre.1
|
||
```
|
||
|
||
## Fichiers ajoutés
|
||
|
||
- `docs/rules/PROMPT_STRUCTURE.md`
|
||
- `prompts/001-V0_1_X_START_PROMPT.md`
|
||
- `deltas/0.0.3/pre.001-fix.003.md`
|
||
|
||
## Fichiers modifiés
|
||
|
||
- `RULES.md`
|
||
- `docs/000-README.md`
|
||
- `docs/rules/FILE_CONTRACTS.md`
|
||
- `docs/plans/001-V0_0_3_PLAN.md`
|
||
- `prompts/000-README.md`
|
||
|
||
## Fichiers supprimés
|
||
|
||
- `prompts/001-PROMPT_STRUCTURE.md`
|
||
- `prompts/002-V0_1_X_START_PROMPT.md`
|
||
|
||
Le contenu du premier est déplacé et renforcé sous `docs/rules/PROMPT_STRUCTURE.md`.
|
||
|
||
Le second est renommé en `prompts/001-V0_1_X_START_PROMPT.md` et mis à jour.
|
||
|
||
## Décisions ajoutées
|
||
|
||
### Emplacement des conventions de prompt
|
||
|
||
Les règles/conventions de rédaction des prompts sont normatives et appartiennent à `docs/rules/PROMPT_STRUCTURE.md`.
|
||
|
||
Le répertoire `prompts/` contient uniquement l'index pratique et les prompts de reprise.
|
||
|
||
### Première et dernière prerelease
|
||
|
||
Par défaut :
|
||
|
||
- `pre.001` = brainstorming/audit si nécessaire + planification + découpage ;
|
||
- dernière prerelease = validations finales + documentation + nettoyage/archivage + prompt suivant.
|
||
|
||
### Budget des prereleases
|
||
|
||
Lors de la planification, chaque prerelease intermédiaire après `pre.001` doit viser une charge bornée.
|
||
|
||
Une tranche estimée à plus d'environ 15–20 minutes de travail effectif doit être scindée avant développement.
|
||
|
||
Cette durée est un budget de planification, pas une promesse d'exécution.
|
||
|
||
### Contrôle anti-saturation
|
||
|
||
Avant finalisation d'un prompt de session suivante, la charge totale de la session prévue doit être évaluée.
|
||
|
||
Si elle paraît trop importante pour conserver un contexte fiable et une qualité de travail correcte, le plan est réparti sur :
|
||
|
||
- plusieurs sessions ;
|
||
- et/ou plusieurs versions lorsque la frontière fonctionnelle le justifie.
|
||
|
||
Le roadmap conserve sa ligne directrice même si son découpage initial évolue.
|
||
|
||
### Qualité des prompts
|
||
|
||
La structure KSP inclut désormais explicitement :
|
||
|
||
- base requise ;
|
||
- état validé à préserver ;
|
||
- sources de vérité internes ;
|
||
- sources externes normatives lorsqu'elles existent ;
|
||
- décisions acquises ;
|
||
- objectifs/hors périmètre ;
|
||
- plan souple ;
|
||
- validations ;
|
||
- critères de sortie ;
|
||
- préparation de la suite.
|
||
|
||
Cette structure reprend les qualités utiles observées dans les prompts historiques tout en évitant de recopier les règles et l'architecture déjà normalisées dans le dépôt.
|
||
|
||
## Questions ouvertes
|
||
|
||
Aucune nouvelle question bloquante pour `pre.001`.
|
||
|
||
Les questions architecturales restantes sont poursuivies dans `pre.002+`.
|
||
|
||
## Validations
|
||
|
||
Correctif documentaire uniquement :
|
||
|
||
- présence des en-têtes `file:` / `version:` vérifiée sur les fichiers livrés ;
|
||
- cohérence des chemins `prompts/` / `docs/rules/` vérifiée dans cette livraison ;
|
||
- aucune commande Cargo requise ;
|
||
- aucune modification fonctionnelle ou runtime.
|