Retex - Capture Lesson Learned

Arguments: $ARGUMENTS

Capture et persiste une leçon apprise (fausse piste, bug introduit, rollback, décision à revoir) dans memory pour les sessions futures.

---

Step 1 : Gather Git Context

Run in parallel :

• rtk git status
• rtk git log --oneline -5
• git branch --show-current

---

Step 2 : Gather Input

Mode 1 — Direct (si $ARGUMENTS non vide) :

• Utiliser $ARGUMENTS comme description de l'incident
• Inférer la catégorie et le root cause depuis le texte

Mode 2 — Interactive (si pas d'arguments) :

• Utiliser AskUserQuestion avec deux questions :
  1. "Que s'est-il passé ?" — options : Fausse piste, Bug de script/hook, Rollback, Décision doc à revoir, Piège outil/stack, Autre
  2. "Décris en 1-3 phrases : ce qui s'est passé et ce que tu aurais dû faire"

---

Step 3 : Structure the Retex

Synthétiser depuis le contexte git + input user dans ce format :

Champ	Description
Title	3-5 mots, forme substantif (ex: "Quarto render wrong format")
What happened	1-3 phrases factuelles, pas de jugement
Root cause	Cause technique racine — PAS le symptôme
What should have been done	L'approche correcte, actionnable
Prevention rule	Règle impérative courte, commençant par un verbe (ex: "Toujours utiliser --to whitepaper-typst pour les PDFs")
Tags	1-4 tags parmi : documentation, markdown, yaml, versioning, release, landing-sync, whitepaper, template, hook, script, quarto, typst, writing, structure, configuration
Severity	critical (sync cassée/release bloquée), high (feature cassée), medium (perte de temps >1h)
Scope	project (spécifique ce guide) ou general (tout projet doc/Quarto)

---

Step 4 : Compute Memory Name

Format : retex-\{YYYY-MM-DD\}-\{slug\}

• Slug = 2-4 mots kebab-case du root cause
• Si doublon même jour : suffixer -2, -3...
• Exemple : retex-2026-03-03-quarto-wrong-format

---

Step 5 : Write Retex Memory

Via Write tool, créer le fichier .claude/memories/retex-\{slug\}.md avec ce contenu exact :

# Retex: {Title}

**Date**: {YYYY-MM-DD} | **Severity**: {severity} | **Scope**: {scope}
**Tags**: {tag1, tag2, tag3}

## What Happened

{description factuelle}

## Root Cause

{analyse technique du root cause}

## What Should Have Been Done

{approche correcte et actionnable}

## Prevention Rule

> {règle impérative}

## Context

- Branch: `{current-branch}`
- Files: {fichiers clés impliqués si connus}
- Commit: {hash court si applicable}

---

Step 6 : Update Retex Index

1. Lire .claude/memories/retex-index.md (ou créer si inexistant)
2. Ajouter la nouvelle entrée dans le tableau :

# Retex Index

| Date   | Slug   | Title   | Severity   | Tags   | Scope   |
| ------ | ------ | ------- | ---------- | ------ | ------- |
| {date} | {slug} | {title} | {severity} | {tags} | {scope} |

Total: {N} | Last updated: {date}

3. Cap à 50 entrées (supprimer les plus anciennes si dépassement)
4. Écrire l'index mis à jour

---

Step 7 : Confirm

Afficher un résumé compact :

✓ Retex capturé :
  Fichier    : .claude/memories/retex-{slug}.md
  Title      : {title}
  Severity   : {severity}
  Prevention : "{prevention rule}"
  Tags       : [{tags}]

---

Edge Cases

• Premier retex : créer retex-index.md from scratch (header + première entrée)
• Pas de contexte git : omettre la section "Context" sans erreur
• $ARGUMENTS très courts (<10 chars) : basculer en mode interactif