reversa

Reversa est un framework de rétro-ingénierie de spécifications à partir de systèmes hérités, permettant aux agents de codage IA de travailler avec eux en toute sécurité. Installé via `npx reversa install` à la racine d'un projet, il déploie une équipe d'agents IA spécialisés dans l'espace de travail. Le pipeline principal est la phase Discovery (`/reversa`), orchestrée par l'agent Reversa en cinq étapes : Scout cartographie la surface du projet, Archaeologist analyse les modules et les flux de contrôle, Detective extrait les règles métier implicites et les décisions d'architecture, Architect synthétise les diagrammes C4 et les ERD, et Writer produit des contrats opérationnels exécutables avec traçabilité du code. Des agents optionnels comme Visor (documentation UI à partir de captures d'écran), Data Master (analyse de base de données), Design System (extraction de design tokens) et Soul Extractor (spécification de résumé exécutif) sont disponibles. Au-delà de la découverte, Reversa prend en charge plusieurs workflows : - `/reversa-new` — projets greenfield, d'une idée en une ligne à des spécifications complètes - `/reversa-forward` — évolution d'un système des spécifications vers le code, fonctionnalité par fonctionnalité - `/reversa-migrate` — reconstruction d'un système hérité sur une stack moderne - `/reversa-docs` — rendu des connaissances extraites sous forme de mini-site HTML statique - `/reversa-debugger` — suivi des défauts avec traçabilité causale jusqu'aux spécifications - `/reversa-refactor` — amélioration de la qualité du code sans changer le comportement - `/reversa-pricing-*` — estimation de l'effort et du coût à partir des spécifications Les variantes autonomes (`/reversa-autonomous`, `/reversa-new expresso`, `/reversa-forward-autonomous`) exécutent les pipelines de bout en bout après une seule interview initiale. Toutes les écritures sont restreintes à `.reversa/` et aux dossiers de sortie, sans jamais toucher aux fichiers existants du projet. Les points de contrôle sont enregistrés dans `.reversa/state.json` pour reprendre les sessions interrompues. Le framework génère des artefacts structurés, notamment des spécifications SDD, des documents d'exigences, des feuilles de route, des plans d'action et des matrices de traçabilité. La sortie réside dans `_reversa_sdd/` pour les spécifications et `_reversa_bugs/` pour le suivi des défauts, tous deux sous contrôle de version.