Un pipeline de prompts démontre des propriétés de méta-programmation.

Un développeur a documenté un pipeline de prompts utilisé pour construire une application Electron (Claude Code CLI, React, TypeScript, SQLite) qui démontre les propriétés structurelles d'un langage de méta-programmation, incluant des entrées/sorties typées, un flux de contrôle, des boucles, des machines à états et des interfaces de modules.

Architecture du Pipeline

Le système fonctionne en quatre étapes distinctes avec des contrats typés entre elles.

Étape 1 : Analyse Statique

Le prompt repo-eval.md effectue un scan complet de la base de code. Il lit chaque fichier source, trace les graphes de dépendance, cartographie les flux IPC de bout en bout, et émet un rapport de résultats structuré vers issues.md. Chaque résultat inclut :

• ID de section
• Titre
• Sévérité (Critique/Élevée/Moyenne/Faible)
• Catégorie
• Chemins de fichiers avec plages de lignes
• Preuve
• Évaluation de l'impact
• Correction recommandée

Étape 2 : Compilation

Le prompt address-issues.md analyse la sortie de l'Étape 1. Il regroupe les résultats par affinité de fichier, attribue des numéros de prompt (FIX-01, FIX-02, ...), détermine les dépendances inter-prompt, et trie par sévérité. La sortie est un répertoire (prompts/arch/r{NNN}/) contenant :

• FIX-NN.md — Des prompts de correction autonomes spécifiant l'objectif, les résultats traités, les fichiers à modifier, les étapes de mise en œuvre et les critères de vérification.
• STATE.md — Un suivi de l'état d'exécution avec le statut par prompt (en attente/en cours/terminé/bloqué), le graphe de dépendance, les dates de fin et les notes de transfert.
• MASTER.md — La spécification de la boucle d'exécution.

Étape 3 : Exécution

MASTER.md sert de boucle d'exécution. À chaque itération :

1. Lire STATE.md
2. Sélectionner le prochain prompt en attente dont les dépendances sont satisfaites
3. Lire le prompt
4. Lire tous les fichiers sources affectés
5. Exécuter les étapes de mise en œuvre
6. Lancer la vérification (tsc --noEmit, grep pour les motifs supprimés, vérifications du nombre de lignes)
7. Mettre à jour STATE.md
8. Ajouter une entrée au journal des modifications, mettre à jour la documentation d'architecture
9. Boucler vers l'étape 1

Étape 4 : Empaquetage

Le prompt release-notes.md lit le journal des modifications, exécute git log et git diff --stat par rapport au dernier tag, catégorise les changements, et émet des notes de version formatées avec une recommandation d'incrémentation de version.

Propriétés Clés

Contrats Typés : Le schéma de sortie de repo-eval est le contrat d'entrée pour address-issues. Le schéma de sortie de address-issues est le contrat d'entrée pour MASTER. Les prompts FIX consomment le format exact produit par address-issues. STATE.md a un schéma défini que MASTER lit et écrit.

Documentation Automatique : Un prompt système (agents.md) attaché à chaque fenêtre de contexte Claude Code inclut un protocole post-exécution : ajouter une entrée au journal des modifications, mettre à jour la documentation d'architecture affectée, mettre à jour le suivi d'état. La documentation est émise comme effet secondaire de l'exécution du prompt, éliminant la dégradation du contexte.

Prompts comme ADR : Chaque FIX-NN.md fonctionne comme un document de conception, un ordre de travail et un enregistrement de décision architecturale, capturant le problème, la justification, le plan de mise en œuvre et les critères de vérification avant l'exécution.

Résultats

Une journée d'exécution de ce pipeline a produit :

• 2 évaluations complètes du dépôt
• 17 corrections de bugs sur 2 tours de révision (conditions de concurrence, architecture de flux, gestion d'état concurrente)
• Décomposition de service : 1 218 lignes → 403 lignes + 5 services extraits
• 3 corrections de plantage supplémentaires
• Réécriture du README vérifiée par rapport au code source
• Site web GitHub Pages de 6 pages
• 21 entrées dans le journal des modifications