rhetorical-analysis

# Skill d'analyse rhétorique et épistémologique

Ce skill permet d'analyser systématiquement la qualité argumentative d'un texte en combinant plusieurs frameworks établis.

## Frameworks d'analyse intégrés

### 1. Modèle de Toulmin (structure argumentative)
Pour chaque argument identifié, extraire :
- **Claim** : La thèse défendue
- **Grounds** : Les preuves/données avancées
- **Warrant** : Le lien logique implicite entre preuves et thèse
- **Backing** : Les éléments qui soutiennent ce lien logique
- **Qualifier** : Les nuances ou restrictions de la thèse
- **Rebuttal** : Les contre-arguments reconnus ou ignorés

### 2. Test CRAAP (fiabilité des sources)
Pour chaque source citée, évaluer :
- **Currency** : Actualité de l'information
- **Relevance** : Pertinence pour le propos
- **Authority** : Crédibilité de l'auteur/source
- **Accuracy** : Vérifiabilité et exactitude
- **Purpose** : Intention (informer, persuader, vendre...)

### 3. Catalogue des sophismes
Voir `references/fallacies-catalog.md` pour la liste complète des sophismes à détecter.

### 4. Échelle de fiabilité (1-5)
- **5** : Fait établi, consensus scientifique, sources multiples vérifiables
- **4** : Sources sérieuses, raisonnement logique valide, nuances possibles
- **3** : Mélange faits/interprétations, sources partielles
- **2** : Raisonnement contestable, sophismes identifiés
- **1** : Affirmations non sourcées, erreurs logiques majeures

## Workflow d'analyse

1. **Segmentation** : Identifier les arguments distincts du texte
2. **Décomposition Toulmin** : Analyser chaque argument selon le modèle
3. **Évaluation des sources** : Appliquer le test CRAAP aux références
4. **Détection des sophismes** : Scanner pour les erreurs de raisonnement
5. **Synthèse** : Produire le tableau d'analyse et la synthèse critique

## Format de sortie

### Option 1 : Génération automatique via script

1. Produire l'analyse au format JSON (voir `assets/example_analysis.json` pour le schéma)
2. Exécuter le script de génération :

   ```bash
   python scripts/generate_analysis.py analysis.json output.[xlsx|json|md] --format [xlsx|json|md]
   ```

**Exemples :**
```bash
python scripts/generate_analysis.py analysis.json rapport_analyse.xlsx --format xlsx
python scripts/generate_analysis.py analysis.json analysis_output.json --format json
python scripts/generate_analysis.py analysis.json rapport.md --format md
```

Le script génère un fichier de sortie selon le format choisi. Pour le format XLSX, il contient 5 feuilles :
- **Analyse rhétorique** : Tableau principal
- **Détail Toulmin** : Structure complète de chaque argument
- **Évaluation sources (CRAAP)** : Scores des sources citées
- **Synthèse** : Points forts, faibles, patterns
- **Légende** : Échelles et définitions

### Option 2 : Génération manuelle

Utiliser le skill `xlsx` pour créer un fichier avec les colonnes :
- N° de l'argument
- Argument traité (résumé)
- Texte original (extrait clé)
- Affirmation / Thèse (Claim)
- Type de raisonnement (Warrant + évaluation)
- Fiabilité (1-5)
- Évaluation détaillée de la fiabilité
- Commentaire critique

## Précautions

- **Distinguer la conclusion de l'argument** : Un argument peut être faible mais mener à une conclusion juste
- **Éviter le biais de confirmation** : Analyser avec la même rigueur les textes qu'on approuve ou désapprouve
- **Reconnaître les limites** : Certaines affirmations sont impossibles à évaluer sans expertise domaine
- **Contexte militant assumé** : Si le texte est explicitement militant, le noter sans que cela invalide l'analyse