post-mortem: v0.2.15

[pascalandy]

Résumé exécutif

Release v0.2.15 déployée avec succès. PR créée, CI passé, merge squash effectué, tag et release créés.

Contexte

• Plan: Fix local image caching for faster builds #57
• PR: ⚡️ perf(cache): add local filesystem cache for OG images and fonts #58
• Tag: pascalandy-blog-paper-v0.2.15
• Release: https://github.com/pascalandy/pascalandy-blog-paper/releases/tag/pascalandy-blog-paper-v0.2.15

Timeline

Phase	Action	Durée	Notes
Phase 1	QA	~3s	Tout passé du premier coup
Phase 2	Push + PR	~8s	Lefthook hooks exécutés
Phase 3	CI wait	~2m5s	Attente 125s + vérification
Phase 4	Merge	~5s	Squash merge réussi
Phase 5	Tag + Release	~10s	Création sans problème
Total		~3 minutes

Incidents / frictions

• Erreur lors du merge: fatal: 'main' is already used by worktree. Le merge a réussi sur GitHub mais la suppression locale de branche a échoué à cause d'un worktree existant.
• Résolution: Vérifié que le merge avait réussi sur GitHub, puis continué avec origin/main pour le tag.

Root cause

Un worktree existe sur /Users/andy16/Documents/github_local/pascalandy-blog-paper qui utilise la branche main, empêchant git de la checkout localement.

Mesures & métriques

• CI runs: 1
• Retries: 0
• Temps total: ~3 minutes
• Taille PR: 6 commits, squashés en 1

Bilan

Aspect	Ce qui a bien fonctionné	À améliorer
Instructions	Workflow clair et complet	Ajouter gestion des worktrees
Inputs utilisateur	Branche et commits existants, rien à fournir	-
Autonomie agent	Exécution complète sans intervention	-
Outils/CI	CI rapide (~1m30s), hooks locaux fonctionnels	Greptile trial expiré

Action items

Action	Owner	Priorité	Date cible	Statut
Documenter la gestion des worktrees dans le workflow	Agent	Low	-	Suggestion
Renouveler Greptile ou alternative	User	Medium	-	À décider

Leçons apprises

• Les worktrees peuvent créer des frictions lors du checkout de main - travailler avec origin/main directement fonctionne bien pour les tags
• Le workflow est robuste: même avec une erreur partielle (suppression branche), la release est complète
• Toujours lier la PR à l'issue de plan originale avec "Closes #XX" dans le body

Clôture

Release v0.2.15 complétée avec succès.