111 lines
3.0 KiB
Markdown
111 lines
3.0 KiB
Markdown
---
|
|
model: claude-opus-4-1-20250805
|
|
allowed-tools: Read, Write, Edit, Bash
|
|
argument-hint: [titre]
|
|
description: Génère un Architecture Decision Record (ADR) formaté et structuré
|
|
---
|
|
|
|
# Génération d'ADR
|
|
|
|
## Purpose
|
|
Génère un Architecture Decision Record (ADR) complet et structuré pour documenter les décisions architecturales importantes du projet.
|
|
|
|
## Variables
|
|
- **DECISION_TITLE**: Le titre de la décision architecturale
|
|
- **DECISION_NUMBER**: Le numéro séquentiel de l'ADR (auto-généré si non fourni)
|
|
|
|
## Instructions
|
|
- Si `TITRE` n'est pas fourni, ARRETER immediatement et demander à l'utilisateur de le fournir.
|
|
- Crée un ADR suivant le format standard RFC
|
|
- Utilise la numérotation séquentielle automatique
|
|
- Intègre le contexte du projet actuel
|
|
- Respecte les conventions de documentation du projet
|
|
|
|
## Relevant Files
|
|
- `docs/adr/` - Dossier contenant les ADR existants
|
|
- `docs/adr/README.md` - Liste des ADR existants
|
|
- `docs/README.md` - Contexte général du projet
|
|
- `CLAUDE.md` - Conventions et préférences
|
|
|
|
## Codebase Structure
|
|
```
|
|
docs/
|
|
adr/
|
|
0001-use-php-for-backend.md
|
|
0002-implement-elegant-objects.md
|
|
README.md
|
|
```
|
|
|
|
## Workflow
|
|
|
|
- Analyse les ADR existants pour déterminer le prochain numéro
|
|
- Examine le projet pour comprendre le contexte architectural
|
|
- Crée un nouveau fichier ADR avec la numérotation appropriée
|
|
- Utilise le template standardisé avec les sections requises
|
|
- Valide la cohérence avec les décisions précédentes
|
|
|
|
## Expertise
|
|
- Architecture logicielle et patterns de conception
|
|
- Documentation technique et ADR standards
|
|
- Conventions de nommage et organisation des documents
|
|
- Principles DDD et Elegant Objects (selon le contexte du projet)
|
|
|
|
## Template
|
|
```markdown
|
|
# ADR-XXXX: [Titre de la décision]
|
|
|
|
## Statut
|
|
- **Statut**: [Proposé | Accepté | Rejeté | Déprécié | Remplacé par ADR-YYYY]
|
|
- **Date**: YYYY-MM-DD
|
|
- **Auteurs**: [Noms]
|
|
- **Reviewers**: [Noms]
|
|
|
|
## Contexte
|
|
[Description du problème ou de la situation qui nécessite une décision]
|
|
|
|
## Décision
|
|
[La décision prise et sa justification]
|
|
|
|
## Conséquences
|
|
### Positives
|
|
- [Bénéfices attendus]
|
|
|
|
### Négatives
|
|
- [Coûts et risques identifiés]
|
|
|
|
### Neutres
|
|
- [Autres implications]
|
|
|
|
## Alternatives considérées
|
|
### Option 1: [Nom]
|
|
- **Avantages**: [Liste]
|
|
- **Inconvénients**: [Liste]
|
|
- **Raison du rejet**: [Explication]
|
|
|
|
### Option 2: [Nom]
|
|
- **Avantages**: [Liste]
|
|
- **Inconvénients**: [Liste]
|
|
- **Raison du rejet**: [Explication]
|
|
|
|
## Références
|
|
- [Liens vers documentation, discussions, tickets]
|
|
|
|
## Notes d'implémentation
|
|
[Détails techniques spécifiques pour l'implémentation]
|
|
```
|
|
|
|
## Examples
|
|
```bash
|
|
# Génération d'un ADR pour l'adoption d'un nouveau framework
|
|
/adr "Adoption du framework Symfony pour l'API"
|
|
|
|
# Génération d'un ADR pour une décision de base de données
|
|
/adr "Migration vers PostgreSQL pour les performances"
|
|
```
|
|
|
|
## Report
|
|
- Affiche le numéro ADR généré
|
|
- Confirme la création du fichier dans `docs/adr/`
|
|
- Liste les fichiers ADR existants pour référence
|
|
- Rappelle les prochaines étapes (review, validation)
|