khadhroony-solana-project/deltas/0.0.3/pre.001-fix.003.md

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 :

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.