Docs Sync

Documentation Sync Agent

Objectif

Analyser les changements de la branche courante et mettre à jour les fichiers de spécifications dans .claude/specs/ pour qu'ils restent synchronisés avec le code.

Fichiers de specs à maintenir

Workflow

1. Identifier la branche et les changements

# Branche courante
git branch --show-current

# Fichiers modifiés vs develop
git diff develop --name-only

# Diff détaillé
git diff develop --stat

2. Catégoriser les changements

Analyser les fichiers modifiés et les mapper aux specs:

3. Lire les fichiers modifiés

Pour chaque fichier modifié pertinent:

1. Lire le contenu actuel
2. Comprendre les changements (git diff)
3. Identifier les sections de specs à mettre à jour

4. Mettre à jour les specs

Pour chaque spec impactée:

1. Lire le fichier spec actuel
2. Identifier la section à modifier
3. Mettre à jour avec les nouvelles informations
4. Garder le format et le style existants

5. Résumer les changements

Afficher un récapitulatif:

• Fichiers analysés
• Specs mises à jour
• Sections modifiées

Règles de mise à jour

ARCHITECTURE.md

Schéma DB - Si prisma/schema.prisma modifié:

• Ajouter/modifier les modèles dans le diagramme ASCII
• Mettre à jour les relations
• Ajouter les nouveaux enums

Providers IA - Si utils/ai-model.tsx modifié:

• Mettre à jour la table des modèles
• Ajouter les nouveaux providers

Auth - Si auth.ts modifié:

• Mettre à jour la section "Flow d'Authentification"

API.md

Server Actions - Si app/actions/*.ts modifié:

• Ajouter les nouvelles actions dans la table correspondante
• Documenter input/output
• Ajouter les nouveaux codes d'erreur

Routes API - Si app/api/** modifié:

• Documenter la nouvelle route
• Ajouter le schéma de validation
• Lister les codes d'erreur

Schémas - Si utils/schemas.ts modifié:

• Mettre à jour la section "Schémas Zod"

SECURITY.md

Chiffrement - Si utils/encryption.ts modifié:

• Documenter les changements d'algorithme
• Mettre à jour les flux

Auth - Si auth.ts ou config auth modifié:

• Mettre à jour la section authentification
• Documenter les nouveaux providers OAuth

Variables env - Si nouvelles variables sensibles:

• Ajouter à la table des variables

PRD.md

Features - Si nouvelle fonctionnalité majeure:

• Ajouter dans la table des features
• Créer les user stories si pertinent

Roadmap - Si feature de la roadmap implémentée:

• Mettre à jour le statut

Exemple d'exécution

User: "sync docs" ou "vérifie la doc avant merge"

Agent:
1. git diff develop --name-only
   → prisma/schema.prisma (modifié)
   → app/actions/user-projects.ts (nouveau)
   → utils/ai-model.tsx (modifié)

2. Analyse:
   - Nouveau modèle Project dans Prisma
   - Nouvelles actions CRUD pour projets
   - Nouveau provider IA ajouté

3. Mises à jour:
   - ARCHITECTURE.md: ajout modèle Project dans schéma DB
   - ARCHITECTURE.md: nouveau provider dans la table
   - API.md: nouvelles actions user-projects documentées

4. Résumé affiché à l'utilisateur

Format de sortie

## 📝 Documentation Sync Report

### Fichiers analysés
- `prisma/schema.prisma` → changements détectés
- `app/actions/user-projects.ts` → nouveau fichier
- `utils/ai-model.tsx` → changements détectés

### Specs mises à jour

#### ARCHITECTURE.md
- ✅ Ajout du modèle `Project` dans le schéma DB
- ✅ Ajout du provider `NewProvider` dans la table

#### API.md
- ✅ Documentation des actions `user-projects.ts`
  - `getAllUserProjects`
  - `createProject`
  - `updateProject`
  - `deleteProject`

### Aucune mise à jour nécessaire
- PRD.md
- SECURITY.md

Commandes déclencheurs

• "sync docs"
• "met à jour la doc"
• "vérifie la documentation"
• "avant de merge"
• "finalise la branche"
• "prépare la PR"