mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-04-06 21:41:42 +02:00
Align BMAD paths with new knowledge structure and automate project registry sync
This commit is contained in:
57
70_templates/capitalisation_patch_claude_projet.md
Normal file
57
70_templates/capitalisation_patch_claude_projet.md
Normal 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.
|
||||
22
70_templates/capitalisation_patch_knowledge.md
Normal file
22
70_templates/capitalisation_patch_knowledge.md
Normal 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é.
|
||||
57
70_templates/capitalisation_patch_knowledge_pattern.md
Normal file
57
70_templates/capitalisation_patch_knowledge_pattern.md
Normal 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
|
||||
44
70_templates/capitalisation_patch_knowledge_risque.md
Normal file
44
70_templates/capitalisation_patch_knowledge_risque.md
Normal 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
|
||||
62
70_templates/capitalisation_tri_rapport.md
Normal file
62
70_templates/capitalisation_tri_rapport.md
Normal 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.
|
||||
Reference in New Issue
Block a user