auto-improve

Que fait auto-improve ?

Amélioration autonome et supervisée par juge pour tout artefact textuel. Consultez README.md pour le guide complet ; ceci est la référence rapide destinée à l'agent.

Quand l'utiliser

L'utilisateur souhaite quelque chose de mesurablement meilleur, pas simplement réécrit — et est prêt à exprimer "meilleur" sous forme de rubrique. Exemples adaptés : emails à froid, contenu de page d'accueil, prompts, définitions de compétences, articles de blog, lettres de motivation, documents, contrats, menus.

Exécution

export GEMINI_API_KEY=...        # https://aistudio.google.com/apikey
python3 improve.py \
  --artifact path/to/file.md \   # doit se trouver dans un dépôt git
  --tag v1 \                     # → branche improve/v1, résultats/v1.tsv
  --max-iterations 8 \
  --criteria path/to/rubric.md   # OPTIONNEL — omettre pour inférer automatiquement une rubrique ; ou ajouter
                                 # --goal "ce à quoi ressemble un bon résultat" pour orienter l'inférence

Si vous ne passez pas --criteria, auto-improve rédige d'abord une rubrique à partir de l'artefact et l'enregistre dans results/<tag>.rubric.md — lisez-la pour voir ce qui est optimisé. Consultez une exécution terminée : python3 improve.py --status --tag v1. Le résultat se trouve sur la branche git improve/<tag> — git diff main improve/v1 -- <file>.

Comment il décide (la partie anti-banalité)

1. Muter — meilleur parmi N modifications candidates, appliquées sous forme de diffs chirurgicales (à l'épreuve des crashs).
2. Noter — chaque candidat évalué par rapport à la rubrique via un appel modèle séparé.
3. Décider — le meilleur candidat est jugé par paire contre le champion (les deux ordres, débiaisé) ; conservé seulement s'il gagne réellement, sinon annulé.

Le mutateur ne note jamais son propre travail, et les réécritures confiantes mais pires sont rejetées — la progression est donc réelle et chaque commit constitue un gain vérifié.

Rédaction de la rubrique

Un fichier markdown de dimensions pondérées totalisant 100 — ancrées (50/70/90), formulées en récompense, spécifiques. Consultez criteria/README.md et les exemples commentés dans criteria/.

Règles clés

• Le mutateur et l'évaluateur ne partagent jamais de contexte.
• Un artefact, une rubrique, un seul --tag par exécution.
• La branche git est la source de vérité ; results/<tag>.tsv est le journal de progression (non suivi).
• Ne jamais éditer en dehors de l'artefact ; diffs chirurgicaux de petite taille, pas de réécritures massives.