Skip to content

gemini.md

Latest commit

 

History

History
208 lines (152 loc) · 7.36 KB

gemini.md

File metadata and controls

208 lines (152 loc) · 7.36 KB
Raw

Structure d'analyse d'article pour la veille

Organisation des fichiers:

Les fiches de veille sont organisées dans des répertoires par mois de publication (et non par date de lecture) :

veille/
├── index.md                    # Index général avec liens vers toutes les fiches
├── fiches/
│   ├── 2025-08/               # Articles publiés en août 2025
│   ├── 2025-09/               # Articles publiés en septembre 2025
│   └── 2025-10/               # Articles publiés en octobre 2025
└── docs/                      # (ignoré par git)

Chaque fiche est un fichier markdown individuel nommé selon son identifiant technique.

Format standardisé d'une fiche

Chaque fiche suit ce format :

# [Identifiant Technique]
## Veille
## Titre Article
## Date
## URL
## Keywords
## Authors
## Ton
## Pense-betes
## RésuméDe400mots

Description des sections

  • Identifiant Technique : Identifiant unique pour l'article (utilisé comme nom de fichier)
  • Veille : Compression synthétique du titre de l'article, des keywords et du domaine du site
  • Titre Article : Titre original de l'article
  • Date : Date de publication au format ISO (YYYY-MM-DD) - détermine le répertoire de stockage
  • URL : Lien vers l'article source
  • Keywords : Mots-clés associés à l'article
  • Authors : Auteur(s) de l'article
  • Ton : Analyse du ton et du style de l'article, incluant le profil (perspective narrative, registre, niveau technique) et une description détaillée du style d'écriture, des métaphores utilisées, de l'autorité de l'auteur et du public cible (en français)
  • Pense-betes : Notes et remarques importantes (format liste à puces)
  • RésuméDe400mots : Résumé de l'article en 400 mots maximum (en français)

Workflow d'ajout d'un nouvel article

  1. Extraire les informations de l'article source
  2. Créer un identifiant technique descriptif (ex: nom-auteur-sujet-YYYY-MM-DD)
  3. Créer le fichier dans le répertoire correspondant au mois de publication : fiches/YYYY-MM/identifiant.md
  4. Remplir toutes les sections selon le format standardisé
  5. Sauvegarder le contenu brut dans raw-data/ (voir section suivante)
  6. Mettre à jour index.md (voir section plus bas)

Gestion des données brutes (raw-data)

IMPORTANT : Pour chaque article ajouté, le contenu brut de l'URL source doit être sauvegardé dans le répertoire raw-data/.

Objectif

Conserver le texte original des articles au format markdown pour :

  • Permettre des analyses futures du contenu source
  • Faciliter la vérification et mise à jour des fiches
  • Archiver le contenu en cas de disparition de l'article source

Workflow de sauvegarde

1. Vérifier la configuration

Avant toute opération :

  • Vérifier que raw-data/ existe (créer si nécessaire : mkdir raw-data)
  • Vérifier que raw-data/ est dans .gitignore
  • S'assurer que les scripts sont dans scripts/

2. Sauvegarder le contenu brut

Option 1 : Automatique (tous les articles)

python3 scripts/fetch_urls.py        # Extrait les URLs
python3 scripts/download_raw_data.py # Télécharge et convertit

Option 2 : Manuel (article spécifique)

curl -sL "URL" | lynx -dump -stdin -nolist > raw-data/identifiant.md

3. Nommage

Utiliser le même identifiant que la fiche : {identifiant}.md

Notes

  • Le répertoire raw-data/ est ignoré par git
  • Format : markdown converti depuis HTML
  • Inclure identifiant et URL en en-tête

Mise à jour de index.md

Le fichier index.md est l'index principal qui référence toutes les fiches. Il doit être mis à jour à chaque ajout d'article.

Structure de index.md

# Veille Technologique

## Articles par date de publication
### [Mois] [Année]
- **[YYYY-MM-DD]** [Titre](fiches/YYYY-MM/identifiant.md) - Description courte - Source

## Thématiques
### [Nom de la thématique]
- [Titre](fiches/YYYY-MM/identifiant.md) - Auteur

## Statistiques
- **Total d'articles** : XX
- **Période couverte** : [Période]
- **Principaux auteurs** : [Liste]
- **Sources principales** : [Liste]

Étapes de mise à jour

1. Ajouter dans la section "Articles par date de publication"

Position : Insérer l'article dans l'ordre chronologique décroissant (plus récent en premier) dans le mois approprié.

Format :

- **[YYYY-MM-DD]** [Titre court et descriptif](fiches/YYYY-MM/identifiant.md) - Description en quelques mots - Source

Exemple :

### Octobre 2025
- **[2025-10-15]** [Nouvelle architecture agents IA](fiches/2025-10/nouvelle-architecture-agents-2025-10-15.md) - Design patterns émergents - TechBlog
- **[2025-10-11]** [Intelligence Artificielle et monopsychisme](fiches/2025-10/ia-monopsychisme-serres-averroes-aquin-2025-10-11.md) - Philosophie médiévale/moderne - Revue Thomiste

Note : Si le mois n'existe pas encore, créer une nouvelle section avec le titre ### [Mois] [Année].

2. Ajouter dans la section "Thématiques"

Identifier la thématique : Choisir la catégorie la plus appropriée parmi :

  • Agents de codage IA & Skills
  • Architecture & Construction
  • Transformation & Adoption
  • Qualité & Sécurité
  • Économie & Marché
  • Philosophie & Société
  • (Créer une nouvelle thématique si nécessaire)

Format :

- [Titre court](fiches/YYYY-MM/identifiant.md) - Auteur ou source

Position : Ajouter à la fin de la liste de la thématique appropriée.

Exemple :

### Agents de codage IA & Skills
- [Méthodologie agents de codage IA](fiches/2025-10/coding-agents-methodology-vincent-2025-10-05.md) - Jesse Vincent
- [Nouvelle architecture agents IA](fiches/2025-10/nouvelle-architecture-agents-2025-10-15.md) - Jane Doe

3. Mettre à jour les statistiques

Incrémenter le total : Ajouter +1 au nombre total d'articles

Mettre à jour la période : Ajuster si nécessaire (ex: "Août - Octobre 2025" → "Août - Novembre 2025")

Actualiser les auteurs : Ajouter l'auteur s'il apparaît pour la première fois ou incrémenter son compteur

Actualiser les sources : Ajouter la source si elle est nouvelle

Exemple :

## Statistiques

- **Total d'articles** : 16  ← était 15
- **Période couverte** : Août - Octobre 2025
- **Principaux auteurs** : Jesse Vincent (2), Jane Doe (1), Simon Willison (1), Martin Fowler (1)
- **Sources principales** : LinkedIn, Blogs techniques, Recherche Anthropic, Google Cloud, TechBlog

Checklist de mise à jour

  • Article ajouté dans "Articles par date de publication" (ordre chronologique décroissant)
  • Article ajouté dans la thématique appropriée
  • Total d'articles incrémenté
  • Période couverte actualisée si nécessaire
  • Auteur ajouté ou compteur incrémenté
  • Source ajoutée si nouvelle
  • Liens vérifiés (format fiches/YYYY-MM/identifiant.md)
  • Orthographe et formatage vérifiés

Conventions de nommage dans index.md

Titres : Courts et descriptifs (max 60 caractères), éviter les sous-titres

Descriptions : 3-5 mots clés séparés par tirets, décrivant le contenu principal

Sources : Nom court reconnaissable (ex: "LinkedIn", "Pragmatic Engineer", "Revue Thomiste")

Thématiques : Utiliser les catégories existantes en priorité, ne créer une nouvelle catégorie que si vraiment nécessaire