Align BMAD paths with new knowledge structure and automate project registry sync

This commit is contained in:
MaksTinyWorkshop
2026-03-28 10:18:24 +01:00
parent 75c3303271
commit 9fe3ad027e
24 changed files with 671 additions and 28 deletions

View File

@@ -0,0 +1,57 @@
# Patch de déplacement — CLAUDE.md projet
Date : <YYYY-MM-DD>
Source : `95_a_capitaliser.md`
Motif : proposition pertinente mais trop spécifique projet
---
## Cible projet
Projet : `<nom_projet>`
Chemin résolu : `</srv/projects/<nom_projet>/CLAUDE.md | chemin attendu>`
Section cible : `<Leçons apprises | Points sensibles | Patterns critiques appliqués dans ce projet>`
Type d'insertion : `<ajout en fin de section | fusion avec item existant | remplacement item obsolète>`
## Texte à intégrer (format conforme CLAUDE.md projet)
### Option A — Leçons apprises (par défaut)
```md
- <apprentissage court, factuel, orienté action>
```
### Option B — Points sensibles (si vigilance continue)
```md
- <zone de risque à surveiller> (<LOW | MEDIUM | HIGH>)
```
### Option C — Pattern critique projet (si règle locale stable)
````md
### <Nom du pattern spécifique projet>
<Règle locale concise + pourquoi elle existe dans ce projet>
```typescript
// exemple minimal (optionnel)
```
````
## Vérification de conformité
- [ ] Rédaction en français
- [ ] Contenu spécifique au projet (pas inter-projets)
- [ ] Formulation exploitable en review future (checklist mentale claire)
- [ ] Pas de conflit avec une règle globale existante
- [ ] Section cible cohérente avec la nature du contenu
- [ ] Style aligné avec le `CLAUDE.md` réel du projet (phrases courtes, concret, zéro théorie)
## Règles d'écriture
- Préférer des bullets courtes et actionnables pour `Leçons apprises` et `Points sensibles`.
- Éviter les paragraphes longs non opérables.
- Mentionner la stack/zone concernée seulement si cela aide la relecture.
- Si une règle est locale à un écran/module précis, conserver le nom technique exact (`route`, `store`, `module`) pour éviter l'ambiguïté.
- Ne pas copier-coller un texte knowledge global tel quel dans le projet; adapter au contexte du repo.

View File

@@ -0,0 +1,22 @@
# Patch d'intégration — Knowledge globale (index)
Date : <YYYY-MM-DD>
Source : `95_a_capitaliser.md`
Mode : intégration manuelle validée
---
## Choix du template selon la cible
- Si la cible est `knowledge/**/patterns/*.md` : utiliser `capitalisation_patch_knowledge_pattern.md`
- Si la cible est `knowledge/**/risques/*.md` : utiliser `capitalisation_patch_knowledge_risque.md`
- Si la cible est un fichier global racine (`10_conventions_redaction.md`, `40_decisions_et_archi.md`, `90_debug_et_postmortem.md`) : adapter le template le plus proche et conserver la checklist de conformité.
---
## Règle de routage rapide
1. Le contenu décrit une pratique recommandée, avec contexte d'usage et limites → `Pattern`
2. Le contenu décrit d'abord un piège, ses symptômes et sa mitigation → `Risque`
En cas de doute, préférer `Risque` pour éviter de promouvoir un pseudo-pattern non stabilisé.

View File

@@ -0,0 +1,57 @@
# Patch d'intégration — Knowledge globale — Pattern
Date : <YYYY-MM-DD>
Source : `95_a_capitaliser.md`
Type : `Pattern`
---
## Cible
Fichier : `<knowledge/<domaine>/patterns/<theme>.md>`
Type de patch : `<ajout | fusion | remplacement>`
## Texte à intégrer (structure de référence)
````md
<a id="pattern-<slug>"></a>
## Pattern : <Nom du pattern>
### Synthèse
- **Objectif** : <résultat recherché>
- **Contexte** : <stack / architecture>
- **Quand l'utiliser** : <cas d'usage>
- **Quand l'éviter** : <limites>
### Analyse
- **Avantages** :
- ...
- **Limites / vigilance** :
- ...
### Validation
- Validé le : <DD-MM-YYYY>
- Contexte technique : <stack> — <projet source> <DD-MM-YYYY>
### Implémentation (exemple minimal)
```typescript
// exemple concret court
```
### Checklist
- [ ] <critère de vérification 1>
- [ ] <critère de vérification 2>
````
## Vérification de conformité
- [ ] Le contenu décrit un pattern réutilisable inter-projets
- [ ] Structure alignée avec les patterns existants (`Synthèse`, `Analyse`, `Validation`, `Implémentation`, `Checklist`)
- [ ] Exemples concrets, pas de théorie vague
- [ ] Terminologie alignée avec le fichier cible
- [ ] Pas de doublon exact ou sémantique

View File

@@ -0,0 +1,44 @@
# Patch d'intégration — Knowledge globale — Risque
Date : <YYYY-MM-DD>
Source : `95_a_capitaliser.md`
Type : `Risque`
---
## Cible
Fichier : `<knowledge/<domaine>/risques/<theme>.md>`
Type de patch : `<ajout | fusion | remplacement>`
## Texte à intégrer (structure de référence)
```md
<a id="risque-<slug>"></a>
## <Titre du risque>
### Risques
- <risque principal>
- <impact concret>
### Symptômes
- <signal observable 1>
- <signal observable 2>
### Bonnes pratiques / mitigations
- <mitigation actionnable 1>
- <mitigation actionnable 2>
- Contexte technique : <stack> — <projet source> <DD-MM-YYYY>
```
## Vérification de conformité
- [ ] Le contenu documente d'abord un piège (pas un pattern prescriptif)
- [ ] Structure alignée avec les risques existants (`Risques`, `Symptômes`, `Bonnes pratiques / mitigations`)
- [ ] Mitigations testables en review/dev
- [ ] Terminologie alignée avec le fichier cible
- [ ] Pas de doublon exact ou sémantique

View File

@@ -0,0 +1,62 @@
# Rapport de tri — 95_a_capitaliser.md
Date d'analyse : <YYYY-MM-DD>
Analysé par : <agent>
Source : `95_a_capitaliser.md`
---
## Résumé
- Total propositions : <N>
- `INTEGRER_KNOWLEDGE` : <N>
- `A_DEPLACER_CLAUDE_PROJET` : <N>
- `REJETER` : <N>
---
## Détail par proposition
### <DATE — PROJET> — <titre court>
Décision : <INTEGRER_KNOWLEDGE | A_DEPLACER_CLAUDE_PROJET | REJETER>
Confiance : <HIGH | MEDIUM | LOW>
Justification :
- Nouveauté : <DOUBLON_EXACT | DOUBLON_SEMANTIQUE | COMPLEMENT | NOUVEAU>
- Portée : <GLOBAL | PROJET>
- Motif principal : <1 phrase>
Action proposée :
- Si `INTEGRER_KNOWLEDGE` :
- Fichier : `<knowledge/... .md>`
- Patch logique : `<ajout | fusion | remplacement>`
- Texte final proposé :
```md
## <Titre>
<Rédaction finale courte, factuelle, orientée mitigation>
```
- Si `A_DEPLACER_CLAUDE_PROJET` :
- Projet : `<nom_projet>`
- Fichier : `</srv/projects/<nom>/CLAUDE.md ou chemin attendu>`
- Section : `<Leçons apprises | Points sensibles>`
- Texte final proposé :
```md
- <Leçon projet concise et actionnable>
```
- Si `REJETER` :
- Raison : `<doublon | bruit | non actionnable>`
---
## Choix d'action
1. Suivre les recommandations : intégrer les entrées retenues + purger `95_a_capitaliser.md` pour les éléments traités.
2. Ajuster avant intégration : appliquer les modifications demandées puis proposer une version finale.
3. N'intégrer que les entrées `INTEGRER_KNOWLEDGE`.
4. N'intégrer aucune entrée : conserver le rapport uniquement.