devflow

Devflow est un moteur de développement adaptatif pour Codex, Claude Code et Cursor. Il choisit un niveau de rigueur à partir de signaux explicites, produit des contrats d’activité portables et bloque les transitions tant que les preuves attendues ne sont pas présentes.

Profils

• quick : changement local, clair et peu risqué.
• standard : plusieurs composants ou risque modéré.
• deep : changement transversal, ambigu ou contractuel.
• critical : sécurité, données, migration ou risque élevé.

Les routes exactes et leurs preuves sont générées dans docs/pipeline-reference.generated.md.

Installation

uv tool install devflow-cli
devflow init --ai codex

Python 3.11+ et Git sont requis. --ai accepte codex, claude-code ou cursor.

Parcours quotidien

devflow feature KS-123 --short-name user-auth
devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
devflow adaptive start KS-123
devflow adaptive run KS-123 --agent codex
devflow adaptive status KS-123

adaptive status --json fournit un état exploitable par la CI. Les échecs distinguent explicitement blocage métier, contrat invalide, panne agent, validation échouée et conflit concurrent ; chaque refus affiche la commande de reprise recommandée.

Chaque invocation de adaptive run traite une activité. La politique est dans assessment.json; la progression et les preuves sont dans workflow-state.json. Les résultats agent sont validés par schéma et les preuves d’exécution sensibles sont produites localement par Devflow.

En V4, chaque profil exécute preflight-evidence avant implement. Cette activité archive des faits externes reproductibles dans preflight-evidence.md, sans secret ni donnée utilisateur.

Les trois adaptateurs acceptent les mêmes contrats structurés :

devflow adaptive run KS-123 --agent codex
devflow adaptive run KS-123 --agent claude
devflow adaptive run KS-123 --agent cursor

Migrer une ancienne feature

Pour un workflow adaptatif V3 déjà persisté :

devflow adaptive migrate KS-123 --dry-run
devflow adaptive migrate KS-123

La migration V4 traite ensemble assessment.json et workflow-state.json, conserve une sauvegarde auditée et restaure le couple original en cas d'échec. Voir le guide V4.

Pour une feature antérieure au moteur adaptatif :

devflow migrate KS-123 --dry-run
devflow migrate KS-123 --profile deep

La migration conserve les artefacts, archive state.json sous legacy-state.json, puis redémarre à la première activité vérifiable du profil. Sans identifiant, devflow migrate traite toutes les anciennes features. devflow init et devflow upgrade déplacent également les anciennes commandes Claude connues vers ~/.claude/.devflow-legacy-backup/ sans toucher aux commandes personnalisées.

Documentation

• Workflow adaptatif
• Référence CLI
• Contrats d’activité
• Façade Claude Code
• Guide Cursor

Développement

uv sync --extra dev
uv run pytest -q
./tests/run-tests.sh
uv run devflow docs-sync --check